FAQ

Agent forgets between sessions

First, check the capability is granted at all:

toolsets = ["memory"]

Without it the agent has session history but no long-term memory, so anything outside the current conversation is genuinely gone.

If memory is enabled, the usual cause is scope. A memory saved with session scope belongs to one conversation; only user scope follows the person across conversations.

[save_defaults]
default_scope = "session"

That default is deliberate - most of what an agent learns mid-task should not follow someone forever - but it means preferences need to be saved as user scope to persist.

Two related things that are not memory: context files hold instructions present on every run, and RAG holds searchable documents. Neither remembers what a person said.

Next

  • Give an agent memory - scopes and recall tuning.
  • - types, TTLs, and search controls.

On this page