上传 Skill 新版本

为已有技能上传新版本的 zip 包。请求体仅含 file_id，版本号由服务端生成；新版本同样需经过安全扫描，仅 active 可挂载；已挂载旧版本的智能体不受影响。

前提

已完成 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"}'

sv = client.skills.versions.create("skill_xxx", file_id="file_xxx")
print(sv.version)

SkillVersion sv = client.skills().createVersion("skill_xxx",
    SkillCreateParam.builder().fileId("file_xxx").build());
System.out.println(sv.getVersion());

响应示例

{
  "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"
}

响应字段