search
Retrieve individual memories ranked by relevance to a query. Uses semantic search when available, otherwise keyword search, with optional cross-encoder reranking.
Instructions
Find individual memories ranked by relevance to a query. Semantic-primary when embedding models are loaded, falling back to deterministic BM25/FTS keyword search otherwise; cross-encoder reranked by default. Read-only. Returns scored, individual memory records (with ids) — use this to locate or inspect specific memories. To assemble a prompt-ready context block, use pack instead; to browse recent memories without a query, use memory_list.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Restrict to memories carrying these tags. | |
| limit | No | Maximum number of memories to return. Default 10. | |
| query | Yes | Natural-language search query. Required. | |
| space | No | Restrict to a single memory space (namespace), or "*" for all spaces. Omit to search the default space. | |
| rerank | No | Apply the cross-encoder reranker to the candidate pool. Default true. | |
| entity_key | No | Restrict to memories linked to this entity key. | |
| include_source | No | If true, reveal provenance/source metadata. Default false. | |
| include_content | No | If true, return each memory's full text instead of a snippet. Default false. | |
| semantic_enabled | No | Force semantic retrieval on or off. Default: on when embedding models are available, else lexical. |