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