接口介绍
本接口（
/scenario/read）用于按完整路径读取一份场景记忆 Markdown 文件全文。通过 path 指定目标，系统返回该场景记忆的原文与时间戳：目标定位：通过
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 保持一致，用于审计和定位单次读取操作。 |
