Skip to main content

Skill

技能 API 提供技能的创建、查询、版本管理与删除操作。

创建 Skill

POST /skills 上传技能包前需先通过 File API 上传 zip 文件获得 file_id。

请求体

字段必填类型说明
file_id是string已上传的 zip 文件 ID

请求示例

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

查询 Skill

GET /skills/{skill_id}

列出 Skill

GET /skills 分页列出工作空间下的技能。

删除 Skill

DELETE /skills/{skill_id} 硬删除，不可恢复。 
curl -X DELETE "$AGENTSTUDIO_URL/skills/skill_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

上传 Skill 新版本

POST /skills/{skill_id}/versions 版本号由服务端自动生成。

请求示例

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

查询 Skill 版本

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

列出 Skill 版本

GET /skills/{skill_id}/versions

下载 Skill 包

GET /skills/{skill_id}/versions/{version}/download 返回 zip 文件的下载 URL。
概览
构建 Agent
配置环境
委派任务
上下文管理
更新日志
Skill - Agent Studio