一、接口介绍
·过滤条件：支持按 team_id、agent_id、name 等字段筛选 Skill。
·分页查询：通过 limit 和 offset 参数控制分页。
·返回结构：返回符合条件的 Skill 列表及总数。
二、Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/skill/list
三、使用示例
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/skill/list \\ -d '{ "filters":{"team_id":"team-abc123"}, "limit":20, "offset":0 }'
四、Body 参数
| 参数 | 是否必选 | 参数含义 | 配置方法及要求 |
| filters | 否 | 过滤条件。 | 数据类型：Object。支持按 team_id、agent_id、name 等字段筛选。 |
| limit | 否 | 每页返回数量。 | 数据类型：Integer。默认值由服务端决定。 |
| offset | 否 | 分页偏移量，从0开始。 | 数据类型：Integer。 |
| team_id | 否 | 团队 ID。 | 数据类型：String。 |
| agent_id | 否 | Agent ID。 | 数据类型：String。 |
| user_id | 否 | 用户 ID。 | 数据类型：String。 |
| task_id | 否 | 任务 ID。 | 数据类型：String。 |
五、响应示例
{ "code":0, "message":"ok", "request_id":"req-def456", "data":{ "items":[ { "skill_id":"skill-abc123", "name":"python-tips", "version":3, "created_at":"2026-08-01T10:00:00Z", "updated_at":"2026-08-15T14:30:00Z" } ], "total":42 }}
六、响应参数说明
| 参数名（一级） | 参数名（二级） | 参数含义 |
| data | items | Skill 列表。 |
| | items[].skill_id | Skill ID。 |
| | items[].name | Skill 名称。 |
| | items[].version | 当前版本号。 |
| | items[].created_at | 创建时间（ISO 8601）。 |
| | items[].updated_at | 最后更新时间（ISO 8601）。 |
| | total | 符合条件的总数。 |
七、错误码
| HTTP 状态码 | 错误信息 | 说明 |
| 401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
| 500 | Internal error | 服务内部错误，可有限重试。 |