一、接口介绍
·目标定位：通过 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"）。代表该条原子记忆在服务端写入成功并正式生效的最新时间。 |