recall_fused
Retrieve memories using fused vector-graph recall: walks graph from top vector hit, folds connected facts into ranking; supports multi-hop reasoning, optional filters, and temporal timelines.
Instructions
Fused vector + graph recall: like recall, but also walks the graph from the top vector hit and folds any connected fact into the ranking — the tri-engine ranking (vector similarity + ColumnStore filter + graph reach) measured on multi-hop and temporal benchmarks. Reach for this when an answer needs a fact the query doesn't mention directly but a stored relate/extracted link connects (multi-hop reasoning, temporal chains). hops/graph_boost tune the graph reach; omit them for the proven defaults. Optionally narrow with an exact-match filter. Set date_field (the metadata key holding a YYYYMMDD date) to also get a dated_context timeline and a now anchor for temporal questions. Most relevant first.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hops | No | Graph hops walked from the top vector hit (default 2). Higher reaches further but adds noise; capped at the `why` hop ceiling. | |
| limit | No | Maximum number of memories to return (default 10). Multi-hop reasoning benefits from a larger budget (~32-64); simple and temporal recall saturate early, where a larger budget only adds tokens. | |
| query | Yes | Natural-language query to match semantically. | |
| filter | No | Optional exact-match metadata filter (e.g. `{"project": "veles", "status": "resolved"}`). | |
| date_field | No | Name of the metadata field holding each fact's date as a `YYYYMMDD` integer (e.g. `"ts"`, `"occurred_at"`). When set, the result adds a `dated_context` timeline (facts date-prefixed and ordered oldest-first) plus a `now` anchor — the representation that lifts temporal reasoning. Omit for plain results. | |
| graph_boost | No | Weight added to a graph-reached fact's normalised vector score (default 0.15). Raise to trust the graph more, lower to trust vector similarity more. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| now | No | The most recent date across `memories` (`YYYY-MM-DD`), the "now" anchor. Present only when `date_field` was set and at least one fact is dated. | |
| memories | Yes | Recalled memories, most relevant first. | |
| dated_context | No | Chronological, date-prefixed rendering of `memories` (`- [YYYY-MM-DD] content` per line, oldest first, undated facts last). Present only when `date_field` was set. |