文档中心

AgentKit

技能

更新技能

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

操作说明

AgentKit 支持两种技能更新方式，你可根据变更内容的复杂度选择合适的方式。

更新方式	操作	适用场景
更新技能代码包	通过上传压缩包、填写 TOS 存储地址或复制预置技能的方式，整体覆盖目标技能代码文件。	适用于功能迭代、结构重构、大范围内容变更等复杂度较高的场景。
编辑技能文件	在控制台中直接修改技能中的代码文件或目录结构。	适用于小缺陷修复、参数调整、文案更新等轻量级变更场景。

前提条件

已创建技能，操作详情参见创建技能。

操作步骤

方式一：更新技能压缩包

注意

该方式会直接覆盖存量的技能代码，覆盖后无法通过页面回滚。请在更新前确认代码包内容无误，避免影响线上业务。

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

选择“技能”页签。

在目标技能“操作”列表，单击“更新”按钮。

在更新技能页面，选择对应的更新方式并完成参数配置。更新的配置逻辑与创建技能基本一致，详情请参见创建技能。

技能更新完成后，需要发布到当前已关联的技能空间，智能体才可调用更新后的技能版本。系统默认选中已关联的技能空间，保留默认选项，单击“确定”按钮。

确认本次更新内容无误后，再次单击“确定”按钮，完成技能更新与新版本发布。

方式二：编辑技能文件

注意

上传或更新技能代码包前，请确认代码包内容符合以下规范，否则可能导致更新或发布失败。

代码包结构要求

代码包解压后有且仅有一个根目录文件夹，且文件夹名称与技能名称一致。

若代码包解压后不存在根目录文件夹，平台会自动创建与技能同名的文件夹作为根目录。

SKILL.md 位置：SKILL.md 必须存放于根目录文件夹的根路径下，不能置于子目录中。

SKILL.md 生命周期：SKILL.md 文件不支持删除或重命名。

SKILL.md 字段要求

SKILL.md 文件头部包含 name、description 等元数据字段，用于标识技能的名称与用途，需满足以下取值规范：

name字段：技能名称，用于唯一标识该技能。取值需满足：

不为空，且最多 64 个字符。

仅允许包含小写字母、数字和连字符（-）。技能名称包含大写字母时，平台将自动将大写转换为小写。

不包含保留字段agentkit。

SKILL.md头部的name字段不支持修改。

descrption字段：用于填写技能的功能描述，说明该技能的能力与用途。取值需满足：

不为空，且长度不超过 1024 个字符。

不能包含 XML 标签。

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

选择“技能”页签。

在技能列表，单击目标技能“操作”列的“详情”按钮。

在技能详情页面按需编辑技能文件内容或目录。

编辑文件内容

在左侧目录树选中待修改的目标文件，右侧面板编辑文件内容。修改完成后单击“保存”按钮，即可完成当前文件内容更新。

说明

将当前编辑内容固化为技能的新版本，仅作用于技能自身，不影响技能空间中已发布的版本。

在项目文件目录树中，右键单击目标文件或文件夹，可执行重命名、删除、新建文件、新建文件夹等操作，编辑完成后单击“保存”按钮，即可完成目录结构更新。

注意

删除操作会直接从当前技能中移除对应文件或文件夹，不支持回滚，请谨慎操作。

将当前编辑内容固化为技能的新版本，仅作用于技能自身，不影响技能空间中已发布的版本。

确认更新内容无误后，在页面右上角单击“发布”按钮。

在弹出的发布面板中，选择目标技能空间后，单击“仍要发布”按钮，即可将技能的最新版本同步至该空间，供智能体调用。

说明

如果您的技能从未发布过任何版本，则更新后无法在此执行发布操作，需要通过加入技能空间方式发布。

后续步骤

对技能执行更新操作仅会生成技能新版本，新版本不会自动生效。您还需要手动执行发布操作，将新版本发布至指定的技能空间后，更新后的能力才可以在对应技能空间内生效，详情请参见发布技能。

最近更新时间：2026.09.24 18:49:53

这个页面对您有帮助吗？

有用

无用