腾讯云数据库 AI 服务列出场景文件

一、接口介绍

·组织模型：场景记忆是 L2 层的结构化记忆，以文件系统模型组织。

·列出范围：通过 path_prefix 指定目录范围，返回其下所有文件与子目录的列表。

注意：说明：

注意：路径约定：path_prefix 采用相对路径格式，建议统一写成 work/… 而不带开头的 /，避免不同存储后端得到不同结果；path_prefix 为空或不传表示列出根目录下的所有场景文件。

二、Method 与 URL

POST https://memory.tdai.tencentyun.com/v3/scenario/ls

三、使用示例

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/scenario/ls \\ -d '{ "team_id":"team-abc123", "user_id":"usr-456", "agent_id":"agt-xyz789", "path_prefix":"work/projects" }'

四、请求参数

参数	是否必选	参数含义	配置方法及要求
team_id	否	团队 ID。	数据类型：String。
user_id	否	用户 ID。	数据类型：String。
agent_id	否	Agent ID（全局唯一）。	数据类型：String。
task_id	否	Task ID。	数据类型：String。
path_prefix	否	场景文件路径前缀。	数据类型：String。格式：相对路径，建议不带开头的 /（如 work/projects），避免不同存储后端解析不一致。为空或不传则列出根目录下所有文件。

五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "entries":[ { "path":"work/projects/product-review/", "version":0, "created_at":"2026-07-20T08:00:00Z", "updated_at":"2026-07-22T10:00:00Z" }, { "path":"work/projects/weekly-standup.md", "version":3, "created_at":"2026-07-10T09:00:00Z", "updated_at":"2026-07-21T09:00:00Z" } ], "total":2 }}

六、响应参数说明

参数名（一级）	参数名（二级）	参数含义
data	entries	文件与目录列表。
	entries[].path	文件或目录的完整路径；目录以 / 结尾。
	entries[].version	版本号，数值类型，从 0 开始递增；文件为当前版本（如 3），目录固定为 0。
	entries[].created_at	创建时间，ISO 8601 格式。
	entries[].updated_at	最后更新时间，ISO 8601 格式。
	total	满足条件的条目总数。

腾讯云数据库 AI 服务 列出场景文件