> ## 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

![Studio Retrievers page listing retrievers with their stage badges and collections](https://mintcdn.com/mixpeek/Wd_dr3_jo8gqgFxV/assets/studio/retrievers.png?fit=max\&auto=format\&n=Wd_dr3_jo8gqgFxV\&q=85\&s=c18b118ee9feeee245388d121263ff7b)

The Retrievers page — multi-stage search pipelines, showing the stages and collections each retriever uses.

[Retrievers](https://d8ts56gtwtyh1.cloudfront.net/docs/warehouse/retrievers.mp4)

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](https://docs.mixpeek.com/docs/api-reference/retrievers/create-retriever.md) and [List Stages](https://docs.mixpeek.com/docs/api-reference/retriever-stages/list-available-retriever-stages.md).
* **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](https://docs.mixpeek.com/docs/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](https://docs.mixpeek.com/docs/api-reference/retrievers/get-retriever.md), [List](https://docs.mixpeek.com/docs/api-reference/retrievers/list-retrievers.md), [Delete](https://docs.mixpeek.com/docs/api-reference/retrievers/delete-retriever.md), [Raw Inference](https://docs.mixpeek.com/docs/api-reference/inference/execute-raw-inference.md).

### 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.

**1. Create a retriever**

Name it, select collections, and add stages from the catalog.

**2. Configure stages**

Set parameters and optional pre/post filters; chain multiple stages for hybrid or rerank flows.

**3. Test and iterate**

Run with sample inputs and inspect per-stage timing and results.

Use Debug Inference to inspect raw model outputs and embeddings when tuning parameters.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.