recall
Search memories by semantic similarity, refine low-confidence results, or provide feedback to improve future retrieval.
Instructions
Search memories by semantic similarity, refine low-confidence results, or give feedback.
MODES:
Search (default): recall("project architecture decisions")
Refine: recall("PostgreSQL vs MySQL decision", refine_from="database choice", refine_exclude=["rid1"])
Feedback: recall(query="", feedback_rid="abc", feedback="relevant")
WHEN TO USE:
At conversation start: recall a summary of the user's first message.
When user references past decisions, people, preferences, or "last time".
When unsure about something the user assumes you know.
Use refine_from when first recall had low confidence (< 0.5).
Use feedback_rid after using a recalled memory to improve future retrieval.
QUERY GUIDELINES:
Use a short natural language sentence (5-10 words), NOT keyword lists.
GOOD: "private retail demo with shift brain"
GOOD: "user's architecture preferences"
BAD: "private retail demo stunning pitch shift brain yantrikdb rewritten reality private operations memory"
Keyword stuffing degrades recall quality and is slower. Ask one focused question per call.
If you need multiple topics, make separate recall calls.
Args: query: Short natural language sentence (5-10 words). NOT a keyword list. top_k: Max results (default 10). 3-5 for focused, 10-20 for broad. memory_type: Filter: "semantic", "episodic", "procedural". domain: Filter: "work", "preference", "architecture", "people", etc. source: Filter: "user", "inference", "document", "system". namespace: Filter by namespace. include_consolidated: Include merged memories. expand_entities: Use knowledge graph boosting (default True). refine_from: Original query text to refine from. query becomes the refinement. refine_exclude: Memory IDs to exclude when refining. feedback_rid: Memory ID to give feedback on (switches to feedback mode). feedback: "relevant" or "irrelevant" (required with feedback_rid). feedback_score: Score at retrieval (helps learning). feedback_rank: Rank position at retrieval.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| top_k | No | ||
| domain | No | ||
| source | No | ||
| feedback | No | ||
| namespace | No | ||
| memory_type | No | ||
| refine_from | No | ||
| feedback_rid | No | ||
| feedback_rank | No | ||
| feedback_score | No | ||
| refine_exclude | No | ||
| expand_entities | No | ||
| include_consolidated | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |