腾讯云数据库 AI 服务 统计原子记忆数量

本接口(/v3/atomic/count)用于统计 L1 原子记忆的数量,仅返回满足条件的记忆总数,不返回记忆列表本身,适合面板展示、用量统计等场景。功能说明如下。

相关产品
腾讯云数据库 AI 服务 产品页,含版本规格、价格与购买入口。

一、接口介绍

·统计作用域: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 满足条件的原子记忆总数。
赞 (0)
上一篇 4天前
下一篇 4天前