帮你快速理解、总结文档立即下载

统计场景文件数量

最近更新时间:2026-11-06 17:47:00
本文档已由 AI 辅助审校
我的收藏

接口介绍

本接口(/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
}
}

响应参数说明

请求失败时,请检查 HTTP 状态码及响应中的 code、message,并保留 request_id 用于排查。错误含义与处理建议见 错误码。
参数名(一级)
参数名(二级)
参数含义
data
total
满足条件的场景文件总数。