创建、导入和管理技能
构建自定义技能、导入兼容的技能,以及稍后安全地编辑或删除它。
自定义技能让你打包自己的说明以供重复使用。当兼容的技能已存在且你想在将其添加到 Runner 之前查看它时,导入很有用。
本指南内容
你将了解如何创建或导入技能、理解每个编辑器控件,以及区分可逆暂停和永久删除。
可用性和前提条件
- 打开有权访问代理 → 技能的项目。
- 技能需要计划访问权限。
- 导入需要 Runner 可以读取的兼容源 URL。
- 不要导入你不信任的说明。在保存之前,查看名称、描述、内容、设置和包含的文件。
入口路径
- 创建:侧栏 Agent → 技能筛选器 → 发现区域中的创建技能。
- 导入:侧栏 Agent → 技能筛选器 → 发现区域中的导入。
- 编辑或删除:侧栏 Agent → 技能筛选器 → 已添加中的一行 → 更多操作。
技能编辑器控件
| 条目或按钮 | 为什么有用 | 接下来会发生什么 |
|---|---|---|
| 名称 | 在列表和命令中给技能赋予身份。 | Runner 在保存前验证名称是否存在。 |
| 描述 | 解释何时应使用该技能。 | 描述出现在技能列表和选择器中。 |
| 内容 | 保存可复用指令。 | 在编辑中撰写,使用预览检查排版后的指令。 |
| 高级配置 | 展开可选的调用和组织设置。 | 仅在需要更改这些设置时展开。 |
| 切换到 Markdown / 切换到表单 | 改变技能编辑方式。 | 打开 Markdown 或字段式编辑器;切换视图不会保存技能。 |
| 类别 | 对相关技能进行分组。 | 此可选标签影响技能的组织方式。 |
| 快捷标签 | 为技能提供更清晰的命令标签。 | 可选标签与面向命令的控件一起出现。 |
| 已启用 | 决定新建或编辑的技能是否处于活跃状态。 | 新技能默认开启。如果应以暂停状态开始,请在创建前关闭。 |
| 禁用 AI 自动调用 | 防止 Runner 自动选择技能。 | 技能仍可用于手动使用。 |
| 用户可调用 | 允许手动斜杠命令使用。 | 关闭它会移除手动调用,同时保持其他允许的使用。 |
| 参数提示 | 在命令后显示预期的输入。 | 提示可以显示示例,如 URL 或问题编号。 |
| 文件区域 | 添加技能所需的支持文本或资产。 | Runner 在保存前验证单个和总文件限制。 |
| 取消 | 不应用当前编辑而离开。 | 对话关闭;未保存的更改被丢弃。 |
| 创建 / 保存 | 保存有效技能。 | 成功后 Runner 关闭编辑器并刷新技能列表。 |
创建自定义技能
- 打开侧栏 Agent,选择技能筛选器。
- 在发现中,选择创建技能。
- 输入使用小写字母和连字符的名称,如
homepage-copy-review,简短的描述,以及技能内容。这些字段均为必填。 - 选择内容区域中的预览检查指令。仅在需要时展开高级配置调整可选设置。
- 检查已启用及您更改过的高级调用设置。这些控件决定 Runner 如何使用技能。
- 选择创建。
- 确认技能出现在已添加或已暂停下,具体取决于启用设置。
英文标注指出了操作位置。点击图片可放大查看。
本例在选择创建前预览指令。草稿尚未保存。(英文界面)
观看:检查技能草稿
录屏在 Markdown 和表单预览之间切换示例,最后取消。要保留自己的技能,请选择创建,并确认它出现在列表中。(英文界面)
导入技能
- 打开 Agent,选择技能筛选器,在发现区域找到导入。
- 粘贴兼容的源 URL。
- 选择导入。
- 对于一个发现的技能,Runner 打开编辑器,导入的字段已填充。对于包含多个技能的源,Runner 打开选择器。
- 查看每个导入的字段和任何排除文件或大小警告。
- 完成必要修改,再选择创建。
- 在关闭工作流之前,确认技能出现在代理页面上。
导入不会使未审查的内容值得信任。像对待任何其他可能影响 Runner 工作的内容一样对待导入的说明。
编辑、暂停或删除
- 选择自定义技能行或打开更多操作 → 编辑。
- 更改所需字段并选择保存。重新打开技能,确认指令已更新。
- 要停止使用它而不丢失它,选择已添加将其移动到已暂停。
- 要删除它,打开更多操作 → 删除。
- 查看命名的确认对话,仅当你打算删除技能时才选择删除。
删除是破坏性的。 它与暂停不同,页面不会将其呈现为可撤销的操作。系统技能不提供删除。
状态和限制
- 缺少名称、描述或内容会阻止保存并显示验证消息。
- 重复的导入技能名称可能被拒绝或标记为已存在。
- 超过接受限制的文件可能被跳过;总大小警告可能会阻止保存,直到内容被减少。
- 在保存、导入或删除运行时,等待成功或错误消息后再执行其他操作。
- 仅查看系统技能可以显示详细信息,但不会公开自定义技能编辑控件。
故障排除
- 如果导入保持不可用,请等待现有技能检查完成,并确认 URL 字段不为空。
- 如果导入打开批量选择器,仅选择你识别和需要的技能。
- 如果保存被阻止,检查必需字段和编辑器顶部的任何文件警告。
- 如果技能在选择已添加后消失,在重新创建之前检查已暂停。
- 如果删除失败,技能仍然存在;关闭错误并在检查你的权限后重试。