方法介绍
write_core 用于全量覆盖写入 L3 核心记忆。功能说明如下：写入方式：核心记忆以
(team_id, agent_id) 为粒度组织，每次写入覆盖上一个版本。版本管理：每次写入生成新版本号，数值类型，从 0 开始。写入与当前版本内容相同时版本号可能不增加。
导入
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.write_core(content="""该 Agent 负责产品评审和团队周会的会议纪要整理。用户偏好在早晨 9:00–11:00 处理重要任务，不喜欢被打断。团队使用敏捷开发流程，每两周一个迭代。关键联系人：张三（产品）、李四（研发）、王五（测试）。""",)print(f"已写入到 {result['version']}，时间: {result['updated_at']}")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
content | str | 是 | 核心记忆内容，长度上限 65536 字符 |
响应示例
{"agent_id": "agt-xyz789","version": 5,"updated_at": "2026-07-22T16:00:00Z"}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
agent_id | str | 被写入的 Agent ID |
version | int | 写入后生成的新版本号，从 0 开始。写入与当前内容相同时可能不增加 |
updated_at | str | 更新时间，ISO 8601 格式 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | content 为空 | 检查 content 参数 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |
