一、接口介绍
·正文写入：通过 content 传入本次写入的全量正文（必填，整体覆盖旧内容，不做 diff / merge）。
·路径固定：核心记忆文件路径由系统固定（Agent 维度单体），无需传入 path。
·创建与更新统一：尚未沉淀出核心记忆时即创建，已存在时整体覆盖旧内容；本接口是核心记忆唯一的写入接口。
二、Method 与 URL
POST https://{服务访问地址}/v2/core/write
三、使用示例
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/core/write \\ -d '{ "content": "# Agent 核心记忆\\n\\n## 用户画像\\n\\n- 偏好深度文化体验\\n- 5 月出行，预算 1.5 万元\\n- 关西线路爱好者\\n\\n## 历史交付\\n\\n- 2026Q1：项目 A、项目 B 已完成\\n- 2026Q2：项目 C 进行中\\n" }'
注意：说明：
注意：鉴权说明：所有接口都必须在请求头中携带 Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>，否则将返回鉴权失败。
四、请求参数
| 参数名 | 类型 | 必填 | 描述说明 |
| content | str | 是 | 本次写入的全量正文内容。注意：写入机制：该操作为破坏性覆盖。系统会直接用本次传入的文本替换掉旧内容，底层不会对新旧内容进行任何差异比对（diff）或自动合并（merge）。请务必在客户端或前端组装好最完整的最终文本再发起请求，否则未包含在其中的旧数据将会永久丢失。 |
五、响应示例
{ "code": 0, "message": "ok", "request_id": "req-7fd3b2dd", "data": { "updated_at": "2026-04-21T08:30:15Z" }}
| 字段 | 类型 | 说明 |
| updated_at | str | 系统最新的更新时间戳（ISO 8601 格式）。由于该接口不做 diff / merge，此时间代表旧内容已被完全替换，新内容正式生效的时间点。 |