返回技能元数据与最新版本号。响应结构与创建技能一致。仅 active 状态可挂载到智能体,挂载时不能锁定到 latest,必须指定具体版本号。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
GET /skills/{skill_id}
请求示例
响应示例
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 技能 ID,格式 skill_xxx |
type | string | 固定为 skill |
name / description | string | 从 zip 包内 SKILL.md 解析得到 |
source | string | 来源:customer(自建) / official(阿里云百炼官方) |
status | string | 扫描状态:checking / active / rejected / deleted,仅 active 可挂载 |
latest_version | string | 最新版本号,挂载到智能体时不能锁定到 latest,必须指定具体版本号 |
created_at / updated_at | string | 创建 / 最近更新时间,ISO 8601 |
request_id | string | 本次请求的唯一标识 |