使用例程重复工作

在 Delegate 中创建、管理和运行例程，以保存可重用的任务工作流，并单击一下即可执行这些工作流。

例程是可重用的工作流，只需单击一下即可运行。这类工作流会捕获您重复执行的工作模式，使您可以自动执行常见任务，而无需每次都重新构建任务。

什么是例程？

例程是指已打包以供重用的已保存“Delegate”会话。与一次性对话不同，例程：

• 具有明确的触发器描述，解释了何时使用
• 接受每次运行时都不同的输入（参数）
• 生成一致的输出（文档、报告、更新等）
• 显示在侧边栏中，以便一键访问
• 可以与团队成员共享

将例程视为您的个人自动化库，即您设计一次并在需要时运行的工作流。

何时创建例程

在您发现自己处于以下情况时创建一个例程：

• 每周要求 Delegate 执行相同类型的任务（例如，“准备星期一上午的摘要”）
• 针对不同的数据遵循一致的流程（例如，“从此 Jira 项目生成状态报告”）
• 与需要执行同一任务的团队成员共享工作流
• 想要计划自动化在特定时间运行

创建例程

可以通过三种方法创建例程：

方法 1：保存成功的会话

要将成功的会话另存为例程，请执行以下步骤：

1. 完成生成您要重用的结果的Delegate会话。
2. 选择“保存为例程” （显示在对话选项中）。
3. Delegate 分析会话并建议：
   • 例程的名称。
   • 输入参数（每次都会不同）
   • 输出格式
4. 查看并编辑建议配置：
   • 名称：描述性内容（例如“每周销售报告”）
   • 触发器：何时使用（例如，“当您需要每周销售数据的摘要时”）
   • 输入: 需要哪些信息（例如，“周结束日期”、“销售电子表格路径”）
   • 输出：例程生成的内容（例如，“带有图表的 PowerPoint 演示文稿”）
5. 选择“保存”。

现在，该例程显示在侧边栏中的“例程”下。

方法 2：从头开始创建

要从头开始创建例程，请执行以下步骤：

1. 打开设置→例程（或使用侧边栏菜单）。
2. 选择“创建例程” 。
3. 填写配置：
   • 名称: 侧边栏中的显示名称
   • 说明：此例程执行的操作
   • 触发器：关于何时使用的自然语言描述
   • 输入: 定义参数，及其名称、类型和说明
   • 步骤：描述 Delegate 应执行的操作（或粘贴成功的会话副本）
4. 选择“保存”。

方法 3：编辑 技能.md 文件

此方法适用于熟悉 Markdown 和文件系统配置的用户。

1. 找到您的本地技能目录：
   • MacOS： ~/Library/Application Support/UiPath/Delegate/LocalSkills/
   • Windows： %APPDATA%/UiPath/Delegate/LocalSkills/
2. 为例程创建一个新文件夹（例如 my-routine/）。
3. 在具有例程定义的文件夹中创建 SKILL.md。
4. 重新启动 Delegate 或在“设置”中刷新技能。

技能.md 结构

---
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

运行例程

从侧边栏

要从侧边栏运行例程，请执行以下步骤：

1. 在左侧边栏中找到“例程”部分。
2. 选择要运行的例程。
3. Delegate 会提示您提供任何必填输入。
4. 查看计划（如果在引导式模式下）。
5. 执行例程并生成输出。

通过提及

在任意对话中，按名称引用例程：

Run the Weekly Sales Report for last week using the file in ~/Documents/Sales/

Delegate 可识别例程名称，并使用您指定的参数执行例程。

通过键盘快捷方式

要使用键盘快捷方式运行例程，请执行以下步骤：

1. 按您配置的快捷键（例如 Cmd+Shift+1）。
2. 例程会立即运行（或提示输入）。

在“设置”→“键盘快捷键”中分配快捷键。

管理例程

收藏

将经常使用的例程固定到侧边栏顶部：

1. 在侧边栏中找到“例程”。
2. 选择星形图标（或打开上下文菜单 → “添加至收藏夹”）。
3. 例程将移动到收藏夹部分。

正在编辑

根据需求的变化更新例程：

1. 在侧边栏中打开例程的上下文菜单 →编辑。
2. 或者转到设置 → 例程 → 找到例程 →编辑。
3. 修改名称、说明、输入或步骤。
4. 保存更改。

注意：编辑例程不会影响过去的运行，仅影响未来的执行。

正在复制

为现有例程创建变体：

1. 打开“例程”的上下文菜单 → “复制” 。
2. 系统将显示带有“（复制）”的副本“名称”中的“”。
3. 编辑副本以进行自定义。

正在删除

删除不再需要的例程：

1. 打开例程的上下文菜单 →删除。
2. 或者转到“设置”→“例程”→ “删除” 。
3. 确认删除

计划例程

按计划自动运行例程：

设置计划

要为例程设置计划，请执行以下步骤：

1. 前往“设置”→“例程”→“查找您的例程”。
2. 选择“计划”。
3. 配置：
   • 频率：一次、每天、每周、每月
   • 时间：运行时间（您的本地时间）
   • 输入：固定值或“运行时提示”
4. 保存计划。

计划选项

下表介绍了可用的计划选项。

选项	描述
在后台运行	在不窃取焦点的情况下执行（建议用于计划的运行）
完成通知	完成后显示通知
失败时	重试、通知或在例程失败时停止
输入处理	使用最新值、到期提示或在输入缺失时跳过

管理计划例程

查看和管理所有计划的例程：

1. “设置”→“例程”→ “计划”选项卡。
2. 查看即将运行的运行、上次运行状态和历史记录。
3. 启用/禁用单个计划。
4. 编辑或删除计划。

注意：计划例程使用您存储的连接和权限运行。如果身份验证过期，则例程可能会失败，直到您重新连接。

共享例程

与团队成员或更广泛的 Delegate 社区共享例程：

导出例程

要导出例程用于共享或备份，请执行以下步骤：

1. 打开例程的上下文菜单 →导出。
2. 或者转到设置 → 例程 →导出。
3. 选择格式:
   • ZIP 文件：完整的例程文件夹（技能.md 和任何资源）
   • 仅限 技能.md : 仅限定义文件
4. 保存到所需位置。

与团队共享

要与您的团队共享例程，请执行以下步骤：

1. 将例程导出为 ZIP 文件。
2. 通过常规渠道（电子邮件、Slack、共享云端硬盘）分享。
3. 收件人可通过设置 → 例程 →导入 导入。

发布到 Marketplace 订阅源

要将例程发布到市场订阅源，请执行以下步骤：

1. 确保您的例程遵循 技能。md 格式。
2. 请联系 UiPath 管理员，了解您组织的技能 Marketplace 订阅源信息。
3. 将例程提交到订阅源 URL。
4. 团队成员可以通过Delegate Store发现和安装它。

注意：发布到公共市场需要 UiPath 的审核和批准。

常规最佳实践

为提高清晰度而设计

• 使用描述性名称：“每周销售报告”，而非“报告 1”
• 编写明确的触发器：解释何时应使用此例程
• 文档输入：解释每个参数的用途和预期格式
• 指定输出：描述用户将收到的内容

处理变异性

• 对任何会发生变化的内容（日期、文件路径、名称）使用输入参数
• 尽可能提供合理的默认值
• 验证例程步骤中的输入（例如，“检查文件是否存在”）
• 通过回退行为正常处理缺失的输入

彻底测试

• 优先在引导模式下运行，以捕获意外步骤
• 使用边缘用例（空文件、未来日期、特殊字符）进行测试
• 共享前请验证输出是否符合预期
• 如果与团队共享，请在不同的计算机上进行测试

版本控制

• 在重大更改之前复制，以保留工作版本
• 在“例程说明”或“更改日志”中记录更改
• 在 skill.md 中使用语义版本控制（1.0.0、1.1.0、2.0.0）

安全注意事项

• 不要在例程步骤中对凭据进行硬编码，请使用连接
• 请谨慎使用文件路径——请使用相对路径或输入参数
• 共享前审核权限—确保收件人拥有访问所需系统的权限
• 清理进入 Shell 命令或 URL 的输入

高级：例程存储

例程以文件的形式存储在您的计算机上：

LocalSkills/
├── my-routine/
│   ├── SKILL.md          # Routine definition
│   ├── references/       # Optional: supporting files
│   └── examples/         # Optional: example inputs/outputs
└── another-routine/
    └── SKILL.md

您可以：

• 通过复制本地技能文件夹来备份例程
• 通过将本地技能放置在云存储（Dropbox、OneDrive）中来实现跨计算机同步
• 通过将文件夹初始化为 Git 存储库来进行版本控制

注意：如果同步本地技能，请注意例程中的绝对路径，它们可能无法在不同的计算机上运行。

后续步骤

了解如何:

• 使用Delegate Store共享工作— 查找预构建的例程和技能
• 查看“设置参考” — 配置例程存储和计划
• 根据最近成功的 Delegate 会话创建第一个例程