The two tenant settings
Choose a mode
The mode decides whether durable memory is active at all.
| Mode | Behavior |
|---|---|
| Disabled | No durable memory. The assistant only remembers within each conversation. |
| Durable | Durable memory is on. The assistant can recall facts across conversations. |
Choose a retention level
When the mode is Durable, retention decides how new facts get into memory.
| Retention | Behavior |
|---|---|
| None | Recall only. The assistant uses what’s already stored but adds nothing new. |
| Explicit only | Stores a fact only when a user explicitly asks it to remember something. See Memory commands. |
| Automatic | Also captures relevant facts from conversations on its own, in addition to explicit requests. |
Mode × retention at a glance
The two settings combine to give you precise control over reading and writing memory:| Mode | Retention | Recalls existing memories? | Stores new memories? |
|---|---|---|---|
| Disabled | — | No | No |
| Durable | None | Yes | No |
| Durable | Explicit only | Yes | Only when explicitly asked |
| Durable | Automatic | Yes | Yes, automatically and on request |
Scoping further with a knowledge base
Each knowledge base has its own memory mode — Disabled, Subject, or KB-restricted. A knowledge base can only further restrict the tenant setting, never widen it.If the tenant has durable memory turned off, a knowledge base cannot turn it on. The tenant setting is always the ceiling, and the knowledge base setting narrows from there.
What happens when memory is enabled
Once durable memory is active, recall and storage happen quietly in the background:- On each new message, relevant memories are automatically retrieved and added to the assistant’s context.
- The assistant indicates when a memory was used, so it’s clear where recalled context came from.
- New facts are stored according to your retention level.
Recall and storage are best-effort. A memory-service failure does not block a normal answer; if nothing relevant is found, the assistant simply answers without recalled context.
Choosing your settings
Next steps
Memory commands
Store facts conversationally with natural phrasing.
Manage memories
View, search, and delete what’s been remembered.
Memory modes
Restrict memory for a specific knowledge base.
Memory overview
Revisit how the memory levels fit together.