读取核心记忆

最近更新时间:2026-05-26 21:12:01

我的收藏

接口介绍

本接口(/core/read)用于读取 Agent 维度的核心记忆 Markdown 文件全文。核心记忆是 Agent 维度的单体记忆快照,路径由系统固定,无需指定目标:
路径固定:核心记忆文件路径由系统固定(Agent 维度单体),既无需 list 也无需传入 path
请求体形态:与场景记忆一致,统一为 POST + JSON body;当前一期请求体传空对象 {} 即可。
说明:
尚未沉淀出核心记忆时返回业务错误码 404,可通过 写入或覆盖核心记忆 写入即创建。

Method 与 URL

POST https://{服务访问地址}/v2/core/read

使用示例

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/read \\
-d '{}'
说明:
鉴权说明:所有接口都必须在请求头中携带 Authorization: Bearer <API Key>x-tdai-service-id: <Service_ID>,否则将返回鉴权失败。

请求参数

不接收业务请求参数,请求体传空对象 {} 即可。

响应示例

{
"code": 0,
"message": "ok",
"request_id": "req-7fd3b2dd",
"data": {
"content": "# Agent 核心记忆\\n\\n## 用户画像\\n\\n- 偏好深度文化体验\\n- 5 月出行,预算 1.5 万元\\n- 关西线路爱好者\\n\\n## 历史交付\\n\\n- 2026Q1:项目 A、项目 B 已完成\\n",
"created_at": "2026-04-01T08:00:00Z",
"updated_at": "2026-04-21T08:30:15Z"
}
}
字段
类型
说明
content
str
成功写入的完整 Markdown 文本。
created_at / updated_at
str
核心记忆文件的首次创建时间(created_at)与本次最新同步时间(updated_at)。