接口介绍
本接口(
/v3/core/count)用于统计当前作用域下 L3 核心记忆文件的数量。功能说明如下:单文件约束:每个
(team_id, agent_id) 至多一份核心记忆文件,因此统计结果始终为 0 或 1。统计作用域:当前服务端要求传入具体的
agent_id 和 user_id 确定统计范围,仅传 team_id 或全不传均无法返回团队级或实例级汇总统计。后续版本将通过 IdFields 机制支持更灵活的多粒度统计。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/core/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/core/count \\-d '{"user_id":"usr-456","agent_id":"agt-xyz789"}'
鉴权说明:
所有接口都必须在请求头中携带
Authorization: Bearer <API Key> 与 x-tdai-service-id: <实例 ID>,否则将返回鉴权失败。请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
team_id | 是 | 团队 ID。 | 数据类型:String。 |
agent_id | 是 | Agent ID(全局唯一)。 | 数据类型:String。 |
user_id | 是 | 用户 ID。 | 数据类型:String。 当前服务端要求必须传入,否则无法完成统计。 |
task_id | 否 | Task ID。 | 数据类型:String。 当前不参与 L3 Core 统计筛选,为后续版本预留。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"total":1}}
响应参数说明
参数名(一级) | 参数名(二级) | 参数含义 |
data | total | 当前作用域下已存在的核心记忆文件总数,每个 (team_id, agent_id) 至多 1 份,因此结果始终为 0 或 1。 |