上传 Skill 新版本 - 阿里云百炼

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。上传新版本前需先用File上传 zip 包获得 file_id。

接口

POST /skills/{skill_id}/versions 请求体仅含 file_id。版本号由服务端生成；新版本同样需经过安全扫描；已挂载旧版本的智能体不受影响。

请求示例

curl -X POST "$AGENTSTUDIO_URL/skills/skill_xxx/versions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_id": "file_xxx"}'

响应示例

{
  "id": "skillver_xxx",
  "skill_id": "skill_xxx",
  "type": "skill_version",
  "name": "pdf3.0",
  "description": "从 SKILL.md 解析的描述",
  "version": "1.1",
  "status": "checking",
  "created_at": "2026-06-15T08:23:11.456+00:00",
  "updated_at": "2026-06-15T08:23:11.456+00:00"
}

响应字段

字段	类型	说明
`id`	string	版本 ID，格式 `skillver_xxx`
`skill_id`	string	所属技能 ID
`type`	string	固定为 `skill_version`
`name` / `description`	string	从该版本 zip 包内 `SKILL.md` 解析得到
`version`	string	版本号，由服务端生成
`status`	string	扫描状态：`checking` / `active` / `rejected`，仅 `active` 可挂载
`created_at` / `updated_at`	string	创建/最近更新时间，ISO 8601
`additional_properties`	object	仅 `status=rejected` 时返回，含 `error_info`：按 zip 包内文件路径列出的安全审查问题

​前提

​接口

​请求示例

​响应示例

​响应字段

前提

接口

请求示例

响应示例

响应字段