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

统计核心记忆数量

最近更新时间:2026-07-28 10:20:00

我的收藏

接口介绍

本接口(/v3/core/count)用于统计当前作用域下 L3 核心记忆文件的数量。功能说明如下:
单文件约束:每个 (team_id, agent_id) 至多一份核心记忆文件,因此统计结果始终为 01
统计作用域:当前服务端要求传入具体的 agent_iduser_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。