managed-agents-memory

# 智能体 — 内存存储 > **公开测试版。** 内存存储通过 `managed-agents-2026-04-01` 测试版请求头发布；SDK 会在所有 `client.beta.memory_stores.*` 调用中自动设置该请求头。如果缺少 `client.beta.memory_stores`，请升级到最新的 SDK 版本。 会话默认是短暂的——当会话结束时，智能体学到的任何内容都会消失。**内存存储**是一个工作区范围内的文档集合，可以在会话之间持久保存。当存储被附加到会话（通过 `resources[]`）时，它会被挂载到容器中作为一个文件系统目录；智能体使用普通文件工具进行读写，系统提示词会告知智能体挂载点的存在。 对内存的每一次修改都会产生一个不可变的**内存版本** (`memver_...`)，为您提供审计追踪和时间点回滚/修订功能。 ## 对象模型 | 对象 | ID 前缀 | 作用域 | 备注 | | --- | --- | --- | --- | | 内存存储 | `memstore_...` | 工作区 | 通过 `resources[]` 附加到会话 | | 内存 | `mem_...` | 存储 | 一个文本文件，通过 `path` 寻址（每个 ≤ 100KB — 建议使用多个小文件） | | 内存版本 | `memver_...` | 内存 | 每次修改的不可变快照；`operation` ∈ `created` / `modified` / `deleted` | ## 创建存储 `description` 会传递给智能体，以便它了解存储的内容——请为模型编写，而不是为人类编写。 python store = client.beta.memory_stores.create( name="User Preferences", description="Per-user preferences and project context.", ) print(store.id) # memstore_01Hx... 其他 SDK：TypeScript `client.beta.memoryStores.create({...})`；Go `client.Beta.MemoryStores.New(ctx, ...)`。请参阅 `shared/managed-agents-api-reference.md` → SDK 方法参考以获取完整的各语言表格。 存储支持 `retrieve` / `update` / `list`（带有 `include_archived`、`created_at_{gte,lte}` 过滤器）/ `delete` / **`archive`**。归档使存储变为只读——现有的会话附件继续有效，新会话无法引用它；不支持取消归档。 ### 使用内容初始化（可选） 在任何会话运行之前预加载参考资料。`memories.create` 在给定的 `path` 创建一个内存；如果该路径下已存在内存，调用将返回 `409` (`memory_path_conflict_error`，包含冲突的 `memory_id`)。存储 ID 是第一个位置参数。 python client.beta.memory_stores.memories.create( store.id, path="/formatting_standards.md", content="All reports use GAAP formatt"