Skills是按需创建的模块化能力单元，整合知识、流程、脚本等要素，让Agent像调用函数一样稳定执行特定任务。本文介绍如何创建Skills。 ## 背景信息 Skills用于拓展智能体（Agent）的任务执行边界，通过标准化封装特定任务的知识储备、操作流程、工具脚本及关联资源，让智能体可像调用本地函数一样精准完成指定操作。其典型应用场景覆盖智能客服问答、自动化办公流程、工业设备参数校验、多模态内容生成等，还支持灵活组合调用与版本迭代，适配业务需求变化。同时，企业智能体落地时，常会沉淀大量分散的任务处理逻辑，这类逻辑虽能通过Prompt指令临时调用，却存在复用性低、执行不稳定的问题。Skills的渐进式披露机制还可以避免向模型一次性注入大量无关内容，降低大模型 Token 消耗与调用成本。若将零散任务逻辑转化为标准化Skills组件，可大幅提升智能体任务处理效率与规模化落地能力。AgentKit因此提供Skills开发管理功能，支持任务一键部署，快速将各类业务任务转化为智能体可直接调用的能力单元。 ## 前提条件 * 已准备创建Skills所需的代码包或者TOS文件地址。 :::warning Skill的代码包文件需要符合以下要求： * 代码包 * Skill代码包文件解压后，有且仅有一个根目录文件夹，且文件夹名称与Skill名称相同。当没有根目录文件夹时，平台默认为您创建和Skill同名的文件夹。 * SKILL.md文件存放于上述根目录文件夹的根目录下。 * `name`字段填写Skill.md ZIP文件中的Skill名称。取值需满足： * 不为空，且最多64个字符。 * 仅允许包含小写字母、数字和连字符（\-）。Skill名称包含大写字母时，平台将自动将大写转换为小写。 * 不包含保留字段`agentkit`。 * `descrption`字段填写Skill ZIP文件中的Skill描述。取值需满足： * 不为空，且最多1024个字符。 * 不能包含XML标签。 ::: * 智能体调用前，需要先创建同账号、同地域下的Skills空间，在创建Skill时关联对应的空间。创建Skills空间的方法参见[创建Skills空间](https://www.volcengine.com/docs/86681/2137203)。 ## 创建Skill 1. 登录[AgentKit控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树中选择“Skills中心”。 3. 单击“创建Skill”，在创建页面参照下表完成参数配置。 * **基本信息** |参数 |说明 | |---|---| |创建方式 |支持通过压缩包和TOS导入两种方式创建Skill。|\ | ||\ | |* 上传压缩包：上传已准备的Skill ZIP文件。您可以通过控制台下载代码示例。|\ | |* 从TOS导入：填写Skill ZIP在TOS中的地址。地址格式为`https://${桶名}.${TOS域名}/${object完整路径}`。压缩包上传至TOS的方法参见[上传文件](https://www.volcengine.com/docs/6349/74830)。|\ | ||\ | |:::warning|\ | |从TOS拉取Skill文件为一次性操作，后续TOS文件的更新时，需要更新Skill并发布才能生效，操作步骤参见下文**更新Skill**和**发布Skill**。|\ | ||\ | |:::| |Skill 名称 |展示Skill文件中已定义的Skill名称。对应`SKILL.md`文件中的元数据`name`。 | |Skill 描述 |展示Skill文件中已定义的Skill描述。对应`SKILL.md`文件中的元数据`description`。 | |加入Skills空间 |Skill需加入Skills空间后才能被智能体调用。选择同账号、同地域的已有Skills空间。创建Skills空间的方法参见[创建Skills空间](https://www.volcengine.com/docs/86681/2137203)。|\ | |:::tip|\ | ||\ | |* 新建的Skill加入空间后即可被智能体调用，不需要发布。|\ | |* Skill更新以后，需要重新发布后，新版本才能生效，操作详情参见下文“发布Skill”。|\ | ||\ | |:::| * 高级配置 |参数 |说明 |示例值 | |---|---|---| |所属项目 |项目是一组资源的集合，您可以将本次创建的Skill添加至项目中并按项目维度统一管理，有利于保持资源独立，维护数据安全。有关项目的更多信息请参见[项目管理](https://www.volcengine.com/docs/86681/2075078)。|default |\ | || |\ | |* 默认为default，一个资源只能归属于一个项目。| |\ | |* 选定项目后，创建的Skill只能被具有该项目权限的用户使用。创建Skill后，您可以按需更改Skill所属的项目，更改项目的操作详情参见[项目资源管理](https://www.volcengine.com/docs/6649/94337)。| |\ | |* 若无可用项目，您可单击“新建项目”按钮进行创建，创建完成后，返回本页面即可选择新添加的项目。 | | |标签 |标签由一个键\-值对（Key\-Value）组成，用于标识云资源，可以从不同维度（例如用途、所有者或环境等）对云资源进行分类，便于搜索和聚合。|Key1:Value1 |\ | |单击“+ 添加标签” 按钮，选择已有标签或输入新的标签，为Skill绑定标签。更多信息，请参见[标签管理](https://www.volcengine.com/docs/86681/2075077)。| |\ | |:::tip| |\ | |单次操作最多可绑定20个标签，单个资源最多可绑定50个标签。| |\ | || |\ | |:::| | 5. 勾选“产品处于公测/邀测阶段，我已阅读同意[《产品和服务测试协议》](https://www.volcengine.com/docs/6256/79748)”。 6. 单击“立即创建”，完成操作。 ## 发布Skill Skill更新以后，需要重新发布才能生效。 1. 登录[AgentKit控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树中选择“网关\>Skills中心”。 3. 单击目标Skill的名称。 4. 单击页面右上角的“发布”。 5. 在二次确认页面，单击“发布”，完成操作。 ## 其他操作 |操作 |步骤 | |---|---| |接入Skills空间|1. 在Skill列表，单击目标Skill的名称。|\ | |2. 在“加入的Skills空间”区域，单击“加入Skills 空间”或“添加”。|\ | |3. 在下拉框选择需要加入的Skills空间。|\ | |4. 单击“确定”，完成操作。 | |更新Skill |1. 在Skill列表，单击目标Skill的名称。|\ | |2. 在“Skill详情”页签，单击“项目文件”右侧的“铅笔”图标。|\ | |3. 在“更新Skill”页面，重新上传更新后的压缩包，或者填写更新后压缩包的TOS地址。|\ | |4. 单击“确定”，完成操作。 | |查看Skill版本详情 |1. 在Skill列表，单击目标Skill的名称。|\ | |2. 在“版本管理”页签，单击目标版本“操作”列下的“查看”。|\ | |3. 在“版本详情”页面查看Skill的详情。 | |查看/编辑Skill文件 |1. 在Skill列表，单击目标Skill“操作”列下的“Skill详情”。|\ | |2. 在“Skill详情”页面，编辑Skill文件内容或者目录。|\ | | * 编辑文件内容：在左侧目录选中目标文件后，在右侧编辑内容。编辑完成后，单击“保存”，完成内容更新。|\ | | * 编辑目录：右键单击目标文件或文件夹，完成重命名、删除、新建文件或文件夹等操作。|\ | ||\ | |:::warning|\ | ||\ | |* `SKILL.md `文件不支持删除或重命名。|\ | |* `SKILL.md `文件头部的 `name` 不支持修改。|\ | ||\ | |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_10dece72c4da3aa92a0da179f1179cb6.png) |\ | ||\ | |:::| |删除Skill |1. 在Skill列表，单击目标Skill“操作”列下的“删除”。|\ | |2. 在二次确认页面单击“删除”，完成操作。|\ | ||\ | |:::warning|\ | |删除Skill后不可恢复，且将同时从关联的Skills空间中移除，请谨慎操作。|\ | ||\ | |:::| ##