
Build and Debug a Small RAG Pipeline
A clean pipeline that answers confidently and wrongly is not a mystery. It is a trace you have not read yet.
Read tutorialSystems that retrieve external evidence and provide it to an LLM to support generated answers, including their pipeline, data lifecycle, and failure modes.
Tagged articles
30 articles in this tag.

A clean pipeline that answers confidently and wrongly is not a mystery. It is a trace you have not read yet.
Read tutorial
The reranker "feels" better. The top result looks more relevant than it did before. And yet you cannot say whether the stage earned its latency, because…
Read tutorial
Your RAG system just produced a confident, polished, and completely wrong answer. The natural instinct is to blame the model—swap the prompt, change the…
Read tutorial
Two retrievers return two different top-5 lists for the same query. You merge them, and the merged order looks like it was decided by a coin flip. It…
Read tutorial
Frameworks change. The model underneath them doesn't. Learn the mechanism first, and every new tool becomes just another wrapper around something you…
Read tutorial
A portfolio is not a trophy shelf. It is evidence of judgment — proof that you can pick a real problem, make the right tradeoffs, and ship something that…
Read tutorial
A citation is a pointer, not a proof. This drill teaches you to stop trusting the pointer and start reading the span.
Read tutorial
Retrieval worked. Three chunks came back, all relevant, all cited. Two of them disagree. Now what?
Read tutorial
A citation chip proves a chunk was retrieved. It does not prove the chunk was ever authorized or trustworthy.
Read tutorial
A query returns a sentence the source no longer contains. The team blames the model. The model is innocent — the index is still holding a chunk that was…
Read tutorial
You can explain RAG. You can sketch an agent loop. But when a real question lands on your desk, do you know whether to retrieve, route, or just answer?…
Read tutorial
Your retriever finally returns the right documents. The chunks look relevant. The context window is full of plausible evidence. And the model still hands…
Read tutorial
You ask your RAG system a question. It retrieves a passage that is technically relevant and completely useless—a sentence fragment that starts mid-thought,…
Read tutorial
A 1,500-token document with 512-token chunks and 15% overlap quietly becomes four chunks, and the same paragraph now lives in two of them. Nobody chose…
Read tutorial
A citation marker is a promise. The sentence says this passage backs me up. Most RAG evaluations never check whether the promise holds — they check whether…
Read tutorial
A citation is not proof. It is a pointer — and a pointer is only as trustworthy as the instruction that produced it and the check that verifies it.
Read tutorial
A support chatbot answers a customer's question with total confidence. The answer cites a document from the company knowledge base. The only problem: the…
Read tutorial
You know RAG retrieves documents and feeds them to a language model. But if someone asked you what actually happens between a source PDF and a grounded…
Read tutorial
Your knowledge base has the answer. You know it does. You wrote the documents, chunked them carefully, embedded them, and verified the chunks look right.…
Read tutorial
Your retriever returns ten chunks. They all look topically related to your question. None of them actually answer it. The LLM dutifully composes a response…
Read tutorial
Two retrievers return the same relevant chunk. One puts it at rank 1; the other buries it at rank 4. A single "accuracy" number calls them identical. The…
Read tutorial
Reading about RAG is easy. Building one is where the real learning happens—because the first pipeline you run will almost certainly fail in ways no diagram…
Read tutorial
Most people assume RAG is a different kind of model—a smarter cousin of the plain LLM. It's not. RAG doesn't change the model at all. It changes what goes…
Read tutorial
You swap in a stronger reranker. The top three results look sharper, the ordering feels smarter, and the demo lands. Then you measure recall and it barely…
Read tutorial
Retrieval misses rarely announce their cause. The answer was in the document, the query was reasonable, and the model still returned something useless. The…
Read tutorial
You add a rewrite step. The demo answers the question. You feel clever. Then someone asks a slightly different question and the whole thing falls apart,…
Read tutorial
A filter can be correct and still delete your best evidence. Here is how to watch it happen in twenty lines of NumPy.
Read tutorial
A vector database is not a fancy search box or a generic "database for AI." It is the retrieval engine that decides which evidence earns a seat on the…
Read tutorial
You search your company's help docs for "how do I reset my password?" and get nothing useful. You know the answer is in there—you've read the page…
Read tutorial
Most people assume an LLM knows everything. Ask it about your company's return policy, and it will confidently answer—even if that policy changed last week…
Read tutorial