技能-大模型服务平台百炼(Model Studio)-阿里云帮助中心

技能是打包后的能力集合，封装常见任务的端到端流程。在控制台Skill 管理页面管理，可被多个智能体复用。

类型

技能分两个标签页：

市场：官方提供的开箱即用技能，例如 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。

Bash

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

Python

skill = client.skills.create(file_id="file_xxx")
print(skill.id)

Java

Skill skill = client.skills().create(SkillCreateParam.builder()
    .fileId("file_xxx").build());
System.out.println(skill.getId());

版本管理

在技能详情页可上传新版本。挂载到智能体时必须指定具体版本号，后续上传新版本不影响已挂载的智能体。

通过 API 上传新版本时，同样需要先获得 file_id。版本号由服务端自动生成。完整参数与响应字段详见上传 Skill 新版本。

Bash

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

Python

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

Java

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

挂载到智能体

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

Bash

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

Python

agent = client.agents.create(
    name="my-agent",
    model="qwen3-max",
    skills=[
        {"type": "customer", "skill_id": "skill_xxx", "version": "1.0"},
    ],
)
print(agent.id)

Java

Agent agent = client.agents().create(AgentCreateParam.builder()
    .name("my-agent")
    .model("qwen3-max")
    .skills(List.of(SkillConfig.builder()
        .type("customer")
        .skillId("skill_xxx")
        .version("1.0")
        .build()))
    .build());
System.out.println(agent.getId());

删除

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

通过 API 删除技能，不可恢复。完整参数与响应字段详见删除 Skill。

Bash

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

Python

client.skills.delete("skill_xxx")

Java

client.skills().delete("skill_xxx");