机器人管理员指南

上次更新日期 2025年11月22日

配置文件

编辑配置文件后，您需要重新启动相关的 Robot 组件以使更改生效。以下列表根据机器人的安装模式总结了如何重新启动多个组件。

请记得在重新启动之前保存任何正在进行的工作，避免丢失任何未保存的进度。

机器人服务
- 服务模式安装
  1. 打开“任务管理器”>“服务”。
  2. 查找 UiPathRobotSvc 服务。
  3. 右键单击该服务，然后选择“重新启动”。
- 用户模式安装 - 退出，然后重新启动 Assistant，或者：
  1. 打开“任务管理器”>“详细信息”。
  2. 选择 UiPath.Service.UserHost.exe 流程。
  3. 选择“结束任务”。
更新服务
1. 打开“任务管理器”>“服务”。
2. 查找 UiPath.UpdateService.Agent 服务。
3. 右键单击该服务，然后选择“重新启动”。
UiPath RobotJS 服务主机
1. 打开“任务管理器”>“服务”。
2. 查找 UiPath.RobotJS.ServiceHost 服务。
3. 右键单击该服务，然后选择“重新启动”。
UiPath Assistant
1. 在 Assistant 中，选择“首选项”，然后选择“退出”。
2. 重新启动 Assistant。
微件- 重新启动 Assistant，或者：
1. 右键单击任务栏中的 Assistant 图标。
2. 选择重新加载微件

uipath.config

UiPath.config 文件包含机器人的基本配置参数。作为管理员，您可以通过编辑配置文件中的参数列表来自定义机器人的行为。

备注：

每个环境可能都需要特定的通知，因此 UiPath 可让您根据机器人的当前环境（无论是开发、临时环境还是生产环境）应用不同的配置。编辑此文件时请务必小心，因为配置不正确可能会导致应用程序出现问题。

访问文件

安装机器人时，系统会创建 UiPath.config 文件。

要访问它，请导航到 C:\Program Files\UiPath\Studio\UiPath.config。

可自定义的设置

UiPath.config 文件包含以下参数：

在connectionSettings配置部分中
- DefaultServiceUrl （字符串）- 设置机器人用于连接到 Orchestrator 的默认地址。示例：
```
string DefaultServiceUrl = "https://cloud.uipath.com"string DefaultServiceUrl = "https://cloud.uipath.com"
```
- AutoSignIn (bool) - 启用 Assistant 的自动登录功能。默认值为false 。示例：
```
bool AutoSignIn = true.bool AutoSignIn = true.
```
- EnforceDefaultServiceUrl (bool) - 向所有用户强制执行以DefaultServiceUrl提供的地址。默认值为false 。示例：
```
bool EnforceDefaultServiceUrl = true.bool EnforceDefaultServiceUrl = true.
```
在communicationSettings配置部分中
- MaxMessageSizeInMegabytes （字节）- 设置系统可以发送或接收的最大消息大小（以 MB 为单位）。默认值为10 。
  
  这用于防止由于处理的消息太大而导致的超载或流程崩溃。示例：
```
byte MaxMessageSizeInMegabytes = 10;byte MaxMessageSizeInMegabytes = 10;
```
- InstallPackageTimeout （时间跨度）- 设置包安装的时限。默认值为 20 分钟。
  
  如果包安装所需的时间长于定义的时间，系统将中止安装。示例：
```
TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
```
- RequestTimeout （时间跨度）- 定义系统等待通信响应的时长。默认值为 40 秒。
  
  如果系统未在设置的时间内收到响应，它将停止等待并继续工作。这可以防止系统挂起。示例：
```
TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
```
在packageSettings配置部分中
- PackagesInstallationFolder （字符串）- 设置安装包的默认目录。默认值为C:\UiPath\Packages 。
- SkipHttpConfigurationSources (bool) - 使系统能够忽略通过 HTTP 配置的包来源，例如 NuGet 订阅源。默认值为false 。
  
  这意味着系统不会从这些来源检索包，这在来源不可靠或不安全时非常有用。
- DisableSecureXaml (bool) - 允许机器人运行可能不安全的工作流。默认值为false 。
- DirectDownload (bool) - 允许直接下载包，而不提示用户。默认值为false 。
- PackageSaveWithoutNupkg (bool) - 允许保存不带.nupkg文件的包。默认值为false 。
  
  这有助于减小下载大小。
在analyticsSettings配置部分中
- Telemetry.Enabled (bool) - 允许 UiPath 收集和发送使用情况数据以进行分析。默认值为false 。
在robotCacheSettings配置部分中
- SessionCacheDuration （时间跨度）- 定义特定会话的数据被丢弃之前在缓存中保留的时间。默认值为 30 秒。
  
  这对于重用（而不是重新创建或重新提取）变量值或操作详细信息等数据非常有用。示例：
```
TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
```
- GetResourceUrlCacheDuration （时间跨度）- 定义资源（例如 API 或网页）的 URL 在缓存中存储的时间。默认值为一 (1) 小时。
  
  在机器人需要定期访问某些资源的情况下，这对于优化性能非常有用。示例：
```
TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
```
在robotJsSettings配置部分中
- ListenerPort (int) - 设置 Robot.js 监听用于传入连接的端口号。默认值为2323 。
  
  这可让机器人服务与在本地或远程服务器上运行的网页应用程序交互。示例：
  int ListenerPort = 2323;int ListenerPort = 2323;
- TokenExpiryInDays (int) - 设置机器人服务生成的身份验证令牌的有效期（以天为单位）。默认值为 30 天。
  
  机器人服务在与其他软件组件或服务交互时使用这些令牌对自身进行身份验证。示例：
  int TokenExpiryInDays = 30;int TokenExpiryInDays = 30;
- AllowUrlList （字符串）- 设置机器人服务可以访问的 URL 列表。这有助于确保机器人服务仅与已批准的服务交互。示例：
  string AllowUrlList = "https://cloud.uipath.com";string AllowUrlList = "https://cloud.uipath.com";

重要提示：

在进行任何更改之前，请始终创建原始 UiPath.config 文件的备份。如果出现问题，这有助于恢复原始设置。
如要应用对 UiPath.config 文件进行的更新，请重新启动 UiPath 服务或系统。
UiPath.config 文件中的本地设置优先于在 Orchestrator 中配置的设置。
为了提高安全性，可以加密 UiPath.config 文件中的敏感数据。

UiPath Robot 系统变量

可以通过系统环境变量配置进一步的自定义行为。

重要提示：

修改任意系统变量后，请重新启动机器人服务。

以下列表总结了最常见的用例：

UIPATH_SESSION_TIMEOUT - 更改创建交互式会话时默认的 60 秒超时。根据与之交互的系统的性能和加载时间调整此值，以调整机器人的行为。

示例：
```
UIPATH_SESSION_TIMEOUT=75UIPATH_SESSION_TIMEOUT=75
```
UIPATH_PIP_SESSION_TIMEOUT - 更改在机器人会话中启动流程时默认的 180 秒超时。

示例：
```
UIPATH_PIP_SESSION_TIMEOUT=60UIPATH_PIP_SESSION_TIMEOUT=60
```
UIPATH_LANGUAGE - 设置机器人操作所用的语言。优先级如下：
1. UIPATH_LANGUAGE 值
2. 计算机环境变量
3. 当前线程用户界面文化
4. 默认 UiPath 语言（英语）
示例：
```
UIPATH_LANGUAGE=FrenchUIPATH_LANGUAGE=French
```
UIPATH_HEADLESS_WITH_USER - 使用先前在 Orchestrator 中配置的特定用户的凭据。

示例：
```
UIPATH_HEADLESS_WITH_USER=TrueUIPATH_HEADLESS_WITH_USER=True
```
UIPATH_PRE_LOADED_EXECUTOR - 默认情况下，会在机器人启动时启动预加载的执行程序。要更改此行为并仅在第一个流程运行时启动预加载的执行程序，请将此变量设置为None 。

示例：
```
UIPATH_PRE_LOADED_EXECUTOR=NoneUIPATH_PRE_LOADED_EXECUTOR=None
```
UIPATH_DISABLE_PRE_LOADED_EXECUTOR - 禁用预加载的执行程序功能。

示例：
```
UIPATH_PRE_LOADED_EXECUTOR=NoneUIPATH_PRE_LOADED_EXECUTOR=None
```
UIPATH_ROBOTJS_ALLOWLIST - 在机器人 JS SDK 和机器人执行程序之间建立连接时，自动接受机器人同意对话框。

该变量接受用分号分隔的自定义应用程序 URL。如果端口号与标准端口（80 或 443）不同，请在 URL 中包含该端口号。

示例：
```
UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
```
UIPATH_DNS_MACHINENAME - 允许在创建 RDP 会话时使用本地主机的 DNS 主机名。要在对 RDP 使用 Kerberos 身份验证的环境中执行 Unattended 作业，请将此值设置为 True。

示例：
```
UIPATH_DNS_MACHINENAME=TrueUIPATH_DNS_MACHINENAME=True
```
NUGET_FALLBACK_PACKAGES - 配置回退包文件夹的路径。使用分号分隔多个路径。

如果没有此变量，机器人会在 Nuget.config 文件中搜索回退包文件夹。
NUGET_SCRATCH - 允许同一台计算机上的多个用户模式机器人共享用于存储包的本地路径。

该值必须是不同于 Nuget 安装文件夹的路径，并且充当 NuGet 的临时文件夹。

注意：应只有NUGET_SCRATCH变量使用配置的临时文件夹。

示例：
```
NUGET_SCRATCH=C:\NuGetTempFolderNUGET_SCRATCH=C:\NuGetTempFolder
```
UIPATH_PRESERVE_CREDENTIALS_CASE - 保留日志记录凭据（域\用户名）的原始大小写。

示例：
```
UIPATH_PRESERVE_CREDENTIALS_CASE = TrueUIPATH_PRESERVE_CREDENTIALS_CASE = True
```
UIPATH_SESSION_BEHAVIOR - 配置会话还原在作业完成后的行为方式。可选择以下选项：
- TryReuseAndRestoreSession — 默认选项。尝试重用会话，并在作业完成后将其恢复到先前的状态。如果没有可以重复使用的初始会话，则会在还原时注销。
- ForceNew — 创建一个全新的会话，无论之前的会话状态如何。始终在还原时注销。
- LeaveSessionActive — 防止恢复初始会话状态。
- LeaveSessionDisconnected — 还原时始终断开会话。
示例：
```
UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnectedUIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
```
UIPATH_HTTP_CONNECTION_LIFETIME - 定义关闭并刷新与 Orchestrator 的连接之前将其保持打开状态的时长。默认时长为 30 分钟，但要调整该值，请使用以秒为单位的值。

示例：
```
// to set 10 minutes                          
UIPATH_HTTP_CONNECTION_LIFETIME = 600// to set 10 minutes                          
UIPATH_HTTP_CONNECTION_LIFETIME = 600
```
UIPATH_FILE_LOG_LEVEL - 定义本地文件中使用的执行日志级别。这与用于 Orchestrator 的日志级别不同。可选择以下选项：
- 详情
- 追踪
- 信息
- Warning
- 错误
- 重要事项
- 关闭
示例：
```
// to set verbose level locally
UIPATH_FILE_LOG_LEVEL = Verbose// to set verbose level locally
UIPATH_FILE_LOG_LEVEL = Verbose
```
UIPATH_EXECUTOR_STARTUP_DELAY - 定义会话创建和执行程序启动之间的等待时间（以秒为单位）。当基础架构需要在开始执行自动化之前加载某些服务（VPN、安全）时，请使用此选项。

示例：
```
// to set the delay to 5 seconds
UIPATH_EXECUTOR_STARTUP_DELAY = 5// to set the delay to 5 seconds
UIPATH_EXECUTOR_STARTUP_DELAY = 5
```