| Search fails outright | No embedding provider key configured in the workspace (embedding provider key not configured) | Register a key under Providers |
| Not in the results at all | The chunk isn’t in the index because the pipeline filtered it out or the chunker dropped it | Check the Foundry run log for the source |
| Low vector score | Query wording and document wording are far apart | Add aliases or synonyms in the doc, or turn on HyDE |
| Low keyword score | No words in common between query and doc | Add searchable terms to the doc, or raise the vector weight |
| Ranked but below top k | The weight balance doesn’t fit the data | Adjust vector/keyword weights and fusion |
| Filtered by min similarity | The cutoff is too high | Drop min similarity to 0 and check whether it shows up |
| Disappears when rerank is on | The reranker judged another chunk more relevant | Turn the provider off and compare. The reranker may be right, so inspect what it promoted |
| Ranks change with causal reasoning on | KG boost or graph-aware is influencing the rank | Check the KG binding on the test scope |
