配置技能组模板和实例
技能组把一个或多个 Skill 及其版本选择组合起来，供智能体使用。先准备 Skill 内容和版本，再根据使用范围创建技能组模板或技能组实例。
需要为智能体提供可复用、可选择版本的工作说明和相关文件时，使用技能组。只需一段稳定说明时，可以直接写入系统提示词；需要执行 Skill 中描述的命令或处理文件时，还需要配置提供相应工具的沙箱。完成关联后，使用能够明确触发 Skill 的输入，并在 Trace 中检查 Skill 激活、资源读取和实际版本。
选择模板或实例
根据智能体实例应分别准备还是共同使用技能组资源，选择技能组模板或技能组实例。
使用技能组模板
以下情况适合使用技能组模板：
- 多个智能体实例需要使用相同的 Skill 组合，但分别准备技能组资源。
- 渠道用户创建专属智能体实例时需要使用一致的 Skill 组合。
使用技能组实例
以下情况适合使用技能组实例：
- 多个智能体实例应共享同一个固定 Skill 组合和版本。
- 当前只有一个已经验证的固定技能组。
模板和实例都需要为每个 Skill 选择版本。选择 latest 会动态跟随最新版本；需要稳定复现时，请选择明确版本号。
创建技能组资源
根据技能组是否需要随智能体实例分别准备，创建技能组模板或直接创建技能组实例。
以下入口仅在租户已启用 Skill 能力时可用。按钮会在新标签页打开控制台。若先进入登录页，控制台目前不会在登录后自动返回目标页面；请登录后返回本文，再次选择按钮。
打开 技能组管理。
也可从左侧导航进入 技能组管理。
创建技能组模板
- 选择 技能组模板。
- 选择 新建技能组模板。
- 填写 技能组模板名称 *和描述。
- 在 技能选择 中为所需 Skill 选择明确版本或 latest，再选择 添加选中 ＞；需要添加当前列表中的所有 Skill 时，选择 全部添加 ＞＞。
- 选择 创建。
模板适合多个智能体实例使用相同 Skill 基线。创建智能体实例后，请确认技能组类型、Skill 组合和版本符合预期。
直接创建技能组实例
如果所有智能体实例共享固定的 Skill 集合和版本，可以在 技能组 中直接创建技能组实例并添加到智能体模板。
修改共享技能组前，盘点引用该技能组的智能体模板和智能体实例。需要分阶段发布时，创建新的技能组或独立智能体实例进行验证。
将技能组用于智能体
创建技能组后，将其关联到智能体模板，并通过智能体实例验证 Skill 组合、版本选择和运行时读取是否符合预期。
将技能组添加到智能体模板
- 编辑或创建智能体模板。
- 打开 插件配置。
- 单击 添加插件。
- 选择 技能组 - 模板 或 技能组 - 实例，再选择目标技能组模板或实例。
- 保存智能体模板。
- 在智能体模板详情页的 插件 页签中确认技能组类型、名称和资源 ID。
- 创建或更新智能体实例。
理解技能组的运行方式
技能组确定智能体可以使用哪些 Skill，以及每个 Skill 解析到哪个版本。智能体实例运行时可以激活匹配的 Skill，并按需读取该版本的相关资源。
技能组本身负责版本选择、运行时激活和资源读取。即使智能体模板同时使用技能组和沙箱，Skill 文件也不会自动进入沙箱，脚本不会自动执行、安装依赖或注册工具。参见在运行时读取 Skill 内容和资源。
验证技能组实际生效
保存技能组后，创建或更新智能体实例，并完成以下步骤来验证实例是否按预期使用其中的 Skill：
- 用能明确触发 Skill 的输入测试。
- 在 Trace 中确认 Skill 激活；测试依赖相关文件时，还要确认资源读取。
- 使用目标版本独有的内容确认技能组实际选择的 Skill 版本。
- 用不会触发 Skill 的输入确认边界。
维护技能组
生产使用期间，通过受控升级、回退和删除维护技能组，同时先处理相关引用。
升级或回退技能组
升级生产技能组时，先记录当前技能组及每个具体版本号。在测试技能组中选择目标版本，更新测试智能体实例，并用目标版本独有的说明或资源完成回归。完成这些检查后，再修改生产技能组和智能体实例。
回退时重新选择先前记录的具体版本，编辑并保存相关智能体实例，然后重新执行固定测试。stable/latest 标记不会替你恢复智能体实例配置。
删除技能组模板或实例
删除前检查智能体模板和智能体实例的引用：
- 删除技能组实例不会删除其中引用的 Skill。
- 删除技能组模板后，仍需在实例列表中确认相关技能组实例是否需要清理。
- 删除共享技能组实例可能同时影响多个智能体实例。
先让引用该技能组的智能体模板和智能体实例改用替代技能组并完成回归，再执行删除。