Agent Skills - Agent Studio

类型

技能分两个标签页：

市场：官方提供的开箱即用技能，例如 PDF / Word / Excel / PowerPoint 处理、bailian-cli。
自定义：以 zip 包形式上传的自有技能（不超过 10 MB）。zip 包根目录须包含 SKILL.md，以 YAML 格式声明技能名称与描述，智能体根据描述决定何时调用。

上传自定义技能

在自定义标签页点击自定义 Skill。
选择本地 zip 包（不超过 10 MB，根目录须包含 SKILL.md），提交后系统自动审查内容，进入 checking 状态。审查通过变为 active，可挂载到智能体；审查未通过变为 rejected，不能挂载。

通过 API 上传时，需先调用文件上传接口获得 file_id，再传入创建接口。完整参数与响应字段详见创建 Skill API。

curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/skills" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_id": "file_xxx"}'

版本管理

在技能详情页可上传新版本。挂载到智能体时必须指定具体版本号，后续上传新版本不影响已挂载的智能体。通过 API 上传新版本时，同样需要先获得 file_id。版本号由服务端自动生成。完整参数与响应字段详见 Skill API。

curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/skills/skill_xxx/versions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_id": "file_xxx"}'

挂载到智能体

在智能体编辑页的技能区点击添加技能，从下拉选择技能并指定版本。通过 API 创建或更新智能体时，在 skills 字段中指定技能 ID 与版本，详见创建 Agent API。

curl -X POST "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/agents" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent",
    "model": {"id": "qwen3-max"},
    "skills": [
      {"type": "customer", "skill_id": "skill_xxx", "version": "1.0"}
    ]
  }'

删除

技能只支持删除，不支持归档。在技能详情页点击删除，技能将被硬删除，不可恢复。已挂载到智能体的技能引用将失效。

curl -X DELETE "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/skills/skill_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

下一步

定义 Agent：在智能体上挂载技能。
发起会话：观察智能体如何调用技能。

​类型

​上传自定义技能

​版本管理

​挂载到智能体

​删除

​下一步

类型

上传自定义技能

版本管理

挂载到智能体

删除

下一步