Multiple users complain that your AI assistant 'ignores the documents I uploaded and just makes things up'. Before involving an ML engineer, which pipeline layer should you investigate first?
Check the augmentation prompt first. 'Ignores my docs and makes things up' usually means the chunks were retrieved fine but the prompt never told the model to ground in them.
Imagine you hand a student a folder of notes and say 'answer the exam'. If you never tell them 'only use these notes', they'll mix the notes with whatever they already remember, and when the notes feel thin they just guess confidently. That's exactly what an LLM does in a RAG system. The retrieval step often works fine, the right pages got pulled and placed in front of the model. But the instruction wrapping those pages, the augmentation prompt, never said 'answer only from this context, tell me which page you used, and refuse if it isn't enough'. So the model treats the pages as optional hints and falls back on its training. When users say 'it ignored my upload', the cheapest first check is that instruction, not the search engine and not the model.
Detailed answer & concept explanation~7 min readEverything you need to truly understand this topic: intuition, mechanics, step by step explanation, code, formulas, and worked example. Click to expand.
Everything you need to truly understand this topic: intuition, mechanics, step by step explanation, code, formulas, and worked example. Click to expand.
Everything you need to truly understand this topic: intuition, mechanics, step by step explanation, code, formulas, and worked example.
Everything important, quickly.
3 min: split retrieval-missing from LLM-ignoring, name the prompt-payload inspection step, list the three grounding directives, then justify the prompt-first triage ordering.
| Signal | Retrieval-missing | LLM-ignoring (this case) |
|---|---|---|
| What broke | Relevant chunks never reach the prompt | Chunks reach the prompt but aren't used |
| Prompt-payload check | Correct chunk absent from payload | Correct chunk present in payload |
| Owning layer | Embeddings, chunking, vector index | Augmentation prompt grounding directives |
| User-visible feel | 'It couldn't find anything' | Confident answer that ignores the upload |
| First fix | Tune retrieval / reindex / hybrid search | Add answer only / cite / refuse directives |
Real products, models, and research that use this idea.
- A Claude- or GPT-backed support assistant that hallucinates despite correct retrieval, fixed by adding 'answer only from the provided context and cite the source chunk' to the system prompt.
- Notion AI or Glean answering from general knowledge instead of workspace docs because the grounding instruction was too weak.
- A LangChain or LlamaIndex RAG app where the default prompt template lacked a refusal clause, so the model filled gaps from training memory.
What an interviewer would ask next. Try answering before peeking at the approach.
QYou logged the prompt payload and the correct chunk IS present, but the model still fabricates even after you added grounding directives. What now?
QHow would you build an automated test that catches grounding regressions before they reach users?
Don't say thisRed flags and common mistakes that signal junior thinking. Click to expand.
Red flags and common mistakes that signal junior thinking. Click to expand.
Jumping straight to the embedding model or vector DB. Those change retrieval recall. This symptom is a grounding failure: the chunks were found, the prompt just never forced the model to use them.
The night-before-the-interview bullets. Scan these on the way to the call.
Primary sources. Skim if you want the original framing.
Same topic, related formats. Practice these next.