一、接口介绍
·统计作用域：当前 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
三、使用示例
接入准备：获取实例的服务访问地址、API Key 和实例 ID，替换示例中的域名、Authorization 和 x-tdai-service-id。team_id、agent_id、user_id 为业务身份标识，请使用写入目标记忆时的值。
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 | 满足条件的场景文件总数。 |