Prompt
How do I tell if answer engines are using my docs or skipping them?
Latest observation
To tell whether an answer engine is actually using your docs, look for evidence traces in the response and test with controlled questions.
1) Ask questions only your docs can answer
Use queries that require a specific fact, phrase, policy, or number from your docs.
Examples:
- “What is the retention period for invoices in Policy X?”
- “What’s the exact error code mapping for feature Y?”
- “Which region supports SSO in the onboarding guide?”
If the engine answers correctly and includes the exact detail, that’s a good sign. If it gives a generic answer, it may be skipping retrieval.
2) Check for citations or source links
If the system supports it, see whether the answer:
- cites document titles
- includes page/section references
- links to source passages
- quotes text from your docs
No citations doesn’t always mean it skipped the docs, but citations are the clearest signal.
3) Compare answer specificity
Doc-grounded answers are usually:
- more specific
- aligned with your internal wording
- consistent with terminology used in your docs
Skipping behavior often looks like:
- generic “best practice” advice
- vague hedging
- answers that sound plausible but don’t match your policy language
4) Use “needle-in-a-haystack” tests
Put a unique phrase in a doc, then ask about it.
Example:
- Add a fake but distinctive term like “Blue Sparrow mode.”
- Ask: “What does Blue Sparrow mode mean?”
If the engine can’t retrieve or cite that phrase, it may not be using your docs effectively.
5) Ask for direct quotes
Prompt:
- “Answer using only the provided docs. Quote the exact line that supports your answer.”
If it can’t quote or produces unsupported text, retrieval may be failing.
6) Inspect the retrieval layer if available
If you control the stack, check:
- whether any documents were retrieved
- retrieval scores
- top-k results
- chunk contents
- reranker output
If retrieved chunks are irrelevant or empty, the issue is in indexing/search, not the model.
7) Run A/B tests
Compare:
- with docs enabled
- with docs disabled
If answers are nearly identical, the engine may be relying mostly on its base model. If the doc-enabled version changes with your content, that suggests docs are being used.
8) Watch for failure modes
Common signs it’s skipping docs:
- answer lacks your company-specific terms
- it invents details not in your docs
- it ignores explicit “use the docs only” instructions
- it answers from general knowledge instead of your policy
9) Use a benchmark set
Create 20–50 questions with known answers from your docs and score:
- exact match
- citation presence
- faithfulness to source
- hallucination rate
This gives a repeatable way to detect whether docs are being used.
10) If you have logs, look for these fields
Useful telemetry:
- query text
- retrieved passages
- source doc IDs
- similarity scores
- rerank scores
- final prompt sent to the model
- answer with citations
If you want, I can also give you:
- a simple test script/checklist,
- a prompt template to force doc-only answers, or
- a diagnostic rubric for judging whether an engine is grounded in your docs.