方法介绍
read_scenario 用于读取指定路径下 L2 场景记忆文件的完整内容。功能说明如下：读取方式：传入文件路径
path 即可获取文件内容及其元信息，始终返回当前最新版本。注意：服务端当前返回的 content 包含文件内部的 META 信息头（YAML front matter）和正文，并非仅返回正文。如需纯正文展示请在客户端侧过滤。导入
from tencentdb_agent_memory.v3 import MemoryClient
使用示例
读取最新版本
from tencentdb_agent_memory.v3 import MemoryClientwith MemoryClient(endpoint="https://memory.tdai.tencentyun.com",api_key="sk-xxxxxxxxxxxxxxxx",service_id="tdai-mem-xxxxxxxx",team_id="team-abc123",agent_id="agt-xyz789",user_id="usr-456",) as client:result = client.read_scenario(path="product-review/2025-q4-review",)print(f"版本: {result['version']}, 大小: {result['size_bytes']}B")print(result["content"])
请求参数
参数名 | 类型 | 必填 | 描述说明 |
path | str | 是 | 文件路径，相对路径不带前导 /（如 product-review/2025-q4-review），服务端会拒绝以 / 开头的路径并返回 400 |
响应示例
{"name": "2025-q4-review","path": "product-review/2025-q4-review","version": 5,"content": "---\\ntitle: 产品评审总结\\nauthor: agent-xyz789\\n---\\n## 2025 Q4 产品评审总结\\n\\n### 关键结论\\n- 功能迭代方向确认...","updated_at": "2026-07-20T18:00:00Z","size_bytes": 4096}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
name | str | 文件名 |
path | str | 文件完整路径 |
version | int | 当前读取的版本号，从 0 开始递增。注意： version 参数当前会被服务端忽略，始终返回最新版本 |
content | str | 文件内容 |
updated_at | str | 最近更新时间，ISO 8601 格式 |
size_bytes | int | 文件大小，单位字节 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | path 为空 | 检查 path 参数 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
404 | 文件不存在或无权访问 | 检查路径是否正确 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |
