文档中心

AgentKit

技能

手动创建技能

技能是按需创建的模块化能力单元，可将特定任务所需的知识、操作流程、工具脚本及关联资源进行标准化封装，使 Agent 像调用函数一样能够稳定执行指定任务。支持通过克隆预置技能、上传压缩包或从 TOS 拉取文件等方式创建技能。

背景信息

在智能体应用开发过程中，任务处理逻辑可能分散在 Prompt、脚本及知识文件中，存在复用成本较高、维护困难及执行结果不稳定等问题。将相关逻辑封装为标准化技能后，可实现能力复用、版本管理与统一部署，提升智能体应用的开发和维护效率。

技能采用渐进式披露机制，可根据任务需要向模型提供相关内容，避免一次性加载大量无关信息，有助于减少 Token 消耗。典型应用场景包括智能客服问答、自动化办公、工业设备参数校验及多模态内容生成等。

前提条件

以下条件需根据您选择的技能创建方式以及是否需要关联技能空间按需准备。

上传压缩包

选择上传压缩包方式创建技能，需要提前准备好构建技能所需的完整代码压缩包。上传后平台将解析压缩包内的配置、脚本与资源文件，完成技能的创建。

选择 TOS 方式创建技能，需要预先将技能代码压缩包上传至 TOS 存储桶，并获取对应 TOS 文件访问地址。平台通过该 TOS 地址拉取代码包资源，完成技能创建。详情请参见上传至火山引擎对象存储 TOS。

创建技能时关联技能空间

如需在创建技能的同时将其添加至目标技能空间，请提前完成技能空间创建。

说明

创建技能时也可以暂不添加技能空间，后续支持随时将该技能添加至目标空间，详情参见加入/移除技能。

技能代码压缩包规范

创建技能之前，请确认 ZIP 文件的目录结构以及 SKILL.md 元数据文件满足下述规范要求。您也可以在创建技能页面单击下载样例按钮，获取参考样例包。详情见下文操作步骤。

注意

若需通过上传压缩包方式创建技能（上传多个代码压缩包）时，各个代码压缩包文件夹名称（技能名称）不可重复。

目录结构

ZIP 文件解压后，有且仅有一个根目录文件夹，且文件夹名称与技能名称相同。当没有根目录文件夹时，平台默认为您创建和技能同名的文件夹。

SKILL.md 文件需直接存放在该根目录下，不可存放在子目录中。

SKILL.md 元数据

字段	说明
name	用于定义技能.md ZIP 文件中的技能名称。取值需满足：不为空，且最多64个字符。仅允许包含小写字母、数字和连字符（-）。技能名称包含大写字母时，平台将自动将大写转换为小写。不包含保留字段agentkit。
description	用于描述技能的功能及适用场景。取值需满足：不为空，且最多 1024 个字符。不能包含 XML 标签。

操作步骤

在左侧导航树，选择“技能”。

选择“创建技能 > 手动创建”按钮，进入创建页面，请参考下表完成相关参数配置。

基本信息

参数	说明
创建方式	选择目标创建方式，支持“预置技能克隆”、“上传压缩包”和“TOS”。预置技能克隆预置技能是由平台自主研发或经主流模型厂商官方认证的技能。若需基于预置技能进行二次开发时，可通过克隆预置技能方式创建独立副本，以减少初始开发和配置成本。说明克隆完成后，可进入技能详情页，根据业务场景修改内容并发布新版本。如仅需直接使用预置技能，无需在此创建，只需将其添加至技能空间，具体操作请参见添加技能。上传压缩包选择上传压缩包方式创建技能，可将本地存储的技能代码压缩包上传至平台，支持单次上传一个或多个压缩包。 TOS 通过 TOS 地址拉取对应技能ZIP 文件方式创建技能。选择该方式，需要您预先将技能ZIP 代码包上传至 TOS，详情请参见上传至火山引擎对象存储 TOS。注意从 TOS 拉取文件为一次性操作，TOS 中的源文件发生更新后，已创建的技能不会自动同步。需在 AgentKit 中更新技能并发布新版本，具体操作请参见更新技能和发布技能。
通过预置技能克隆	选择目标预置技能卡片，如当前页面未展示目标技能，可单击查看更多预置技能按钮浏览更多预置技能。说明仅当创建方式选择为“预置技能克隆”时，需配置此项。
压缩包	按需上传一个或多个技能代码压缩包。单击点击上传按钮，选择本地的技能代码压缩包完成上传。如需批量上传更多压缩包，请单击继续上传按钮，上传更多压缩包。单次批量上传最多支持 30 个压缩包。说明系统会为每一个上传的压缩包分别生成独立技能。仅创建方式为上传压缩包时，需配置此项。
TOS 地址	填写技能ZIP 代码包在 TOS 中的文件访问地址。地址格式为https://${桶名}.${TOS域名}/${object完整路径}。如需了解将压缩包上传至 TOS 的操作步骤请参见上传文件。说明仅创建方式为 TOS 时，需配置此项。
技能名称/描述	页面默认回显源预置技能的名称与描述，请修改技能名称。说明克隆生成的技能名称不允许与原预置技能名称相同，同时租户内所有技能名称不可重复。仅当创建方式选择为“预置技能克隆”时，需配置此项。
加入技能空间	单击“加入技能空间”下拉列表，选择当前地域下已创建的技能空间。说明创建技能时也可以暂不添加技能空间，后续按需再将该技能加入目标空间，详情参见加入/移除技能。若现有可选的技能空间不符合业务需求，请单击“去创建”按钮完成技能空间创建后，再进行选择。新建生成的技能（初始版本为 v1）添加至技能空间后，即可被智能体调用，无需额外执行发布操作。

高级配置

参数	说明	示例值
所属项目	项目是一组资源的集合。支持将当前创建的技能添加至指定项目，并按项目维度统一管理，以实现资源隔离与数据安全管控。项目更多信息请参见项目管理。系统默认选择 default 项目。一个资源仅可归属于一个项目，如需更改技能所属项目，可单击所属项目下拉列表并选择目标项目。选定项目后，创建的技能仅支持具有该项目权限的用户访问和使用。如当前项目不符合业务需求，可单击“新建项目”按钮进行创建。创建完成后，返回当前页面并选择新建的项目。	default
标签	标签由一个键-值对（Key-Value）组成，用于标识云资源，可以从不同维度（例如用途、所有者或环境等）对云资源进行分类，便于搜索和聚合。单击“+ 添加标签” 按钮，选择已有标签或输入新的标签，为技能空间绑定标签。更多信息，请参见标签管理。说明最多支持添加 20 个标签。	Key1:Value1

单击“创建”按钮，完成操作。

后续操作

技能创建完成后，您可以持续迭代技能内容、生成多个版本，以此适配业务需求的变化。更新技能仅会生成新版本，还需执行发布操作，新版本能力才会在目标技能空间中生效。

更新技能

技能具备持续迭代能力，您可以通过更新技能提升其功能与稳定性，让智能体在更多业务场景下具备更强的可用性。

在线测试（可选）

发布前可对更新后的技能发起在线测试，验证任务执行过程、输出结果和业务逻辑是否符合预期。

发布技能

确认新版本内容及测试结果无误后，将当前版本发布至目标技能空间，使新版本能力在空间中生效。

最近更新时间：2026.10.10 11:54:25

这个页面对您有帮助吗？

有用

无用