接口介绍
本接口（
/v3/core/write）用于写入（创建或覆盖）L3 核心记忆文件。功能说明如下：写入方式：每个
(team_id, agent_id) 至多保留一份核心记忆文件，每次写入覆盖当前内容。版本管理：每次写入生成新版本号，数值类型，从 0 开始递增。注意：写入与当前版本内容相同时版本号可能不增加。
说明：
核心记忆适合存储长期稳定的用户画像、偏好配置、领域知识等。建议由 Agent 在 L2 场景文件中持续沉淀浓缩后写入，而非直接写入临时对话碎片。
Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/core/write
使用示例
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/core/write \\-d '{"user_id":"usr-456","agent_id":"agt-xyz789","content":"## 用户画像\\n- 角色：产品负责人\\n- 技术栈：Python/Go，精通分布式缓存\\n- 沟通偏好：简洁、结果导向\\n\\n## 关键偏好\\n- 会议室：3F-星空厅\\n- 决策方式：数据驱动"}'
鉴权说明：
所有接口都必须在请求头中携带
Authorization: Bearer <API Key> 与 x-tdai-service-id: <实例 ID>，否则将返回鉴权失败。请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
team_id | 否 | 团队 ID。 | 数据类型：String。 |
user_id | 否 | 用户 ID。 | 数据类型：String。 |
agent_id | 否 | Agent ID（全局唯一）。 | 数据类型：String。 |
task_id | 否 | Task ID。 | 数据类型：String。 |
content | 是 | 核心记忆文件内容。 | 数据类型：String。 每次写入会覆盖当前文件的全部内容。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"version":6,"updated_at":"2026-07-22T10:00:00Z"}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | version | 写入后的新版本号，数值类型，从 0 开始。写入与当前版本内容相同时版本号可能不增加。 |
| updated_at | 写入时间，ISO 8601 格式。 |
