接口介绍
本接口（
/v3/scenario/count）用于统计指定路径前缀下 L2 场景文件的数量，仅返回满足条件的文件总数，不返回文件列表本身。功能说明如下：统计作用域：当前 L2 场景记忆实际按
team_id + agent_id 组合确定统计范围，user_id 和 task_id 不参与筛选。全不传并不会统计整个实例下的所有文件。后续版本将通过 IdFields 机制统一管理多维度作用域。过滤条件：与
/v3/scenario/ls 使用相同的过滤条件。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/scenario/count
使用示例
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/count \\-d '{"user_id":"usr-456","agent_id":"agt-xyz789","path_prefix":"work/"}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
team_id | 是 | 团队 ID。 | 数据类型：String。 与 agent_id 组合确定统计作用域。 |
agent_id | 是 | Agent ID（全局唯一）。 | 数据类型：String。 与 team_id 组合确定统计作用域。 |
user_id | 否 | 用户 ID（当前不参与筛选）。 | 数据类型：String。 当前可传入但不会影响统计结果，为后续版本预留。 |
task_id | 否 | Task ID（当前不参与筛选）。 | 数据类型：String。 当前可传入但不会影响统计结果，为后续版本预留。 |
path_prefix | 否 | 场景文件路径前缀。 | 数据类型：String。 格式：相对路径，不带前导 /（如 work/），服务端按相对路径前缀处理。为空则统计当前作用域下的所有文件。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"total":15}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | total | 满足条件的场景文件总数。 |
