- 概述
- 安装和设置
- 入门指南
- 信任与合规
- 监管
- 功能
- Delegate for Testing
- 参考
- 故障排除
- 备份和还原
使用例程重复工作
在 Delegate 中创建、管理和运行例程,以保存可重用的任务工作流,并单击一下即可执行这些工作流。
例程是可重用的工作流,只需单击一下即可运行。这类工作流会捕获您重复执行的工作模式,使您可以自动执行常见任务,而无需每次都重新构建任务。它们与“计划的例程”条目一起显示在侧边栏的“例程”部分中,此处显示您已计划的例程。
Delegate 附带一组开箱即用的预定义例程,以及您自己创建的例程。
什么是例程?
例程是一项已标记为用户可调用的技能 — 相同的打包、相同的发布、一个额外的属性。设计良好的例程通常具有:
- 清晰的触发器说明,解释何时使用它们
- 每次运行都不同的输入(参数)
- 一致的输出(文档、报告、更新等)
每个常规都是一项技能;并非每项技能都是例程 — 区别在于多了一个属性。这就是为什么侧边栏包含可调用例程列表,而加载项和集成→技能则列出了智能体可以利用的所有内容(无论可调用与否)。请参阅技能参考。
将例程视为您的个人自动化库,即您设计一次并在需要时运行的工作流。
何时创建例程
在您发现自己处于以下情况时创建一个例程:
- 每周要求 Delegate 执行相同类型的任务(例如,“准备星期一上午的摘要”)
- 针对不同的数据遵循一致的流程(例如,“从此 Jira 项目生成状态报告”)
- 与需要执行同一任务的团队成员共享工作流
- 想要计划自动化在特定时间运行
创建例程
在侧边栏的“例程”部分中选择“新建例程” ,然后选择以下四种方法之一:
| 方法 | 操作 |
|---|---|
| 通过提示词创建 | 描述任务,让智能体构建例程 |
| 通过技能创建 | 从现有技能模板开始 |
| 通过录制文件创建 | 将录制的工作流转换为例程 |
| 录制新工作流 | 录制您的屏幕以捕获新工作流 |
从本质上讲,例程是一个 SKILL.md 文件 — 对于熟悉 Markdown 和文件系统配置的用户,直接编辑是另一种制定例程的方法。结构示例:
---
name: my-routine
friendly_name: Weekly Sales Report
version: 1.0.0
description: "Generates a weekly sales summary from spreadsheet data"
icon: FaChartBar
color: "3B82F6"
trigger: "When you need a summary of weekly sales performance"
inputs:
- name: week_ending
type: date
description: "The last day of the week to report on"
- name: data_file
type: file
description: "Path to the sales data spreadsheet"
output:
type: file
description: "PowerPoint presentation with sales charts"
---
## Steps
1. Read the sales data from {data_file}
2. Filter for the week ending {week_ending}
3. Calculate total sales, top products, and regional breakdown
4. Create a PowerPoint with:
- Title slide: "Weekly Sales Report - {week_ending}"
- Summary slide with key metrics
- Chart slide showing product performance
- Regional breakdown table
5. Save as "Sales_Report_{week_ending}.pptx" on the Desktop
---
name: my-routine
friendly_name: Weekly Sales Report
version: 1.0.0
description: "Generates a weekly sales summary from spreadsheet data"
icon: FaChartBar
color: "3B82F6"
trigger: "When you need a summary of weekly sales performance"
inputs:
- name: week_ending
type: date
description: "The last day of the week to report on"
- name: data_file
type: file
description: "Path to the sales data spreadsheet"
output:
type: file
description: "PowerPoint presentation with sales charts"
---
## Steps
1. Read the sales data from {data_file}
2. Filter for the week ending {week_ending}
3. Calculate total sales, top products, and regional breakdown
4. Create a PowerPoint with:
- Title slide: "Weekly Sales Report - {week_ending}"
- Summary slide with key metrics
- Chart slide showing product performance
- Regional breakdown table
5. Save as "Sales_Report_{week_ending}.pptx" on the Desktop
运行例程
- 从侧边栏的“例程”列表中选择一个例程。这会使用例程的
/命令自动填充聊天框 — 将其发送到运行。 - 在聊天框中键入
/,打开可用例程和命令的菜单,然后选择一个以相同方式自动填充。 - 在对话中按名称引用例程,例如:
Run the Weekly Sales Report for last week using the file in ~/Documents/Sales/。Delegate 可识别例程名称,并使用您指定的参数执行该例程。
管理例程
在“例程”列表中打开例程旁边的选项菜单,执行以下操作:
| 操作 | 操作 |
|---|---|
| 收藏夹 | 固定例程,以便更容易地找到 |
| 查看文件 | 查看此例程的用途及其使用方法 |
| 计划 | 设置定期运行或一次性运行 — 请参阅为例程制定计划。 |
| 重命名 | 更改例程的显示名称 |
| 移动到项目 | 将例程移动到其他项目 |
| 删除 | 删除例程 |
要编辑例程,请直接编辑其关联的SKILL.md文件 — 请参阅高级:例程存储。
制定例程计划
选择例程旁边的“计划”,或从“例程”列表中选择“计划”例程,然后配置:
| 字段 | 描述 |
|---|---|
| 例程 | 要运行的例程 |
| 安排例程 | 运行的日期和时间 |
| 重复周期 | 重复频率 — 默认为“无”(一次性) |
| Mode | 前台(使用应用程序、鼠标和键盘)或后台 |
| 模型 | 运行计划例程的模型 |
管理计划例程
从侧边栏中的“计划的例程”查看和管理所有计划的例程:查看即将运行的运行、上次运行的状态和历史记录,并启用、禁用、编辑或删除单个计划。
计划的例程使用您存储的连接和权限运行。如果身份验证过期,例程可能会失败,直到您重新连接。
共享例程
由于例程是一项技能,因此与团队成员共享例程或更广泛地发布例程遵循与任何其他技能相同的发布、审核和安装流程 — 请参阅与团队共享技能。
常规最佳实践
为提高清晰度而设计
- 使用描述性名称:“每周销售报告”,而非“报告 1”
- 编写明确的触发器:解释何时应使用此例程
- 文档输入:解释每个参数的用途和预期格式
- 指定输出:描述用户将收到的内容
处理变异性
- 对任何会发生变化的内容(日期、文件路径、名称)使用输入参数
- 尽可能提供合理的默认值
- 验证例程步骤中的输入(例如,“检查文件是否存在”)
- 通过回退行为正常处理缺失的输入
彻底测试
- 优先在引导模式下运行,以捕获意外步骤
- 使用边缘用例(空文件、未来日期、特殊字符)进行测试
- 共享前请验证输出是否符合预期
- 如果与团队共享,请在不同的计算机上进行测试
版本控制
- 在重大更改之前复制,以保留工作版本
- 在“例程说明”或“更改日志”中记录更改
- 在 skill.md 中使用语义版本控制(1.0.0、1.1.0、2.0.0)— 版本只会向前推进
安全注意事项
- 不要在例程步骤中对凭据进行硬编码— 使用连接
- 请谨慎使用文件路径— 请使用相对路径或输入参数
- 共享前审核权限— 确保收件人有权访问所需系统
- 清理进入 Shell 命令或 URL 的输入
高级:例程存储
例程以 SKILL.md 文件的形式存储在 LocalSkills/ 文件夹下:
LocalSkills/
├── my-routine/
│ └── SKILL.md
└── another-routine/
└── SKILL.md
LocalSkills/
├── my-routine/
│ └── SKILL.md
└── another-routine/
└── SKILL.md
请参阅设置文件位置以了解此文件夹所在的位置。您可以通过复制来备份例程,也可以通过云存储在计算机之间同步它 — 这样做时,请要小心例程中的绝对路径,因为它们可能无法在另一台计算机上工作。