Skip to main content
Memory Store 让 Agent 拥有跨会话的长期记忆。会话是短暂的——沙箱与对话历史随会话结束而封存；Memory Store 是持久的——挂载到任意多个会话，Agent 在工作中读取和沉淀记忆，你可以随时审计每一次变更。

​
控制台操作

进入 Managed Agents → 记忆库 创建 Store，在详情中查看、添加或编辑记忆条目，并通过版本记录检查变更内容与来源。 创建会话或定时任务时挂载记忆库，并确认读写权限。共享记忆可跨会话复用；单次会话历史不会自动变成长期记忆。评测时优先使用只读挂载，避免不同测试用例相互影响。

​
工作方式

  1. 创建一个 Memory Store，可选地预置初始内容。
  2. 创建会话时把 Store 挂载为资源（read_only 或 read_write）。
  3. 记忆以文件形式出现在沙箱的 /mnt/memory/ 目录下，Agent 用普通文件工具读写。
  4. Agent 写入的每次变更都产生一个不可变的版本记录，可回溯、可脱敏。

​
创建 Memory Store

字段：name（必填，1–255 字符，不含控制或格式字符）、description（≤1024 字符）、metadata（最多 16 个 string 键值）。创建成功返回 200。

​
预置初始内容（可选）

用 Memory 接口直接写入条目。每条记忆由一个路径和一段文本组成：
path 以 / 开头（NFC 归一化，≤1024 UTF-8 字节，不得为裸 /、不得含空段、.、.. 或控制字符）；content 是 UTF-8 文本，默认上限 100 KiB。 创建 Memory 成功返回 200。本页使用 managed-agents-2026-09-22 协议；旧协议下创建 Memory Store 或 Memory 仍返回 201。

​
挂载到会话

创建会话时通过 resources 挂载，单个会话最多 8 个 Memory Store：
  • access：read_only 或 read_write，省略默认 read_write。
  • instructions：可选（≤4096 字符），告诉 Agent 这个 Store 的用途与写入规范。
  • 挂载路径由平台生成，形如 /mnt/memory/<名称 slug>-<ID 尾缀>（防同名碰撞），以会话响应中 resources[].mount_path 的返回值为准。

​
Agent 如何访问记忆

记忆对 Agent 就是挂载目录下的文件：用 read / grep 检索，用 write / edit 沉淀（read_write 时）。Agent 侧的每次写入都会同步为 Memory 条目并产生版本记录，无需额外协议。

​
查看与编辑记忆

你可以在会话之外直接管理 Store 里的内容：
列表参数：path_prefix（/ 或以 / 结尾的前缀）、depth（0–1024，目录层级）、view（basic 默认不含内容；full 返回内容但 limit 上限 20）。列表元素分两类：memory（条目）与 memory_prefix（目录前缀），便于做树状浏览。 单条操作： 更新前先读取当前 content_sha256，再把它作为条件提交。type 与哈希都要传：

​
审计记忆变更

每次创建、修改、删除都会产生一条不可变的版本记录，标注操作类型（created / modified / deleted）与执行主体（session_actor 会话内 Agent，含 session_id；或 user_actor API 调用者）：
如果某个版本包含不应留存的敏感内容（如用户误发的密钥），用脱敏接口抹除该版本的内容与路径，保留审计轨迹：
脱敏后该版本的 path / content / content_sha256 变为 null，redacted_at 与 redacted_by 记录操作时间与主体。不能对当前 head 版本脱敏，会返回 409；先改内容或删除条目，再对历史版本执行 redact。

​
管理 Store

​
最佳实践

  • 用路径组织语义：像设计目录结构一样设计记忆路径（/preferences/、/facts/、/decisions/），配合 path_prefix 检索。
  • 用 instructions 立规矩：挂载时明确写入规范（什么值得记、写到哪里、什么格式），比事后清理更有效。
  • 敏感内容走脱敏：删除条目不会抹掉历史版本里的内容，涉密数据要对版本执行 redact。
  • 共享记忆用 read_only：多个 Agent 共享一份知识库时，只给需要沉淀的会话 read_write。

​
冲突与Multi Agent

新协议下，同路径写入冲突可返回 memory_path_conflict_error，条件更新失败可返回 memory_precondition_failed_error；HTTP 仍为 409。读取当前版本并按正确 precondition 重试，不要将冲突当作网络故障无限重试。 同一 Session 的成员共享挂载 Store；并行改相同文件会存在竞争，给成员安排各自的条目路径或由主线程合并。归档/删除 Store 前结束其 running 的 read_write 引用，否则会被拒绝。

​
下一步

创建会话

resources 数组的完整字段

预装沙箱环境

/mnt/memory 挂载契约

本页对应 OpenAPI

Memory Store 与 Memory 条目