Namespaces and profiles
Agent Memory uses a two-level isolation model: namespaces define memory domains, and profiles provide isolated memory stores for individual users, agents, teams, tenants, or application objects.
A namespace is a top-level container that scopes a set of memory profiles. Use namespaces to separate applications, environments, tenants, or memory layers such as user, team, and organization memory.
A profile is an isolated memory store for a single entity. Each profile has its own stored memories and retrieval indexes.
A session groups memories that come from the same interaction or conversation. Sessions are optional, but they make it easier to identify, inspect, and manage memories created from a specific conversation.
Sessions are scoped to a profile. Two different profiles can use the same session ID without conflict.
Conceptually, memories are scoped as namespace > profile > memory. No data crosses these boundaries:
Namespace: my-assistant-prod Profile: alice Memories Messages Profile: bob Memories MessagesA recall() on Alice's profile never returns memories from Bob's profile. Each profile is a self-contained memory system.