接口介绍
本接口(
/v3/core/count)用于统计当前作用域下 L3 核心记忆文件的数量。功能说明如下:单文件约束:每个
(team_id, agent_id) 至多一份核心记忆文件,因此统计结果始终为 0 或 1。统计作用域:当前作用域下按
team_id 和 agent_id 确定文件范围;user_id 是 V3 SDK 必填的隔离字段,在提供 team_id 时不参与 L3 文件过滤。SDK 在客户端构造或 with_isolation() 中配置三元组并自动注入 HTTP 请求;count_core() 不需要也不接受手填这三个参数。HTTP 是否强制校验取决于服务端严格隔离配置。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/core/count
使用示例
curl -i -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 '{"team_id":"team-abc123","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(Team ID 下唯一)。 | 数据类型:String。 |
user_id | 是 | 用户 ID。 | 数据类型:String。 V3 SDK 构造时必填并自动注入 HTTP 请求;提供 team_id 时不参与 L3 文件范围过滤。 |
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。 |