文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯云数据库 AI 服务>Memory 应用指南>开发者参考>HTTP>场景记忆>列出场景记忆

列出场景记忆

最近更新时间：2026-05-26 21:12:01

我的收藏

本页目录：

接口介绍

本接口（/scenario/list）用于按目录前缀列出场景记忆的目录树。通过 path_prefix 指定列举范围，系统一次性返回该范围内的全部节点：
列举范围：通过 path_prefix 指定目录前缀（可选）；不传或传空字符串 "" 时从根目录开始列举。
递归返回：匹配前缀的范围内递归返回所有节点（文件与目录），不提供"仅列当前层级"的开关，也不提供分页。
节点区分：返回项以 path 末尾是否带 / 区分——目录以 / 结尾，文件不带；文件项不返回正文，如需读取请用 POST /scenario/read。

Method 与 URL

POST https://{服务访问地址}/v2/scenario/list

使用示例

示例 1：列出根目录全部节点

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/list \\
  -d '{}'

示例 2：按前缀过滤

curl -i -k -X POST \\
  -H 'Content-Type: application/json' \\
  -H 'Authorization: Bearer ******************************' \\
  -H "x-tdai-service-id: tdai-mem-8i8t****" \\
  https://memory.tdai.tencentyun.com/v2/scenario/list \\
  -d '{
    "path_prefix": "工作/"
  }'
说明：
鉴权说明：所有接口都必须在请求头中携带 Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>，否则将返回鉴权失败。

请求参数

参数名
类型
必填
默认值
描述说明
path_prefix
str
否
""
路径前缀（虚拟目录过滤）。用于筛选特定目录下的文件。其传值规则如下：
按目录筛选：传入特定的路径前缀（如 "documents/2026/"），则只列举该目录下的文件。
列举全部：不传此参数、或显式传入空字符串 ""、None，系统将默认从根目录（最顶层）开始列举所有文件。

响应示例

{
    "code": 0,
    "message": "ok",
    "request_id": "req-7fd3b2dd",
    "data": {
        "entries": [
            {
                "path": "工作/",
                "created_at": "2026-04-01T08:00:00Z",
                "updated_at": "2026-04-21T08:30:15Z"
            },
            {
                "path": "工作/交付物/",
                "created_at": "2026-04-01T08:00:00Z",
                "updated_at": "2026-04-21T08:30:15Z"
            },
            {
                "path": "工作/交付物/2026Q1.md",
                "created_at": "2026-03-31T18:00:00Z",
                "updated_at": "2026-04-21T08:30:15Z"
            }
        ],
        "total": 3
    }
}
字段名
类型
说明
data.entries
List
列举出的场景记忆条目列表。每项包含以下完整元数据字段：
path (str): 场景记忆的完整路径。
created_at (str): 该节点的首次创建时间戳（ISO 8601 格式）。
updated_at (str): 该节点的最后修改时间戳（ISO 8601 格式）。
data.total
int
满足前缀过滤条件的条目总数。
该值为全量数据计数，不受当前单页请求的截断限制。若当前前缀下没有任何数据，则 entries 返回空数组 []，total 返回 0。
中国站