| 1 | --- |
| 2 | title: Agent memory |
| 3 | description: What an agent remembers between conversations, where each fact came from, and where it may be recalled. Scopes keep private conversations private; people pin, correct and forget facts. |
| 4 | --- |
| 5 | |
| 6 | An agent has **no hidden memory**. Apart from its own definition, it knows |
| 7 | only what it reads through a tool while it works, and the facts on its |
| 8 | **Memory** tab. Every fact says where it came from, and its **scope** |
| 9 | decides, in code, where it may be recalled and who may see it. |
| 10 | |
| 11 | ## Scopes |
| 12 | |
| 13 | | Scope | Recalled | Who can see and change it | |
| 14 | | --- | --- | --- | |
| 15 | | **Workspace** | Anywhere in the workspace, for anyone. | Everyone sees it. Owners add, correct and forget it. | |
| 16 | | **Conversation** | Only in the channel it came from, and that channel's threads. | People in that channel. | |
| 17 | | **Just you** | Only in your direct messages with the agent. | Only you. | |
| 18 | |
| 19 | An agent keeps a workspace fact only when it learned it somewhere every |
| 20 | member can already read, such as a public channel, or when an owner gives it |
| 21 | one. A fact from a private channel stays in that channel; a fact from your |
| 22 | DM stays with you. |
| 23 | |
| 24 | Owners don't see other people's private facts. Owners control money and |
| 25 | agents, not other people's conversations. |
| 26 | |
| 27 | ## Where facts come from |
| 28 | |
| 29 | | Source | For example | |
| 30 | | --- | --- | |
| 31 | | **A message** | Something said in `#support`: *The Enterprise plan includes SSO.* | |
| 32 | | **A session** | A session's report: *The nightly export runs at 02:00 UTC.* | |
| 33 | | **A person** | Someone told it, on its Memory tab or in chat: *Releases go out on Thursdays.* | |
| 34 | |
| 35 | Each fact shows who kept it (the agent, or the person who told it), its |
| 36 | source and when. When someone corrects a fact, its source becomes them, |
| 37 | marked *corrected*. |
| 38 | |
| 39 | ## Add a fact |
| 40 | |
| 41 | 1. Open the agent, then **Memory**. |
| 42 | 2. Under **Add a fact**, write it in a sentence, up to 500 characters. |
| 43 | 3. Choose who it is for: **Just me**, **This workspace** (owners only), or **A channel** you are in. |
| 44 | 4. Choose **Remember**. |
| 45 | |
| 46 | Facts you add are pinned. |
| 47 | |
| 48 | ## Pin, correct and forget |
| 49 | |
| 50 | Hover a fact to: |
| 51 | |
| 52 | - **Pin** it: pinned facts come first whenever the agent recalls facts for |
| 53 | that place. |
| 54 | - **Edit** it: correct it in place. The agent uses the corrected fact from |
| 55 | its next reply. |
| 56 | - **Forget** it: it is deleted and never recalled again. The agent can |
| 57 | learn it again if it comes up. |
| 58 | |
| 59 | You can change any fact you can see, except workspace facts, which only |
| 60 | owners change. |
| 61 | |
| 62 | ## Limits |
| 63 | |
| 64 | | | | |
| 65 | | --- | --- | |
| 66 | | One fact | Up to 500 characters, one paragraph. | |
| 67 | | Facts per agent | 2,000. Past that, it must forget before it remembers. | |
| 68 | | Facts per reply or session step | The 40 that apply to that place, pinned first. | |
| 69 | |
| 70 | Customer-data files are never remembered. See |
| 71 | [what agents can do for whom](/guides/agent-access/#what-an-agent-can-and-cant-know). |
| 72 | |
| 73 | ## Next |
| 74 | |
| 75 | - [Sessions](/guides/agent-sessions/): the work that teaches agents most of what they know. |
| 76 | - [Agents](/guides/agents/): hiring agents from templates. |