> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieval overview

> How agents find the right context at inference — hybrid ranking, filters, and grounding.

**Retrieval** is what happens when your Agent needs to look something up. Given a query and a data source, retrieval returns the small set of chunks most likely to be useful.

Good retrieval is often the difference between an Agent that answers well and one that hallucinates. Nora ships strong defaults but every knob is exposed.

## The pipeline, in order

1. **Query construction** — the Agent's question, possibly rewritten for clarity.
2. **Filter** — narrow candidates by metadata (tag, source, date, entity).
3. **Rank** — hybrid vector + keyword scoring.
4. **Fuse** — combine signals into a single relevance score.
5. **Ground (optional)** — check against a causal graph before returning.
6. **Cut off** — return the top-N chunks by score.

Each step is configurable via a **Retrieval preset**.

## Where retrieval happens

* **Inside an Agent block** — every model call that has attached data sources triggers retrieval first.
* **Inside a Tool** — a special `retrieve` tool lets the Agent explicitly search when it decides it needs to.
* **In a Foundry pipeline** — for chained pipelines where one output feeds another's context.

## What you can tune

<CardGroup cols={2}>
  <Card title="Hybrid search" icon="magnifying-glass" href="/build/retrieval/hybrid-search">
    Balance vector similarity vs. keyword matching.
  </Card>

  <Card title="Presets" icon="sliders" href="/build/retrieval/presets">
    Save a retrieval config and reuse across Agents.
  </Card>

  <Card title="Filters" icon="filter" href="/build/retrieval/filters">
    Metadata filters — tag, source, entity, date.
  </Card>

  <Card title="Ranking" icon="scale-balanced" href="/build/retrieval/ranking">
    Weights, boosts, and reranker toggles.
  </Card>

  <Card title="Grounding" icon="shield-check" href="/build/retrieval/grounding">
    Verify retrieved facts before returning.
  </Card>

  <Card title="Diagnostics" icon="stethoscope" href="/build/retrieval/diagnostics">
    Why isn't my chunk showing up?
  </Card>
</CardGroup>
