接口介绍
本接口（
/v3/core/read）用于读取当前作用域下的 L3 核心记忆文件。功能说明如下：记忆定位：核心记忆是 Memory 四层架构中最顶层、最稳定的记忆形态，由 L2 场景文件持续沉淀浓缩而成，代表 Agent 对该用户/团队长期不变的认知结论。
存储模式：以单文件模式存储，每个
(team_id, agent_id) 维度至多保留一份核心记忆文件，每次通过 /v3/core/write 写入时覆盖当前内容、版本号递增。不存在时的表现：当前作用域下尚无核心记忆时，服务端返回成功响应（
code: 0）但 content 为 null，不会返回资源不存在（404）错误。客户端需根据 content 是否为 null 判断核心记忆是否已创建。版本选择：
version 参数当前可传入但会被服务端忽略，接口始终返回最新内容。历史版本读取及版本不存在时返回 404 的逻辑尚未实现，后续版本将支持。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/core/read
使用示例
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/read \\-d '{"user_id":"usr-456","agent_id":"agt-xyz789"}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
team_id | 否 | 团队 ID。 | 数据类型：String。 |
user_id | 否 | 用户 ID。 | 数据类型：String。 |
agent_id | 否 | Agent ID（全局唯一）。 | 数据类型：String。 |
task_id | 否 | Task ID。 | 数据类型：String。 |
version | 否 | 指定返回的历史版本号（暂未生效）。 | 数据类型：Number。 当前可传入但会被服务端忽略，接口始终返回最新内容。历史版本读取功能将在后续版本支持。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"version":5,"content":"## 用户画像\\n- 角色：产品负责人，偏好简洁、结果导向的沟通风格\\n- 技术栈：精通分布式缓存（Redis/Memcached），日常使用 Python/Go\\n- 决策风格：数据驱动，习惯在上午处理深度工作\\n\\n## 关键偏好\\n- 会议室：偏好 3F-星空厅\\n- 沟通：不喜欢冗长解释，期望结论先行","created_at":"2026-07-01T10:00:00Z","updated_at":"2026-07-22T10:00:00Z"}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | version | 核心记忆文件当前版本号，数值类型，每次写入递增。 |
| content | 核心记忆的完整文本内容。当前作用域下尚无核心记忆时返回 null，客户端应据此判断是否需调用 write 创建。 |
| created_at | 首次创建时间，ISO 8601 格式。 |
| updated_at | 最后更新时间，ISO 8601 格式。 |
