Query flow
RAG_TOP_K defaults to 5 in the agent configuration. FAQ prechecks request only the top result and apply a 0.85 threshold. Normal knowledge retrieval can use multiple chunks to assemble context.
Relevance levers
Diagnose poor results
No results
No results
Confirm the source is
indexed, vectors exist for the document, the query uses the same embedding dimension, and organization identifiers match in both record and payload.Wrong source wins
Wrong source wins
Inspect duplicate content, headings lost during extraction, overly broad chunks, stale vectors, and missing catalog/type filters.
Relevant result but poor answer
Relevant result but poor answer
Separate retrieval quality from generation quality. Inspect returned payload text first, then the system prompt, tool output formatting, and selected chat model.
