Skill

更新时间:
复制 MD 格式

技能以 zip 包封装工具组合与文档。上传后经安全扫描方可挂载到智能体,挂载时锁定具体版本号。

扫描状态

新建技能或上传新版本后进入安全扫描,status 状态流转如下:

状态

含义

checking

扫描中,暂不可挂载

active

扫描通过,可挂载到智能体

rejected

命中安全风险,不可挂载;版本详情中 additional_properties.error_info 给出按文件路径列出的问题

deleted

技能已删除

挂载在智能体上完成,详见 Agent 的 skills 字段。挂载时必须指定具体的 version(不支持 latest),后续上传新版本不影响已挂载的智能体。

技能操作

操作

端点

说明

创建 Skill

POST /skills

用已上传的 zip 包 file_id 创建技能

查询 Skill

GET /skills/{skill_id}

获取技能元数据与最新版本号

列出 Skill

GET /skills

分页列出技能,支持按 source 过滤自建/官方

删除 Skill

DELETE /skills/{skill_id}

删除技能及全部版本;已挂载旧版本的智能体不受影响

版本操作

操作

端点

说明

上传 Skill 新版本

POST /skills/{skill_id}/versions

用新的 zip 包 file_id 上传新版本;已挂载旧版本不受影响

列出 Skill 版本

GET /skills/{skill_id}/versions

分页列出该技能的全部版本,按版本号倒序

查询 Skill 版本

GET /skills/{skill_id}/versions/{version}

查询指定版本的元数据与扫描状态

下载 Skill 包

GET /skills/{skill_id}/versions/{version}/content

返回 OSS 预签名 URL(2 小时有效),用于下载 zip 包