一、接口介绍
·单文件约束：每个 (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。 |