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

# Retrievers

<iframe width="600" height="310" src="https://d8ts56gtwtyh1.cloudfront.net/docs/warehouse/retrievers.mp4" title="Retrievers" frameborder="0" allow="accelerometer; autoplay; muted" allowfullscreen autoplay muted />

Retrievers are the warehouse's Reassemble layer, where you compose multi-stage pipelines to query across all your features.

### Build and execute retrievers

* **Create**: Click New Retriever, name it, select collections, and add stages from the catalog. API: [Create Retriever](/api-reference/retrievers/create-retriever) and [List Stages](/api-reference/retriever-stages/list-available-retriever-stages).
* **Stages**: Configure parameters per stage, including pre/post filters. Common stages include KNN search, hybrid fusion, reranking, and grouping.
* **Test**: Use the Run panel to execute with sample inputs, filters, sorts, and pagination. API parity: [Execute Retriever](/api-reference/retrievers/execute-retriever).
* **Inspect**: View per-stage results, timing, and final results. Toggle URL presigning when you need asset links.
* **Manage**: List, view, update, or delete retrievers as they evolve. API: [Get](/api-reference/retrievers/get-retriever), [List](/api-reference/retrievers/list-retrievers), [Delete](/api-reference/retrievers/delete-retriever), [Raw Inference](/api-reference/inference/execute-raw-inference).

### Tips

* Ensure your collections expose the vectors you reference; confirm via `Describe Features` on the collection.
* Use `group_by` to collapse results into logical groups, then control member sorting via stage or final sort.

<Steps>
  <Step title="Create a retriever">
    Name it, select collections, and add stages from the catalog.
  </Step>

  <Step title="Configure stages">
    Set parameters and optional pre/post filters; chain multiple stages for hybrid or rerank flows.
  </Step>

  <Step title="Test and iterate">
    Run with sample inputs and inspect per-stage timing and results.
  </Step>
</Steps>

<Callout type="success">
  Use Debug Inference to inspect raw model outputs and embeddings when tuning parameters.
</Callout>
