- 入门指南
- 最佳实践
- 租户
- Cloud Robots
- 文件夹上下文
- 自动化
- 流程
- 作业
- Apps
- 触发器
- 日志
- 监控
- 队列
- 资产
- 业务规则
- 存储桶
- MCP 服务器
- 索引
- Orchestrator 测试
- 资源目录服务
- 集成
- 故障排除

Orchestrator 用户指南
在完成以下步骤之前,您需要 创建一个流程。
设置作业优先级
选择执行运行时
从“Runtime 类型”下拉列表中,选择用于执行作业的运行时类型。
下拉列表下方会显示可用和已连接的运行时数量。
- “_ 可用” - 可用的运行时数量,以运行时总数减去正在运行的作业数计算得出。
-
“_ 已连接”- 运行时总数,以连接到与活动文件夹关联的 Orchestrator 的所有计算机上的运行时总和计算得出。
Runtime 类型
描述
Production (Unattended)
使用无人值守运行时以无人值守模式执行作业。
测试
使用测试运行时以无人值守模式执行作业。
应用程序测试
使用应用测试 runtime 以 Unattended 模式执行作业。
重要提示:应用测试 runtime 只能执行以下操作:- 来自测试自动化项目的应用程序测试用例。
- 使用应用测试开发者许可证创建的用于应用测试的 non-production 流程。
非生产
使用非生产运行时以无人值守模式执行作业。
Cloud - Serverless 测试
该作业在配置为在测试环境中运行的 Serverless Robot 计算机上以 Unattended 模式执行。所需的 Robot Units 数量特定于测试环境,并取决于 Serverless Robot 计算机的规格以及执行作业所需的分钟数。
有关更多详细信息,请参阅 Robot Units - 消耗。
Cloud - Serverless
该作业在配置为在生产环境中运行的 Serverless Robot 计算机上以 Unattended 模式执行。所需的 Robot Units 数量特定于生产环境,并取决于无服务器机器人计算机的大小以及执行作业所需的分钟数。
有关更多详细信息,请参阅 Robot Units - 消耗。
Cloud - VM 测试
该作业在配置为在“测试”或“Non-production”环境中运行的 Cloud VM 上以 Unattended 模式执行。运行虚拟机会使用测试环境中的 Robot Units。
有关更多详细信息,请参阅 Robot Units - 消耗。
Cloud - VM
该作业在配置为在生产环境中运行的云虚拟机上以 Unattended 模式执行。运行虚拟机会使用生产环境中的 Robot Units。
有关更多详细信息,请参阅 Robot Units - 消耗。
示例:假设计算机模板 A 有 2 个非生产运行时和 1 个无人值守运行时,计算机模板 B 有 3 个非生产运行时和 2 个无人值守运行时。两个模板都与一个文件夹相关联。在每个模板上,您连接一台主机。产生的运行时状态如下:
- 无人值守:
3 Available, 3 Connected
- 非生产:
5 Available, 5 Connected
占用一个运行时的正在运行的作业会从该类型的可用运行时数中减去 1。
在发布时,Orchestrator 从可用的个人工作区运行时中选择来执行作业。 运行时优先级如下:
- Production (Unattended)
- 非生产
例如,如果不存在 Production Runtime,则 Orchestrator 将使用可用的 NonProduction Runtime。如果不存在,则作业将失败。
如果所选运行时在作业执行之间变得不可用,则即将执行的作业将失败,因为 Orchestrator 不会查找下一个可用的作业。
配置执行目标
根据需要在“开始作业”窗口的“执行目标”部分设置选项,以配置执行目标。
动态分配
选择不对帐户和计算机进行明确选择的动态分配,可以在首先可用的帐户和计算机下多次执行前台流程。只要有足够的 runtime,无论帐户是否繁忙,后台流程都可以在任何帐户上执行。
使用此选项,最多可以在一个作业中执行一个流程 10000 次。
帐户
您可以选择以下方法之一:
- 指定帐户意味着系统将在该特定用户或机器人帐户下执行流程。
- 同时指定帐户和计算机意味着在该特定帐户-计算机对上启动作业。仅可选择有效的帐户-计算机对。
- 如果未指定帐户,则 Orchestrator 会动态分配帐户。
计算机
您可以选择以下方法之一:
- 指定计算机对象意味着将在所选计算机模型附加的一台主机上执行该流程。从下拉列表中的已连接主机池中选择特定主机。
- 同时指定帐户和计算机意味着在该特定帐户-计算机对上启动作业。仅可选择有效的帐户-计算机对。
- 如果未指定计算机,则 Orchestrator 会动态分配主机。
确保将与作业类型匹配的运行时分配给关联的计算机模型。仅显示与活动文件夹关联的已连接主机。
选择有效帐户 - 计算机映射
选择将运行作业的特定帐户-计算机对。如果希望在多个此类对上运行作业,您可以单击“添加帐户-计算机映射”。如果执行此操作,将为每个帐户-计算机对创建一个“待处理”作业。
启用 Healing Agent
要接收建议和调试信息,了解如何修复在执行作业期间可能出现的问题,请打开“启用 Healing Agent”切换开关。此外,还可以选择“启用 Healing Agent 自我修复”选项,以便 Healing Agent 独立修复作业执行问题。有关 Healing Agent 及其功能的详细信息,请参阅 Healing Agent 文档。
在作业恢复时保持帐户/计算机分配
此设置可用于配置是否在同一帐户-计算机对上执行长时间运行作业的不同片段。
默认情况下,暂停的作业将在任何可用计算机上的任何可用机器人上恢复。
根据您的许可证或资源要求,您可以选择在启动作业的同一台计算机上和相同的帐户上下文中恢复作业。
假设您需要 SAP 许可证才能执行作业。您可以在单台计算机上安装 SAP 许可证,并使用该计算机来启动和继续作业,而不必在每台可用的计算机上安装 SAP 许可证(这样会增加成本)。相同的策略可能适用于用户许可证。您只能分配一个用户许可证,并使用它来执行作业。
计划结束作业执行
流程执行有时可能会出错,从而导致作业保持挂起状态。 打开切换开关后,您可以(单击以展开):
- 从下拉菜单中选择“停止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“终止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试强制结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“停止”,并启用“如果作业未停止,则计划自动‘终止’”选项 - 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行,然后在作业一直处于“正在停止”状态以来经过已定义的时间间隔后尝试强制结束作业(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
在作业停留在待处理状态或已恢复状态时生成警示
通过打开切换开关,您可以激活有关保持挂起或恢复状态超过指定持续时间的作业的警示。
可配置的持续时间最短为一分钟,最长为十一天。
如果作业时长超过配置的持续时间,则会弹出“错误”严重性警报,并使用以下文本通知您:
"#process {process_number} 的 N 个作业已挂起或恢复超过 X 小时 Y 分钟。", 其中:
- N - 触发警示的作业编号
- {process_number} - 流程标识符
-
X - 作业处于挂起或已恢复状态时超出的配置小时数;天将转换为小时。
- Y - 作业处于挂起或已恢复状态时超过的配置分钟数。
如果作业已开始但尚未完成,则生成警示
通过打开开关,您可以激活有关未在指定持续时间内完成的作业的警示。
可配置的持续时间最短为一分钟,最长为十一天。
如果作业时长超过配置的持续时间,则会弹出“错误”严重性警报,并使用以下文本通知您:
“#process {process_number} 的作业已运行超过 X 小时 Y 分钟”,其中:
- {process_number} - 流程标识符
-
X - 作业尝试完成时超出的配置小时数。天将转换为小时。
- Y - 作业尝试完成时超出的配置分钟数。
Orchestrator 会阻止使用无效配置启动作业。尝试在无效的设置中启动作业会导致显示描述性错误消息,为您提供有关如何修复配置的详细信息。
使用动态分配(即不指定计算机或帐户)和不兼容的文件夹设置开始作业会导致错误。请务必更正设置,否则作业将无限期保持待处理状态。例如,当文件夹中只有跨平台模板时,尝试运行 .NET Framework 4.6.1 后台作业将会失败,因为在修复配置之前,作业将保持待处理状态。
添加参数
在“开始作业”窗口的“runtime 参数”部分,配置以下设置:
-
选择入口点。如果流程不支持多个入口点,Orchestrator 将在“入口点”下拉列表中显示“默认”,您无法进行选择。
有关详细信息,请参阅“入口点”。
-
为选定流程提供输入参数。该表格将自动填充选定流程接受的所有输入参数以及继承自包的对应值。
注意:作业参数不得超过 10,000 个字符。
如果
Robots without credentials cannot run processes that require an interactive session.
错误,无需用户界面交互,您可以使用 Studio 项目设置中的“在后台启动”选项。
开始智能体作业
在执行以下步骤之前,您需要创建一个流程。
- 在流程所在的文件夹中导航到“自动化”,然后选择“作业”。
- 单击“开始”。系统将显示“开始作业”窗口。
- 从“流程名称”下拉列表中,选择一个先前已部署到当前文件夹的流程。要仅在显示下拉列表中显示智能体,请使用筛选类型筛选器,然后选择智能体。
- 配置必填字段,如下面的部分所述。
- 单击开始。“开始作业”窗口将关闭,系统将根据您进行的设置开始作业。作业状态将实时显示在“作业”页面上。
配置执行目标
在“开始作业”窗口的“执行目标”选项卡中根据需要设置选项,配置您的执行目标。
计划结束作业执行
流程执行有时可能出现错误,导致作业保持待处理状态。打开切换按钮,则可以:
- 从下拉菜单中选择“停止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“终止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试强制结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“停止”,并启用“如果作业未停止,则计划自动‘终止’”选项 - 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行,然后在作业一直处于“正在停止”状态以来经过已定义的时间间隔后尝试强制结束作业(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
如果作业已开始但尚未完成,则生成警示
通过打开开关,您可以激活有关未在指定持续时间内完成的作业的警示。
可配置的持续时间最短为一分钟,最长为十一天。
如果作业时长超过配置的持续时间,则会弹出“错误”严重性警报,并使用以下文本通知您:
“#process {process_number} 的作业已运行超过 X 小时 Y 分钟”,其中:
- {process_number} - 流程标识符
- X - 作业尝试完成时超出的配置小时数。天将转换为小时。
- Y - 作业尝试完成时超出的配置分钟数。
Orchestrator 会阻止使用无效配置启动作业。尝试在无效的设置中启动作业会导致显示描述性错误消息,为您提供有关如何修复配置的详细信息。
帐户
您可以选择以下方法之一:
- 指定帐户意味着系统将在该特定用户或机器人帐户下执行流程。
- 如果未指定帐户,则 Orchestrator 会动态分配帐户。
为编码智能体作业定义环境配置
要为编码智能体作业指定环境变量,请使用“环境配置”文本字段。编码智能体在用户界面中显示为(智能体 - <programming language>)。
您可以使用以下方法之一,使用“环境配置”字段引用密码,例如 API 密钥:
- 直接在“环境配置”字段中输入密码值,如以下示例所示:您可以在以下场景中显示星号而非密码值,以此增强密码的安全性。
SECRET=Abc@123
SECRET=Abc@123- 使用从基础流程继承的环境配置启动作业。
- 重新启动作业。
ACCESS_KEY
API_KEY
AUTH
CREDENTIALS
PASSWORD
PRIVATE_KEY
SECRET
SESSION
TOKEN
- 引用与智能体位于同一文件夹中的密码类型资产,如以下示例所示:
MySecret=%ASSETS/SECRET%
MySecret=%ASSETS/SECRET%备注:- 在密钥后键入
=%
,会显示ASSETS/
自动补全建议。接受建议后,将显示一个资产下拉列表,您可以在其中选择所需的项目。 - 使用断开连接的凭据代理时,无法从外部凭据存储区中检索密码。
- 在密钥后键入
添加参数
如果包具有输入和/或输出参数,这些参数将显示在“输入”和“输出”选项卡下的“runtime 参数”部分。参数值继承自包,但您可以根据需要对其进行编辑。
开始智能体流程作业
在执行以下步骤之前,您需要创建一个流程。
- 在流程所在的文件夹中导航到“自动化”,然后选择“作业”。
- 单击“开始”。系统将显示“开始作业”窗口。
- 从“流程名称”下拉列表中,选择一个先前已部署到当前文件夹的流程。要仅在下拉列表中显示智能体流程,请使用“筛选类型”筛选器,然后选择“智能体流程”。
- 配置必填字段,如下面的部分所述。
- 单击开始。“开始作业”窗口将关闭,系统将根据您进行的设置开始作业。作业状态将实时显示在“作业”页面上。
配置执行目标
在“开始作业”窗口的“执行目标”选项卡中根据需要设置选项,配置您的执行目标。
计划结束作业执行
流程执行有时可能会出错,从而导致作业保持挂起状态。 打开切换开关后,您可以(单击以展开):
- 从下拉菜单中选择“停止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“终止”- 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试强制结束执行(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
- 从下拉菜单中选择“停止”,并启用“如果作业未停止,则计划自动‘终止’”选项 - 这会在作业一直处于“待处理”状态以来经过已定义的时间间隔后尝试正常结束执行,然后在作业一直处于“正在停止”状态以来经过已定义的时间间隔后尝试强制结束作业(可设置的最短时间为 1 分钟,最长时间为 10 天 23 小时 59 分钟)。
如果作业已开始但尚未完成,则生成警示
通过打开开关,您可以激活有关未在指定持续时间内完成的作业的警示。
可配置的持续时间最短为一分钟,最长为十一天。
如果作业时长超过配置的持续时间,则会弹出“错误”严重性警报,并使用以下文本通知您:
“#process {process_number} 的作业已运行超过 X 小时 Y 分钟”,其中:
- {process_number} - 流程标识符
- X - 作业尝试完成时超出的配置小时数。天将转换为小时。
- Y - 作业尝试完成时超出的配置分钟数。
Orchestrator 会阻止使用无效配置启动作业。尝试在无效的设置中启动作业会导致显示描述性错误消息,为您提供有关如何修复配置的详细信息。
帐户
您可以选择以下方法之一:
- 指定帐户意味着系统将在该特定用户或机器人帐户下执行流程。
- 如果未指定帐户,则 Orchestrator 会动态分配帐户。
添加参数
如果包具有输入和/或输出参数,这些参数将显示在“输入”和“输出”选项卡下的“runtime 参数”部分。参数值继承自包,但您可以根据需要对其进行编辑。
通过 API 触发器启动作业
您可以从所选的第三方应用程序中通过 API 触发器启动作业。请执行以下步骤:
速率限制
对于每个已启动的作业,可向状态端点发出的请求数限制为每 10 秒 10 个。
待定作业限制
通过 API 触发器启动的待处理作业的最大数量为 100 个。您可以在“触发器”>“API 触发器”>“待处理作业数量上限”租户级别设置中更改此限制,此限制的默认值为 10。
从作业的“更多操作”菜单中,选择“停止”。Orchestrator 将作业的状态标记为“正在停止”,并向机器人发送通知,但自动化项目将继续执行。
true
结果。您可以将此结果作为标记,以确定何时调用“停止作业”活动,从而启动正常关闭流程。
如果未找到“停止作业”活动,作业执行在项目结束时才会停止。最终作业状态为“成功”。
- 从 Orchestrator 启动的作业只能从 Orchestrator 停止。
- 从 Assistant 启动的作业既可以从 Orchestrator 的“作业”页面停止,也可以使用 UiPath™ Assistant 停止。
- 作业已停止后,作业结束计划将丢失,您需要在重新启动作业时重新配置“计划结束作业执行”选项。
单击相应的更多操作按钮,然后单击终止。自动化项目被强制停止,该作业被标记为已停止,并且作业详细信息窗口中显示作业“已取消”。
- 从 Orchestrator 启动的作业既可以从 Orchestrator 的“作业”页面终止,也可以使用 UiPath Assistant 终止。
- 从 Assistant 启动的作业既可以从 Orchestrator 的“作业”页面终止,也可以使用 UiPath Assistant 终止。
- 作业被终止后,作业结束计划将丢失,您需要在重新启动作业时重新配置“计划结束作业执行”选项。
此功能使您可以快速从作业列表运行作业,而无需完成作业配置流程。您可以重新开始任何处于最终状态(已停止、发生故障或成功)的作业。
- 您无法重新启动由代理程序(例如 Assistant)或通过 Studio 远程调试会话触发的作业。
- 当您重新启动已启用“计划结束作业执行”选项的作业时,您需要重新配置这些选项。
此过程首先假设您先前启动了已达到最终状态的作业。
- 单击相应的更多操作按钮,然后单击重新启动。系统将显示开始作业窗口,其中包含作业的初始设置。
- 进行所需的更改。
- 单击“开始”。“开始作业”窗口将关闭,作业会开始执行。作业状态实时显示在“作业”页面上。
-
当侧面板打开时,您可以单击列表中的任何作业以显示其面板中包含的所有选项卡的特定详细信息。作业列表网格可以水平滚动,同时根据您的特定屏幕尺寸和分辨率,让“流程”列保持固定。请注意,您可以增加某些列的大小,从而显示滚动条以便于访问。
-
您可以单击任何选项卡右上角的展开图标,以将其作为完整大小的窗口打开,并在面包屑导航中标明基础流程的名称。同一角落的“折叠”按钮可将窗口恢复到侧面板状态。
-
作业详细信息不包括失败的作业的许可注意事项。请使用监控功能获取有关许可证的详细信息。
要查看有关特定作业的详细信息,请单击相应的“详细信息”按钮。这将显示一个包含“作业详细信息”部分的侧面板,为您提供各种信息,例如:
- 基础包的名称
- 用于执行作业的入口点
- 执行机器人和计算机
- 作业开始时间和结束时间
- 作业持续时间
- 作业失败的原因
- 作业无法开始的原因
- 用于修复任何问题并触发作业开始的操作
在 SAP 租户的上下文中,您可以使用“返回到 SAP”按钮返回到 SAP Build Process Automation 中的流程。
智能体追踪
For agent and agentic process jobs, the job details panel includes a Trace tab. The trace provides a comprehensive, hierarchical view of the job run, its input and output, as well as any other resources invoked or jobs executed in connection with the run. The trace view also allows you to provide positive or negative feedback, as well as comments, on any of the trace items.
在追踪视图中,当您切换“显示原始数据”选项时,可以使用键盘快捷键折叠或展开某个部分:
- 要折叠一个部分,请在 Windows 或 Linux 计算机上使用
Ctrl
+Shift
+[
快捷键,在 macOS 计算机上使用Cmd
+Option
+[
快捷键。 - 要展开一个部分,请在 Windows 或 Linux 计算机上使用
Ctrl
+Shift
+]
快捷键,在 macOS 计算机上使用Cmd
+Option
+]
快捷键。
For agent jobs, feedback added in the Trace view is automatically available in the Agents Evaluations panel during design time, allowing you to create evaluations from job runs, edit them, and refine your agent based on manually entered feedback. Read more about Evaluations.
要查看特定作业的日志,请单击相应的“详细信息”按钮。这将显示一个侧面板,其中包括“日志”部分,以及有关所选作业的数据。
要手动刷新作业日志,请在作业侧面板的“日志”部分选择“刷新”按钮。
对于既不处于“待处理”状态也不处于最终状态的作业,您可以选择以 10 秒为间隔自动刷新作业日志。要启用该选项,请在作业侧面板的“日志”部分中选择“刷新”旁边的下拉列表,然后选择“启用自动刷新”。“刷新”按钮会更改外观以确认您的选择。即使刷新浏览器窗口,该选项也会在以后的作业中保留。
作业日志会自动刷新,直到作业达到最终状态后的一分钟为止。此时,您无法再选择“启用自动刷新”,手动刷新日志成为唯一可用的选项。
要查看恢复暂停的作业所需的触发器,请单击相应的“详细信息”按钮。这将显示一个包括“恢复条件”选项卡的侧面板,其中包含为所选作业配置的工作流任务的详细信息。
您可以单击列表以访问其他作业的触发器。
要查看作业执行的视频录制以及基础日志,请单击相应的“详细信息”按钮。这将显示一个侧面板,其中包括“视频时间线”选项卡,顶部是视频窗格,底部是日志列表。
您也可以通过单击同一面板的“日志”选项卡上的“打开录制”来访问此选项卡。
有关详细信息,请参阅视频录制专用主题。
要下载出现故障的作业的记录,请单击“更多选项”>“下载录制”。将下载根据您的设置生成的执行介质。