接口介绍
本接口(
/v3/scenario/count)用于统计指定路径前缀下 L2 场景文件的数量,仅返回满足条件的文件总数,不返回文件列表本身。功能说明如下:统计作用域:当前 L2 场景记忆实际按
team_id + agent_id 组合确定统计范围,user_id 和 task_id 不参与当前统计范围过滤(user_id 仅在未提供 team_id 的兼容模式下作为过滤维度)。V3 SDK 构造时必须提供 team_id / user_id / agent_id,SDK 会自动注入请求。过滤条件:与
/v3/scenario/ls 使用相同的过滤条件。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/scenario/count
使用示例
curl -i -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 '{"team_id":"team-abc123","user_id":"usr-456","agent_id":"agt-xyz789","path_prefix":"work/"}'
SDK 调用时,
team_id / user_id / agent_id 在 V3 客户端构造时必填,可通过 with_isolation() 调整,SDK 会自动注入 HTTP 请求;HTTP 是否强制校验取决于服务端严格隔离配置,可通过请求体或对应请求头提供。请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
team_id | 是 | 团队 ID。 | 数据类型:String。 与 agent_id 组合确定统计作用域。 |
agent_id | 是 | Team ID + Agent ID 全局唯一。 | 数据类型:String。 与 team_id 组合确定统计作用域。 |
user_id | 是 | 用户 ID(V3 SDK 构造必填;提供 team_id 时不参与筛选)。 | 数据类型:String。 V3 SDK 自动注入;提供 team_id 时不影响当前统计范围。 |
task_id | 否 | Task ID(当前不参与筛选)。 | 数据类型:String。 当前可传入但不会影响统计结果。 |
path_prefix | 否 | 场景文件路径前缀。 | 数据类型:String。 格式:相对路径,不带前导 /(如 work/),服务端按相对路径前缀处理。为空则统计当前作用域下的所有文件。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"total":15}}
响应参数说明
参数名(一级) | 参数名(二级) | 参数含义 |
data | total | 满足条件的场景文件总数。 |