腾讯云数据库 AI 服务 写入核心记忆

一、接口介绍

·写入方式：每个 (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>，否则将返回鉴权失败。

四、请求参数

五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "version":6, "updated_at":"2026-07-22T10:00:00Z" }}

六、响应参数说明