方法介绍
count_scenario 用于统计指定路径前缀下 L2 场景记忆文件的数量，仅返回满足条件的文件总数，不返回文件列表本身，适合面板展示、用量统计等场景。功能说明如下：统计作用域：当前 L2 场景记忆实际按
team_id + agent_id 组合确定统计范围，user_id 和 task_id 不参与筛选。构造 MemoryClient 时 team_id 和 agent_id 为有效必填项，user_id 可选但当前不影响统计结果。过滤条件：与
list_scenarios 使用相同的 path_prefix 路径前缀过滤逻辑。导入
from tencentdb_agent_memory.v3 import MemoryClient
使用示例
from tencentdb_agent_memory.v3 import MemoryClientwith MemoryClient(endpoint="https://memory.tdai.tencentyun.com",api_key="sk-xxxxxxxxxxxxxxxx",service_id="tdai-mem-xxxxxxxx",team_id="team-abc123",agent_id="agt-xyz789",user_id="usr-456",) as client:result = client.count_scenario(path_prefix="product-review/",)print(f"共 {result['total']} 个文件")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
path_prefix | str | 否 | 路径前缀，不传则统计全部文件 |
响应示例
{"total": 12}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
total | int | 满足条件的文件总数 |
错误码
错误码 | 触发场景 | 处理建议 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |
