接口介绍
本接口（
/v3/atomic/count）用于统计 L1 原子记忆的数量，仅返回满足条件的记忆总数，不返回记忆列表本身，适合面板展示、用量统计等场景。功能说明如下：统计作用域：
team_id / user_id / agent_id 三个身份维度确定统计范围。在严格模式下三者必填；在非严格模式下未传入的字段取固定值 default，统计范围为该默认作用域下的笔记数量。task_id 可选，传入后进一步收敛到指定任务。过滤条件：
type 语义与 /v3/atomic/query 一致；time_start / time_end 参数当前已可传入，但服务端未校验 ISO 8601 格式，非法时间字符串也会通过参数校验，传时间范围暂不会影响统计结果。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/atomic/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/atomic/count \\-d '{"user_id":"usr-456","agent_id":"agt-xyz789","type":"episodic"}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
team_id | 否 | 团队 ID。 | 数据类型：String。 |
user_id | 否 | 用户 ID。 | 数据类型：String。 |
agent_id | 否 | Agent ID（全局唯一）。 | 数据类型：String。 |
task_id | 否 | Task ID。 | 数据类型：String。 |
type | 否 | 按记忆类型过滤统计。 | 数据类型：String。 可选值： episodic：情节记忆persona：人设记忆instruction：指令记忆不传则统计全部类型。 |
time_start | 否 | 统计时间范围起点（暂未生效）。 | 数据类型：String。 当前可传入但服务端未校验 ISO 8601 格式，非法时间字符串也会通过参数校验，传时间范围暂不会影响统计结果。 |
time_end | 否 | 统计时间范围终点（暂未生效）。 | 数据类型：String。 当前可传入但服务端未校验 ISO 8601 格式，非法时间字符串也会通过参数校验，传时间范围暂不会影响统计结果。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"total":42}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | total | 满足条件的原子记忆总数。 |
