3.3.2 Memories
A memory defines which part of the DCH knowledge graph an agent may read. Agents only see the data of the memories attached to them, so a memory is also a boundary: what is not in it stays out of reach.
Open M4AI › Library › Memories. The list shows each memory's Source type, its Versions, its Readiness, and how many agents use it. Filter it by type, or search by name.
Source types
A memory has one of two source types, chosen when you create it:
- Graph scope: a set of Target Entities. The agent can search and query the graph within these entities and the relationships between them. Up to 100 target entities.
- Views & functions: published Views and Functions. Each one becomes a tool the agent can call. Up to 100 views and functions.
Functions can change data in DCH, and agents call them without asking for approval. Only add functions an agent may run on its own.
Create a memory
- Choose New memory.
- Enter a name and, optionally, a description.
- Pick the Source type. It cannot be changed later.
- Select the content:
- For a graph scope, select the Target entities under Available target entities. Selected entities and relationships previews how they connect.
- For views & functions, select from the published Views and Functions. The memory pins the latest published version of each.
- Choose Create draft. The memory is created as draft v1.

For a graph scope, saving starts the Automatic schema calculation: DCH works out which properties and relationships of the selected entities the agent can use. When it has succeeded, the Read-only graph schema snapshot shows the labels and relationships, and you can publish. Use Cancel schema calculation or Recalculate schema if needed.
Readiness
| Readiness | Meaning |
|---|---|
| Ready | The memory can be published and attached to agents. |
| Not initialized | The schema has not been calculated yet. |
| Calculating schema | The schema calculation is running. |
| Calculation failed | The schema calculation failed. Check the failure shown in the memory and recalculate. |
| Stale | The memory needs attention. It cannot be published or attached until it is ready again. |
Versions
Memories have draft and published versions:
- Publish version locks the draft and makes it available to agents. A graph memory can only be published once its schema is ready.
- To change a published memory, choose New draft version, edit it, and publish again. Agents keep the version they pinned until their own draft is updated and published.
- Delete draft discards a draft. If it is the memory's only version, this deletes the memory.

The open memory also shows its Derived tools, the tools an agent gets from it, and Used by, the agent versions that pin it.
Attach a memory to an agent
Only published memory versions that are Ready can be attached. You attach them in the agent's Knowledge capability.
Delete a memory
Choose Delete memory to permanently delete the memory with all its versions. The confirmation lists the agent versions that pin it; their runs in progress fail.