接口介绍
本接口（
/v3/atomic/update）用于按记忆 ID 更新指定的 L1 原子记忆内容。功能说明如下：更新方式：传入原子记忆 ID 及新内容，覆盖原有记忆文本。
同步更新：接口为同步更新，单次请求仅支持更新一条原子记忆。
说明：
适用场景：Agent 发现某条原子记忆存在误差或需要补充信息时，可通过本接口直接修正，避免删除后重建导致 ID 变更影响下游引用。
Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/atomic/update
使用示例
curl -i -k -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer *********************************' \\-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\https://memory.tdai.tencentyun.com/v3/atomic/update \\-d '{"id":"atm-ccdd","content":"用户每周三上午 10:00 参加产品评审会，会议室为 3F-星空厅","background":"用户刚更换了会议室房间"}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
team_id | 否 | 团队 ID。 | 数据类型：String。 |
user_id | 否 | 用户 ID。 | 数据类型：String。 |
agent_id | 否 | Agent ID（全局唯一）。 | 数据类型：String。 |
task_id | 否 | Task ID。 | 数据类型：String。 |
id | 是 | 待更新的原子记忆 ID。 | 数据类型：String。 不限制 ID 前缀格式（如 atm-、note- 等任一前缀均可），传入已存在的记忆 ID 即可。 |
content | 是 | 新的记忆文本内容。 | 数据类型：String。 长度上限：8192 字符（8 KB）。 会完全覆盖原有内容。 |
background | 否 | 更新背景说明。 | 数据类型：String。 用于记录触发此次更新的原因或上下文，不参与记忆检索。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"id":"atm-ccdd","version":"v2","updated_at":"2026-07-22T10:00:00Z"}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | id | 本次更新的原子记忆 ID。 |
| version | 更新后的记忆版本号，每次更新递增。 |
| updated_at | 更新时间，ISO 8601 格式。 |
