帮你快速理解、总结文档立即下载

统计核心记忆数量

最近更新时间:2026-10-27 22:06:02
我的收藏

接口介绍

本接口(/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。