接口介绍
本接口（
/v3/skill/listing）用于为 Agent 生成可用 Skill 的 XML 格式描述块。功能说明如下：用途：生成的 XML 块可直接嵌入 Agent prompt 中的
<available_skills> 区块。筛选：通过
query 参数检索和筛选 Skill，仅将相关的 Skill 渲染到描述块中。字符预算：通过
char_budget 控制返回的 XML 块最大字符数。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/skill/listing
使用示例
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/listing \\-d '{"query":"coding helper","char_budget":2000}'
请求参数
Body 参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
query | 否 | 用于检索和筛选 Skill 的查询文本。 | 数据类型：String。 |
char_budget | 否 | 返回的 XML 块最大字符数。 | 数据类型：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-pqr678","data":{"block":"<available_skills>\\n<skill>\\n<name>python-tips</name>\\n<description>Python coding tips</description>\\n</skill>\\n</available_skills>","count":5,"truncated":false}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | block | XML 格式的 Skill 描述块，可直接嵌入 Agent prompt。 |
| count | 返回的 Skill 数量。 |
| truncated | 是否因字符预算限制而截断。 |
错误码
HTTP 状态码 | 错误信息 | 说明 |
401 | Missing or invalid Authorization header | Bearer API Key 缺失或格式不正确。 |
500 | Internal error | 服务内部错误，可有限重试。 |
