上传 ZIP 包创建自定义 Skill,初始版本为 1.0。
接口
POST /api/v1/skills
使用 multipart/form-data 上传 ZIP 包,创建自定义 Skill。创建成功后初始版本为 1.0。
此接口只新增 Skill,不更新已有 Skill。为已有 Skill 上传新版本,使用创建版本。
请求参数
| 表单字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | file | 是 | Skill 包,必须为 .zip,大小不超过 50MB |
| display_name | string | 否 | 展示名称;不传或为空白时取 SKILL.md 的 name |
| display_description | string | 否 | 展示描述;不传或为空白时取 SKILL.md 的 description |
SKILL.md,Front Matter 中须包含 name 和 description。
响应
返回 SkillDTO。新建后 latest_version 为 1.0。提交安全扫描后 status 为 checking;未产生扫描任务时为 active。
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | Skill 唯一标识 |
| display_name | string | 展示名称 |
| display_description | string | 展示描述 |
| source | string | 固定为 customer |
| status | string | checking 或 active |
| latest_version | string | 最新版本号 |
| classification | string / null | 固定为 null,自定义 Skill 无分类 |
| meta_info | object / null | 固定为 null,自定义 Skill 无元信息 |
| created_at | string | 创建时间 |
| updated_at | string | 更新时间 |
示例
错误
| HTTP 状态码 | error_code | 说明 |
|---|---|---|
| 401 | WORKSPACE_ID_ILLEGAL | 身份信息缺失或无效 |
| 400 | SKILL_FILE_IS_NULL | 未上传 file 或文件为空 |
| 400 | SKILL_FILE_FORMATER_ERROR | 文件扩展名不是 .zip,或文件头不是 ZIP 格式 |
| 400 | SKILL_PACKAGE_TOO_LARGE | ZIP 包超过 50MB |
| 400 | INVALID_PARAMETER | multipart 请求格式错误 |
| 500 | SKILL_FILE_FORMATER_ERROR | 缺少 SKILL.md,或 Front Matter 缺少 name 或 description |
| 500 | SKILL_NAME_OFFICIAL_DUPLICATE | SKILL.md 的 name 与官方 Skill 重名 |
| 500 | SKILL_NAME_CUSTOMER_DUPLICATE | SKILL.md 的 name 与当前空间的自定义 Skill 重名 |
| 500 | SKILL_PACKAGE_TOO_LARGE | ZIP 解压后累计大小超过 100MB |