方法介绍
update_atomic 用于按 id 更新 L1 原子记忆笔记的内容。功能说明如下：更新方式：传入笔记
id 及新内容 content，覆盖该笔记原有内容；单次仅支持更新一条笔记。版本管理：每次更新生成新版本号（
v1 > v2 > …），旧版本不可直接修改。幂等性：多次以相同内容调用同一
id，结果一致但版本号递增。导入
from tencentdb_agent_memory.v3 import MemoryClient
使用示例
from tencentdb_agent_memory.v3 import MemoryClientwith MemoryClient(endpoint="https://memory.tdai.tencentyun.com",api_key="sk-xxxxxxxxxxxxxxxx",service_id="tdai-mem-xxxxxxxx",team_id="team-abc123",agent_id="agt-xyz789",user_id="usr-456",) as client:result = client.update_atomic(id="note-xxxx",content="用户偏好在早晨 9:00–11:00 处理重要任务，不喜欢被打断",session_id="sess-001", # 可选，覆盖构造时的默认会话background="源于 2026-07-20 工作时间偏好的多轮讨论",)print(f"已更新到 {result['version']}，时间: {result['updated_at']}")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
id | str | 是 | 待更新的原子记忆笔记 id |
content | str | 是 | 更新后的记忆内容，长度上限 8192 字符 |
session_id | str | 否 | 覆盖构造时已绑定的默认 session_id |
background | str | 否 | 背景信息或更新原因说明 |
响应示例
{"id": "note-xxxx","version": "v3","updated_at": "2026-07-22T14:30:00Z"}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
id | str | 被更新的笔记 id |
version | str | 更新后的新版本号 |
updated_at | str | 更新时间，ISO 8601 格式 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | id 或 content 为空 | 检查必填参数 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
404 | 笔记不存在或无权访问 | 检查 id 是否正确 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |
