Memory
Give Agents durable knowledge with explicit ownership, retention, and retrieval boundaries.
A Memory is an Agent-facing Resource for durable knowledge. An Agent can remember a record, search relevant records, retrieve one record, delete one record, or purge everything it owns in that Memory. The Memory defines who owns each partition, how long records remain, and how retrieval behaves. Agent input never selects an arbitrary partition.
Memory and Memory Stores
The Console separates the logical capability from its persistence backend:
| Object | Responsibility |
|---|---|
| Memory | Stable Agent binding, owner scope, retention, retrieval defaults, and access Policy |
| Memory Store | Persistence, indexing, retrieval implementation, Credentials, and provider-specific configuration |
Constal Memory is a platform-provided Store available to every tenant. A tenant may also configure another Store that implements the same Memory Store capability. Changing the Store implementation does not change the operations the Agent uses.
Choose an owner scope
| Scope | Partition is derived from | Typical use |
|---|---|---|
| Session | Accepted durable session | Conversation context that must not cross sessions |
| Principal | Authenticated principal | Personal preferences and individual history |
| Customer | Authenticated downstream customer | Shared context for one customer organization |
| Tenant | Authenticated tenant | Knowledge shared across authorized tenant Agents |
Customer scope fails closed when the accepted request has no authenticated customer. Principal and customer identities come from Channel authentication and accepted authority, not from text supplied to the Agent.
Choose an interface
| Interface | Use it for |
|---|---|
| Console | Configuring and reviewing Memories and Memory Stores |
| SDK | Remembering, searching, retrieving, deleting, and purging within an Agent |
| CLI | Repeatable Memory and Store configuration through the Resource API |
| Platform API | Embedding Memory administration in another system |
Continue
Use Configure Memory to create one, then Use Memory from an Agent to bind and invoke it. Review Scoped bindings when the Store itself must vary by tenant, customer, or principal.