BXUP Track progress & test yourself — free
Cloud & Solutions Architecture · Playbook · Core · ~4 min read
CLOUD & SOLUTIONS ARCHITECTURE · PLAYBOOK · CORE

Retrieval Design Decisions, Validated by Evals Not Intuition

Chunking strategy, hybrid search, reranking budget — retrieval design is a stack of small decisions that everyone argues about and almost nobody measures. This playbook makes each decision at the architecture level, then commits every one of them to a retrieval eval before it enters the design.

Tier: Core · Hands-on time: ~35 minutes

Phase-1 posting research names chunking, embeddings, hybrid search, and reranking explicitly as required skills, and this track owns the decision layer: which strategy fits which document types, what latency and cost a reranker is allowed to spend, and how the choice gets validated. The validation rule is absolute — retrieval decisions are settled by Ragas-class metrics on a golden set, not by whoever describes their intuition most confidently, and not by an AI's plausible-sounding defaults.

When to use

  • A new RAG design needs its retrieval section written and the team is about to copy defaults from a tutorial.
  • Answer quality is disappointing and everyone has a different theory (chunks too big, embeddings wrong, need a reranker).
  • A reranker or hybrid-search proposal needs a cost/latency justification before it earns a place in the architecture.
  • Skip AI when you have production eval data pointing at a specific failure — go fix that; you don't need a design workshop for a measured problem.

Prerequisites

  • A representative document sample20–50 documents covering your real formats (tables, policies, code, FAQs).
  • A small golden set15–30 real questions with known-correct source passages.
  • LlamaIndex or LangChain for quick retrieval variants, and Ragas (or equivalent) for scoring.
  • A chat assistant to enumerate options and draft the decision doc.

The workflow

  1. Classify your corpus before choosing anything. Chunking that works for FAQs mangles contracts. List document types, their structure (headings, tables, clause numbering), and typical question shapes against each. This classification, not a global default, drives the chunking decision.

  2. Enumerate candidate strategies per document type with AI — as hypotheses. Anita's orbit-docs-copilot corpus mixes API references, how-to guides, and release notes:

    For a docs copilot over three content types — API reference pages
    (structured, table-heavy), how-to guides (narrative with code blocks),
    and release notes (short, dated) — propose 2 chunking strategies per
    type with the failure mode each strategy risks for that type.
    
    Then propose: (a) when hybrid (BM25 + vector) search would beat pure
    vector for this corpus, with the query shapes that decide it, and
    (b) what evidence would justify adding a reranker, given each reranked
    query adds latency and per-query cost.
    
    Frame everything as testable hypotheses with the metric that would
    confirm or kill each one. Do not present any option as best practice.
    
  3. Design the experiment matrix, small. Two chunking variants, pure-vector vs hybrid, reranker on/off — run only the cells that could change the design. Each cell gets scored on the same golden set with the same metrics (context precision, context recall, faithfulness of downstream answers).

  4. Run the evals and read them like an architect. A variant that wins recall by 2% but doubles index size and complicates ingestion may still lose. Record metric deltas next to their cost: index size, ingestion complexity, query latency, per-query spend.

  5. Give the reranker a budget, not a blessing. If reranking wins on the golden set, write its latency and cost budget into the design explicitly — which queries get reranked (all? low-confidence only?) and what the p95 latency target absorbs.

  6. Write the retrieval design doc from results. One section per decision: chosen strategy, the eval numbers that chose it, the losing option's best number, and the trigger that reopens the decision (new document type, golden-set drift, latency regression).

  7. Wire the golden set into the future. The same set that made these decisions becomes the regression gate for the next change — hand the eval harness to the build team as part of the design (pb-33 designs that loop fully).

Verify before you trust it

  • Eval numbers come from your run, not the AI's narrative. The assistant proposes hypotheses; only your Ragas output on your golden set decides. If a design-doc sentence cites a number, it must trace to a run artifact.
  • The golden set is honest. Questions came from real users or realistic tickets, answers were verified by a human against source passages, and no question was written by looking at what retrieval already does well.
  • Latency measured, not estimated. Reranker and hybrid-search latency claims are checked with a stopwatch on your stack — p95 over 20+ queries, not a vendor blog figure.
  • Costs per query computed from current price sheets. Embedding, reranking, and token costs come from the provider's published pricing, with your actual token counts.
  • The winning config reproduces. Re-run the winning cell once; a result that doesn't reproduce within noise is not a decision, it's a coin flip.

Restricted-environment variant

Client documents often cannot leave approved boundaries — extract the MSA constraints first. Build the experiment with a synthetic corpus that mirrors the client's document structure (same formats, section shapes, and table density, fake content) so chunking behavior transfers; generate it with schema-faithful synthetic-data prompts. Run embeddings and evals against client-approved tenancy (Bedrock or Azure OpenAI in the client's subscription) or fully locally — LlamaIndex with local embeddings via Ollama and Ragas offline keeps the whole loop on your machine. The decision doc and eval discipline are identical either way.

Key Takeaway:

Every retrieval decision is a hypothesis until a golden-set eval settles it — AI enumerates the options, your Ragas run picks the winner, and the numbers go in the design doc next to their costs.

This is the free reading view. Open BXUP to track your progress, run the hands-on labs, and prove it with original, exam-pattern assessments.
© Anvi Innovate · BXUP — Be Exponentially Upskilled · BXUP is an independent learning platform, not affiliated with or endorsed by AWS, Microsoft, Google, NVIDIA, IBM, Salesforce, Databricks, Oracle or Anthropic. All trademarks belong to their respective owners. · bxup.in