接口介绍
本接口（
/atom/update）用于按主键更新一条已存在的原子记忆。通过 id 定位目标，传入要更新的字段值，系统按"全量覆盖"语义替换对应字段：目标定位：通过
id 指定目标原子记忆主键（必填）。正文更新：通过
content 传入更新后的原子记忆正文全量值（必填，整体覆盖旧内容）。背景更新：通过
background 传入更新后的上下文背景信息（可选）。字段缺省表示本次不更新背景；显式传入空串 "" 则代表清空背景。说明：
原子记忆不提供手动写入接口——原子记忆由系统自动沉淀产生，本接口仅用于在已沉淀原子记忆上做内容订正，不支持"按 id 不存在则创建"的 upsert 语义。若
id 不属于当前调用上下文，统一返回业务错误码 404。Method 与 URL
POST https://{服务访问地址}/v2/atom/update
使用示例
curl -i -k -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer ******************************' \\-H "x-tdai-service-id: mem-8i8t****" \\https://memory.tdai.tencentyun.com/v2/atom/update \\-d '{"id": "note-3a7b9c1d","content": "用户偏好关西线路，5 月出行，预算 1.5 万元，避免大阪过于密集的行程安排。","background": "用户在 2026-04-20 的旅游咨询会话中明确偏好。"}'
说明：
鉴权说明：所有接口都必须在请求头中携带
Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>，否则将返回鉴权失败。请求参数
参数名 | 类型 | 必填 | 描述说明 |
id | str | 是 | 目标原子记忆 ID。需要修改的记忆片段的唯一主键标识。 |
content | str | 是 | 新的记忆正文（全量覆盖）。传入更新后的完整文本。注意：该操作为全量更新，会直接覆盖原有的记忆内容。 |
background | str | 否 | 新的上下文背景信息。用于调整该记忆产生的背景或补充说明。为了防止误操作，其传值规则如下： 不更新：传 None（或不传该字段），系统将保留原背景不变。 清空：显式传入空字符串 ""，系统将彻底清除原背景。 |
响应示例
{"code": 0,"message": "ok","request_id": "req-7fd3b2dd","data": {"id": "note-3a7b9c1d","updated_at": "2026-04-21T08:30:15Z"}}
字段名 | 类型 | 说明 |
id | str | 新创建或被操作的原子记忆主键 ID。系统生成的唯一标识符（格式如 "atom-xxxx"），后续对该条记忆的更新、删除或查询操作都需要传入此 ID。 |
updated_at | str | 最后修改时间戳。采用 ISO 8601 标准格式（例如 "2026-05-22T14:30:00+08:00"）。代表该条原子记忆在服务端写入成功并正式生效的最新时间。 |
