跳转到主要内容

Skill 简介

Skill 是可挂载到智能体的能力包,让智能体在会话中自动处理特定类型的任务。挂载 Skill 后,智能体无需额外编码即可获得文件处理、数据分析等专业能力。

什么是 Skill

Skill 是一个 ZIP 技能包,包内根目录的 SKILL.md 用自然语言声明这个技能能做什么、什么时候该用它。挂载到智能体后,智能体在会话中识别到匹配的任务就会自动调用,不需要额外写代码或对接外部工具。 Skill 和 MCP 解决的是不同的问题:MCP 提供的是工具接口,由智能体按参数调用;Skill 提供的是做事的方法,包里可以带提示词、脚本和参考资料,智能体按包里的说明完成整套流程。 千问AI平台提供两类 Skill:
  • 官方 Skill:平台预置的通用 Skill,覆盖常见文件处理场景(如 xlsx、docx、pdf、pptx)。由平台统一维护和更新,无需配置,挂载后即可使用。
  • 自定义 Skill:上传 ZIP 技能包创建,适用于官方 Skill 未覆盖的业务场景,例如特定行业的数据处理、自定义文件格式解析。详见创建自定义 Skill

官方 Skill

官方 Skill 在控制台技能页面查看,列表持续更新。官方 Skill 不需要开通或配置,挂载到智能体后即可使用;平台发布新版本后,已挂载的智能体自动使用最新版本。

技能市场

除控制台内置的官方 Skill,千问AI平台还有公开的技能市场,面向 Qoder、Claude Code 这类支持 Skill 的 AI 编码工具,可按应用维度筛选技能包。每个技能有一个详情页,地址形如 https://www.qianwenai.com/hub/skills/<技能标识>,页面上有概述版本历史两个标签,以及该技能的开源协议和安全审计时间。 详情页的安装方式区有两个标签:
  • 让 Agent 装:页面给出一段提示词,点复制提示词贴给你的 Agent 即可,形如「请根据 https://www.qianwenai.com/hub/install/skillshub.md ,安装 <技能标识>。」Agent 按这个说明自己完成检测和安装,你不用手写配置。以知识库技能为例,见服务渠道
  • 我自己装:这个标签下给出两种手动方式。一种是用千问AI平台 CLI 装,页面直接给出命令 qianwen skills install <技能标识>,旁边有复制按钮;另一种是点下载 Zip,把技能包解压到本地的 skills 目录。
让 Agent 装我自己装的 CLI 方式都要本地装有千问AI平台 CLI(命令 qianwen,版本 1.4.0 及以上,用法见 CLI):
npm install -g @qianwenai/qianwen-cli@latest
让 Agent 装时 CLI 缺失或版本过低,Agent 会按提示词指向的那份说明自行安装,不需要你手动干预。只有下载 Zip 这一种方式不需要 CLI。 技能市场和控制台的技能页面是两条路,互不影响:技能市场把技能装给外部的 AI 编码工具用;控制台技能页面把技能装到千问AI平台的智能体上——官方 Skill 直接挂载,自己做的技能包点自定义 Skill 上传 ZIP,见创建自定义 Skill

智能体怎么用 Skill

挂载 Skill 只是把能力给到智能体,具体调不调、什么时候调由智能体自己决定。有两种触发方式:
  • 智能体自动判断:智能体把会话内容和每个已挂载 Skill 的 description 做匹配,命中就调用。所以 description 写得准不准,直接决定调用准确率,写法见创建自定义 Skill
  • 在会话里直接点名:如果智能体没按预期调用,可以在消息里明确要求用哪个 Skill,例如「用 xlsx 技能把这份数据整理成表格」。
挂载方式(控制台和 API)、版本指定、删除见 Agent Skill

查看 Skill 详情

在控制台技能页面的市场自定义标签页,点击目标 Skill 卡片进入详情页。详情页有两个标签:
  • 概览:Skill 的名称、当前版本号、功能描述和属性信息。通过版本下拉框可切换查看历史版本。
  • 更新记录:该 Skill 全部版本的发布时间和变更内容。

测试 Skill 效果

挂载后在会话中直接发消息就能验证。例如挂载官方 xlsx Skill 后发送:
帮我创建一个包含本月销售数据的表格,按地区分列统计
智能体将调用 xlsx Skill,生成包含分列统计的 .xlsx 文件并提供下载。

下一步