Recall from current memory
recallAnswers questions from active memory only, returning 'I don't know' instead of guessing and never using retired facts; enable history only for past-state or switch questions.
Instructions
Answer a question from CURRENT memory — the active value ('what state library do we use?')
or a multi-hop question over current facts. Returns 'I don't know' rather than guessing, and
NEVER answers from a retired/retracted fact. For the timeline of a subject, use history.
Set include_history=True ONLY for questions explicitly about the past — 'what did we use
before?', 'when did we switch?' — where retired facts are the answer. It is off by default
because with it off, superseded values are never loaded at all, so a stale value cannot be
returned as current regardless of how the model behaves. Leaving it off is the guarantee;
turning it on trades that for reach into the timeline.
critical_categories (comma-separated) names fact categories that must ALWAYS reach the
answer regardless of ranking — 'allergy,active_medication' in a clinical deployment. Ordinary
recall is semantic top-k, so a fact that does not rank is invisible, not merely deprioritised;
for some categories that is a safety failure rather than a quality one. Leave empty to use the
deployment-wide VAYL_CRITICAL_CATEGORIES; an empty value never means 'none'.
Set explain=True to also get the PROVENANCE — the exact facts used to answer, each with who
asserted it, its confidence, and what it superseded. That's the truthful basis for an audit of
why the agent believes what it does (and it's what record_decision snapshots).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"question": "<question>"
},
"name": "recall"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | No | ||
| explain | No | ||
| user_id | No | default | |
| agent_id | No | ||
| question | Yes | ||
| include_history | No | ||
| critical_categories | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |