接口介绍
本接口（
/core/write）用于写入或全量覆盖 Agent 维度的核心记忆。核心记忆是 Agent 维度的单体记忆快照，路径由系统固定，本入口同时承担"写入即创建"与"全量覆盖更新"两种语义：正文写入：通过
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，此时间代表旧内容已被完全替换，新内容正式生效的时间点。 |
