方法介绍
list_scenarios 用于列出指定路径前缀下的 L2 场景（Scenario）记忆文件清单。功能说明如下：组织模型：场景记忆是 L2 层的结构化记忆，以文件系统模型组织。
列出范围：通过
path_prefix 指定目录范围，返回其下所有文件与子目录的清单。返回内容：仅返回文件元信息（名称、路径、版本、大小等），不返回文件内容；如需读取内容请使用
read_scenario。导入
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.list_scenarios(path_prefix="product-review/",)for f in result["files"]:print(f"[{f['version']}] {f['path']} ({f['size_bytes']}B, {f['updated_at']})")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
path_prefix | str | 否 | 路径前缀，建议不带开头的 /（如 product-review/），不传则列出根路径下的全部文件 |
响应示例
{"files": [{"name": "2025-q4-review","path": "product-review/2025-q4-review","version": 5,"updated_at": "2026-07-20T18:00:00Z","size_bytes": 4096},{"name": "2026-q1-planning","path": "product-review/2026-q1-planning","version": 2,"updated_at": "2026-07-15T10:30:00Z","size_bytes": 2048}]}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
files | List[Dict] | 文件元信息列表 |
files[].name | str | 文件名（路径最后一段） |
files[].path | str | 文件完整路径 |
files[].version | int | 当前版本号，从 0 开始递增 |
files[].updated_at | str | 最近更新时间，ISO 8601 格式 |
files[].size_bytes | int | 文件大小，单位字节 |
错误码
错误码 | 触发场景 | 处理建议 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |
