Blog·Learning

Contextual Reranking for RAG: Query Context, Candidates, and Tests

Separate query rewriting, chunk enrichment, candidate retrieval, and reranking, then evaluate each stage against labeled evidence.

By Shardul Mane·3 min read

Contextual Reranking for RAG: Query Context, Candidates, and Tests

Contextual reranking means scoring retrieved candidates against a clearly defined question that includes the relevant conversational context. It is distinct from enriching chunks before indexing or combining lexical and vector retrieval. Keep those stages separate so you can identify which change helped.

A reranker can reorder candidates; it cannot recover a document that never entered its candidate set. Start by checking whether the evidence exists in the retrieved pool before changing the ranking model.

Resolve the question before scoring candidates

If the user asks “does that also apply in Germany?”, the literal query lacks the subject of “that.” Construct a standalone retrieval question from the relevant current conversation, preserving constraints such as product, jurisdiction, version, and time. Do not indiscriminately attach every stored user preference.

Record both the original question and the resolved query in the evaluation trace. A bad rewrite can confidently retrieve evidence for the wrong subject. Include tests where the previous subject changes or where the user rejects an earlier assumption.

Distinguish four operations

Operation Changes Evaluation question
Query resolution The search question Was the user's meaning preserved?
Chunk enrichment Indexed document text Does added context identify the source accurately?
Candidate retrieval The eligible evidence pool Is supporting evidence present?
Reranking Order within that pool Is useful evidence near the top?

Anthropic's contextual retrieval research describes an evaluated combination of techniques. Its results are attached to that setup; they are not a guaranteed improvement for every conversational reranker or Supermemory application.

Enforce scope before ranking

Filter candidates to the authorized user, workspace, and document permissions before sending their text to a ranking service. A final UI filter is too late if unauthorized content already reached the model or another provider.

Use stable document and chunk IDs so evaluation can compare the same evidence before and after ranking. If content changes, record the version. Otherwise, a score change may reflect a changed corpus rather than a better ranking method.

Use a small metric implementation you can inspect

This helper computes reciprocal rank and evidence recall at a cutoff. It removes duplicate candidate IDs, rejects unanswerable cases from this particular calculation, and makes no assumptions about the ranking model.

def retrieval_metrics(ranked_ids, relevant_ids, k=5):
    if not isinstance(k, int) or isinstance(k, bool) or k <= 0:
        raise ValueError("k must be a positive integer")
    relevant = set(relevant_ids)
    if not relevant:
        raise ValueError("Score unanswerable questions separately")
    unique = list(dict.fromkeys(ranked_ids))[:k]
    hits = [i + 1 for i, item in enumerate(unique) if item in relevant]
    return {
        "recall_at_k": len(set(unique) & relevant) / len(relevant),
        "reciprocal_rank_at_k": 1 / hits[0] if hits else 0.0,
    }

For relevant IDs A and B, ranking X, A, A, B gives recall 1 and reciprocal rank 0.5 at a cutoff of three unique candidates. These are deterministic metric calculations, not measured model performance.

Compare one change at a time

Keep the same corpus version, labels, candidate budget, and answer model. Compare the baseline, query resolution alone, reranking alone, and the combination. If testing chunk enrichment too, add it as a separately recorded condition.

Track candidate recall before reranking, top-result quality afterward, final answer support, latency, and context tokens. Include unanswerable questions with a separate measure of whether the system correctly declines to infer an unsupported answer. Do not average those cases into a metric that requires at least one relevant document.

Decide from the failures

If the right document is absent, improve ingestion, filters, chunking, or candidate generation. If it is present but buried, reranking may help. If it reaches the model but the answer is wrong, inspect the generation prompt and source interpretation.

The metric helper is tested locally on duplicate IDs, no hits, multiple relevant documents, and invalid cutoffs. No new reranker benchmark was run. Combine this evaluation method with the hybrid-search guide and RAG tutorial when building the actual pipeline.

To evaluate a managed retrieval path, review Supermemory’s search API and run your labeled questions through its documented options. Score the returned evidence against the same baseline; use the results to decide whether further ranking work is needed.

  1. An update to supermemoryWe've discontinued the supermemory company brain and Nova. Everyone who was charged has been refunded, our MCP and plugins continue to run, and we're going all in on the memory engine.
  2. Scaling Conversations: How Adapta Grew Usage Without Losing ContextAdapta added Supermemory as a persistent memory layer so every conversation keeps its context — letting the team scale usage without losing the thread.
  3. How Chatarmin Ditched RAG and Went Memory-Only with SupermemoryChatarmin replaced a heavy RAG pipeline with Supermemory's memory layer — cutting average AI response time from 40s to 12s and token usage by 40–50%.
  4. SMFS: making agentic retrieval 55% cheaper AND more accurateWe launched SMFS.ai (Supermemory Filesystem) a few weeks ago, with a simple bet: We can redesign the filesystem specifically for agents, with special files, structures, and commands that it can use for it's tasks. Today, SMFS is used by hundreds of companies to power their agents.
  5. Introducing Dynamic Dreaming: supermemory now connects the dots, for you.Dreaming is magical. TLDR: We're launching Dynamic Dreaming in supermemory today, which automatically works if you're using supermemory in any way - API, OpenClaw, Hermes agent, etc.
  6. Dear reader, we just made supermemory insanely cheap... the Context CloudWhen I first started building supermemory, I had one goal: To build the best memory system for AI. I would talk to customers, and find out that memory was not the only thing they needed - They were all setting up 7-8 different vendors at the same time.
  7. Introducing @supermemory/tools v2.0.0Today we're releasing v2.0.0. This release unifies the API across all agents sdk integrations from AI SDK to Mastra, makes conversation identity a first-class concept, and ships with memory saving on by default.
  8. Solving the Precision-Recall Tradeoff: Search Result AggregationWhen you're building memory for AI, search is your foundational layer. The way search generally works is straightforward: the user defines a query, and then sets a limit (top-K) on how many search results they want returned. Usually, this is set to 10 or 20.
  9. Stateful Coding Agents with Memory: Build Long-Running Agents (2026)We built a plugin for Claude Code and OpenCode that gives your coding agent persistent memory. It remembers your preferences, learns your codebase, and never loses context mid-conversation. The result is an agent you can run for months without starting over.
  10. OpenClaw Memory Problems: Why It Forgets and How to Fix It (2026)TLDR: Today, we are releasing a new version of our openclaw plugin - https://github.com/supermemoryai/openclaw-supermemory. This post is going to be a bit technical, so bear with me (or bookmark for later!) In this post, I will talk about what we do about OpenClaw memory, and how we fix it.
  11. Clawd / Molt bot's memory SUCKS. We gave it supermemory.I'm the founder of supermemory. Clawd/Molt bot is blowing up right now, with many, many use cases. I set it up, too, and have been using it through telegram. TLDR: just go to https://supermemory.ai/docs/integrations/clawdbot to set up supermemory for your clawd bot.
  12. Catch up with our UNFORGETTABLE Launch WeekOver the last year, one belief has guided almost everything we’ve built at Supermemory AI becomes meaningfully useful only when it remembers. Memory shouldn’t be something developers rebuild from scratch. It shouldn’t be fragile, expensive, or trapped inside a single tool.
  13. Empowering the Next Generation of Founders: Supermemory Startup ProgramIf there’s one thing we’ve learned while building Supermemory, it’s that most startups don’t fail because they didn't build features; they fail when infrastructure slows them down, or they built too slow.
  14. Building code-chunk: AST Aware Code ChunkingAt Supermemory, we're building context engineering infrastructure for AI. A huge part of that is dealing with code: ingesting repos, understanding structure, and making it searchable. The problem is that most code chunking solutions are terrible. We built code-chunk to fix this.
  15. Supermemory raises $3 million with the best memory engine for LLMsToday, I am excited to announce our first funding round to accelerate our mission of building an interoperable, scalable and reliable memory for LLMs and agents. Memory is one of the hardest challenges in AI right now.
  16. Mem0 vs Supermemory: Why Scira SwitchedScira AI moved its production memory layer from Mem0 to Supermemory. This is what failed, what improved, and how the team evaluated the two systems.
  17. Never Record Again: How Montra Uses Supermemory to Rethink Video CreationCampbell Baron, the founder of Montra, has been making videos since he was twelve. By thirteen, he was already doing brand work. Today, he’s betting on a very different future for creators: a world where recording is the exception, and most videos are generated from scratch.
  18. Unified Memory That Works Where You Work: Your Second Brain With SupermemoryHi everyone, I’m Dhravya, the founder of Supermemory. I want to start with a little story behind why this product means so much to me. You can also skip straight to what it is and how it works below.
  19. Supermemory just got faster on PlanetScaleWhat is Supermemory? Supermemory completes the missing part of the LLM puzzle: memory. Just as memory is crucial for human intelligence, it's essential for truly intelligent AI systems.
  20. Faster, smarter, reliable infinite chat: Supermemory IS context engineering.People are obsessed with prompts and prompt engineering. Sure, what you say is important, but what the model knows when you say it is the difference between a stateless text generator and an intelligent AI system. In short, context is the most crucial component.
  21. We solved AI API interoperabilityOne API to rule them all, One spec to find them, One library to bring them all and in the TypeScript, bind them. When we were building the the Infinite Chat API, initially, we only supported the OpenAI format. This was fine, until a lot of our customers started asking, asking for more.
  22. The Wow Factor of Memory - How Flow Used Supermemory To Build Smarter, Stickier ProductsOverview: Flow is a note-taking app built around a bold vision: to create a more personal, context-aware writing experience powered by AI. At the heart of this mission is memory.
  23. The UX and technicalities of awesome MCPsLast month, we launched the Supermemory MCP, mostly to test our own infrastructure and get some initial traction. It blew up. To my absolute surprise, the initial launch itself got half a million impressions (!!!). Then, we launched and got #2 on ProductHunt too.
  24. Architecting a memory engine inspired by the human brainLanguage is at the heart of intelligence, but what truly powers meaningful interaction is memory — the ability to accumulate, recall, and contextualize information over time. Large Language Models (LLMs) have mastered language, but memory remains their Achilles’ heel.