RetrievalGate

Illustrative walkthrough · not a customer testimonial

The average improved. The important queries got worse.

Consider a support assistant that answers natural-language questions and looks up exact part numbers. This fictional example explains how to use a RetrievalGate report; its numbers are illustrative, not measured customer results.

01

The starting point: mixed query intent

The team has manuals, product tables and support procedures in one corpus. Most evaluation questions are conversational, so the average score is dominated by semantic retrieval. The smaller identifier segment contains the part numbers that support engineers rely on. Both groups need to be represented explicitly in the evaluation CSV.

02

The attractive candidate

Imagine a candidate that improves overall Recall@5 from 72% to 80%. On the surface, the eight-percentage-point increase looks ready to ship. But the identifier segment drops from 90% to 70%. A user searching a specific part now has a worse chance of finding the correct document, despite the improved average.

03

The finding that changes the decision

The segment comparison exposes the loss and the query regression list shows the actual affected questions. The report associates the failure with a likely lexical gap. That is a tested hypothesis to investigate, not proof that every identifier needs the same routing rule.

04

The next controlled experiment

The team tests hybrid search on the same chunks and embedding model, isolating the retrieval-mode change. If the identifiers recover without hurting other important segments, the candidate becomes more credible. If they do not, the team inspects extraction, chunk boundaries, exact source references and duplicate documents before adding more complexity.

05

What counts as a successful outcome

A useful audit can recommend a better configuration or prevent a harmful migration. The production change only goes ahead after the team reviews the implementation card, checks fresh queries and measures latency in its own application. A NO-GO that avoids a regression is a useful result too.

Fictional values · an interpretation example

Overall Recall@572% → 80%

+8 percentage points

Identifier segment90% → 70%

−20 percentage points

DecisionReview first

The average does not settle the release.

Before you run

Questions about this workflow

Are these customer results?

No. This is an explicitly fictional example illustrating how to interpret retrieval metrics and segment regressions. Your own report contains the measurements from your selected corpus.

Can I compare my baseline and a candidate the same way?

Yes. Add your corpus, a labeled query set with segments, and a supported baseline configuration. Full audits expose both the global metrics and the segment/query regressions.

Keep exploring

Make the retrieval decision

Stop guessing. Test the fixes before you ship.

Start with a free snapshot on your own corpus. No SDK, production access or vector database credentials required.