一、接口介绍
·统计作用域: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 | 满足条件的原子记忆总数。 |