recall

公開 MCP ツール

recall

用途

承認済みのmemory scopeからagentが集中した回答を必要とするとき、関連する永続contextを取得します。

適用シーン

• quickでunscopedな回答が必要で、弱くても役立つrelevanceを許容できる場合。
• callerがpromptサイズのcontext packではなく、少数のranked memoryを求めている場合。
• 厳密なproject/team filterなしで最近のworking contextを確認するtask-start checkが必要な場合。

非推奨シーン

• 弱いmatchを回答として提示してはいけない場合は使わないでください。strict matchingにはsearch_memoryを使います。
• prompt injectionのために複数のbounded memoryを組み立てる場合は使わないでください。recall_contextを使います。
• memoryのwrite、update、deleteには使わないでください。
• REST APIはpublic MCP toolより広いfield setを受け付けます。scope、bucket、team、provenance filterについては/docs/api/memoryを参照してください。

必須スコープ

• memory:readが必要です。返されるmemoryも認証済みowner/team scopeの範囲にとどまります。

パラメーター

返却スキーマ

各memoryのreference、location、content、利用可能なattribution boundaryを含むranked text responseです。空のresultは有効なno-match responseであり、authorization signalではありません。

使用例

recall({
  query: "current MCP authentication decision",
  limit: 3
})

エラー

• 401/403: requestに有効なbearer tokenがない、またはmemory:readがありません。
• Validation failure: query、limit、またはfilter syntaxが無効です。
• Scope or team mismatch: 要求されたboundaryは認証済みownerから見えません。

関連ツール

• search_memory — strict matchingが必要な場合に、targetedな検索を使います。
• recall_context — boundedなmulti-memory context packを使います。
• remember — 明示的に永続化するfactまたはdecisionを保存します。