一、接口介绍
·目标定位：通过 path 指定场景记忆的完整路径（必填），例如 工作/交付物/2026Q1.md。
·路径承载：path 由 JSON body 承载，无需 encodeURIComponent，可直接包含中文、深层目录与特殊字符。
二、Method 与 URL
POST https://{服务访问地址}/v2/scenario/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/scenario/read \\ -d '{ "path": "工作/交付物/2026Q1.md" }'
注意：说明：
注意：鉴权说明：所有接口都必须在请求头中携带 Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>，否则将返回鉴权失败。
四、请求参数
| 参数名 | 类型 | 必填 | 描述说明 |
| path | str | 是 | 目标记忆文件的完整路径。格式要求：必须传入包含目录和文件扩展名的全路径（区分大小写，不支持模糊匹配或相对路径）。正确示例："工作/交付物/2026Q1.md"。说明：请勿传入仅含目录的路径（如 "工作/交付物/"），否则系统将无法定位到具体文件。 |
五、响应示例
{ "code": 0, "message": "ok", "request_id": "req-7fd3b2dd", "data": { "path": "工作/交付物/2026Q1.md", "content": "# 2026Q1 交付物清单\\n\\n- 项目 A：4 月 15 日交付\\n- 项目 B：4 月 28 日交付\\n\\n## 备注\\n\\n本季度交付节奏紧凑，需要提前准备资源。", "summary": "2026 年第一季度交付物归档", "created_at": "2026-03-31T18:00:00Z", "updated_at": "2026-04-21T08:30:15Z" }}
六、响应参数说明
| 字段名 | 类型 | 说明 |
| path | str | 场景记忆文件的完整存储路径。作为全局唯一标识，例如 "工作/交付物/2026Q1.md"。包含完整的目录层级与文件拓展名。 |
| content | str | 场景记忆的全量原始正文。通常为 Markdown 格式的字符串。存储该记忆节点所保存的详细文本数据。 |
| summary | str | 由大模型或系统后台自动生成的记忆摘要。对 content 长文本的高度提炼与概括，用于在非详情（如列表、检索预览）场景下提供快速业务认知。 |
| created_at | str | 该场景记忆文件的首次创建时间戳。采用 ISO 8601 标准格式（如 "2026-04-01T09:00:00+08:00"），一旦生成，在后续的覆盖写入中保持不变。 |
| updated_at | str | 该场景记忆文件的最后修改时间戳。采用 ISO 8601 标准格式。任何对 content 的覆盖写入或系统的摘要更新都会触发此时间戳刷新。 |
| trace_id | str | 请求追踪 ID。用于全链路日志排查。该值与 HTTP 响应头中的 x-trace-id 保持一致，用于审计和定位单次读取操作。 |