Retrieval Tuning

Optimize memory retrieval for your use case.

Relevance Threshold

Control result quality vs. quantity:

{
  "context": "user preferences",
  "relevance_threshold": 0.7
}

Threshold	Results
0.3-0.5	More results, lower precision
0.5-0.7	Balanced
0.7-0.9	Fewer results, higher precision

Limit the number of results:

{
  "context": "...",
  "max_memories": 5
}

Use fewer memories for:

Use more memories for:

How you phrase queries affects results:

Query Style	Best For
Questions	"What does the user prefer?"
Keywords	"user preferences dark mode"
Statements	"Finding information about user preferences"

Pre-filter memories by metadata:

{
  "context": "preferences",
  "metadata_filter": {
    "category": "preference"
  }
}