Core Concepts
Scoping
Isolate memories per user, agent, and run.
Every memory is attached to an identity. Use the right scope so memories are attributed correctly and retrieved separately:
user_id— facts about the end user.agent_id— an assistant's own facts and persona.run_id— a single session, for short-lived context.
On the hosted cloud, memories are additionally workspace-scoped: every
record carries your project id and every read injects the same filter, so
isolation is enforced in the data layer regardless of user_id / agent_id /
run_id.