Skip to main content

Memory in teams

Memory belongs to each agent, not to the orchestrator. The orchestrator keeps the thread; each agent decides what it remembers, in its own runtime.

An expert that handles hundreds of customers needs the right history each time. So the first time an expert joins a conversation, the orchestrator asks it which of its memory sessions the conversation belongs to. The orchestrator then binds the conversation to that session.

Binding​

Every expert gets this request, whatever its runtime. A 6022 Agent does it with its memory tools. The id must be alone on the last line, or the orchestrator may grab the wrong UUID, like an order id (details).

Name sessions after what they're about​

The expert picks by name, so names decide whether binding works. Put the business key first, and keep one object per session:

AgentSession names
Customer carecustomer C45653
Claimsclaim CLM-2025-00142
GDPRGDPR article 15
Accountinginvoice INV-2025-0001
Supportticket TKT-8889f6a1

Keep the format stable (customer C45653 everywhere, not cust 45653 elsewhere). When there's no key, a clear subject such as refund procedure still works.

Where knowledge comes from​

An expert can know things in three ways:

  • Past conversations, stored in its sessions. The agent starts empty and learns from real exchanges.
  • Context you inject before the first conversation, such as a policy or a procedure. See Memory.
  • Live data from tools, such as a CRM through MCP, for anything that changes. See Tools.

Use memory for what the agent should remember, and tools for what it should look up.