Skip to documentation
Docs navigation
Docs/recall()
MemoGrafterAgent

recall()

Retrieve semantically relevant memories from the current session.

What it does

Retrieve semantically relevant memories from the current session.

Recall reads memory without producing an assistant answer. Use it when your application owns prompt construction or needs to inspect the evidence before calling a model.

Signature

TypeScript
recall(query: string, options?: RetrieverConfig): Promise<RetrievalResult>

Parameters

query (string) — Natural-language intent used to rank relevant memory.
options? (RetrieverConfig) — Optional limits, filters, tags, or operation-specific behavior.

Result

A retrieval result containing ranked facts, matched topics, generated prompt context, and token counts.

Example

example.ts
const result = await agent.recall("deployment preferences", { limit: 5 });