配置文件

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

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

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

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"
	Bool AutoSignIn	为 Assistant 启用自动登录功能。	False	bool AutoSignIn = true.
	Bool EnforceDefaultServiceUrl	强制将提供的地址作为对所有用户的“默认服务 URL”。	False	bool EnforceDefaultServiceUrl = true.
communicationSettings	字节 MaxMessageSizeInMegabytes	设置系统可以发送或接收的最大消息大小（以 MB 为单位）。 这用于防止由于处理太大的消息而导致的超载或流程崩溃。	10 MB	byte MaxMessageSizeInMegabytes = 10;
	时间跨度 InstallPackageTimeout	设置包安装的时限。 如果包的安装时间超过定义的时间，系统将中止安装。 以时间跨度表示。	20 分钟	TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
	时间跨度 RequestTimeout	定义系统等待通信响应的时长。 如果系统未在设置的时间内收到响应，它将停止等待并继续工作。 这可以防止系统挂起。 以时间跨度表示。	40 秒	TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettings	字符串 PackagesInstallationFolder	设置安装包的默认目录。	C:\UiPath\Packages
	Bool SkipHttpConfigurationSources	使系统能够忽略通过 HTTP 配置的包来源，例如 NuGet 订阅源。 这意味着系统不会从这些来源检索包，这在来源不可靠或不安全时非常有用。	False
	Bool DisableSecureXaml	允许机器人运行可能不安全的工作流。	False
	Bool DirectDownload	允许直接下载包，而不提示用户。	False
	Bool PackageSaveWithoutNupkg	允许保存不带 .nupkg 文件的包。 这有助于减小下载大小。	False
analyticsSettings	Bool Telemetry.Enabled	允许 UiPath 收集和发送使用情况数据以进行分析。	False
webProxySettings	字符串 ScriptAddress	设置决定如何以及何时使用代理的脚本地址。
	字符串 ProxyAddress	设置代理服务器的地址（IP 或域名）。
	字符串 BypassList	包含绕过代理服务器直接连接到互联网的地址列表。
	Bool BypassLocalAddresses	允许绕过代理服务器直接连接本地地址。	False
	字符串 UserName	设置用于代理服务器身份验证的用户名凭据。
	字符串 Password	设置与用于代理服务器身份验证的用户名关联的密码。
	字符串 Domain	设置身份验证所必需的代理服务器所在的域。
robotCacheSettings	时间跨度 SessionCacheDuration	定义特定会话中的数据应在缓存中保留多长时间后被丢弃。 这对于重用（而不是重新创建或重新提取）变量值或操作详细信息等数据非常有用。 以时间跨度表示。	30 秒	TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
	时间跨度 GetResourceUrlCacheDuration	定义资源（例如 API 或网页）的 URL 在缓存中存储的时间。 在机器人需要定期访问某些资源的情况下，这对于优化性能非常有用。 以时间跨度表示。	1 小时	TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettings	整数 ListenerPort	设置 Robot.js 监听用于传入连接的端口号。 这可让机器人服务与在本地或远程服务器上运行的网页应用程序交互。	2323	int ListenerPort = 2323;
	整数 TokenExpiryInDays	设置机器人服务生成的身份验证令牌的有效期（以天为单位）。 机器人服务在与其他软件组件或服务交互时使用这些令牌对自身进行身份验证。	30 天	int TokenExpiryInDays = 30;
	字符串 AllowUrlList	设置机器人服务可以访问的 URL 列表。 这有助于确保机器人服务仅与已批准的服务交互。		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=75
UIPATH_PIP_SESSION_TIMEOUT	更改在机器人会话中启动流程时默认的 180 秒超时。	UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_USER_SERVICE_PATH	设置用户服务的安装路径。	UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
UIPATH_LANGUAGE	设置机器人的操作语言。 确定语言的顺序是： UIPATH_LANGUAGE 值 计算机环境变量 当前线程用户界面文化 默认 UiPath 语言（英语）	UIPATH_LANGUAGE=French
UIPATH_HEADLESS_WITH_USER	使用先前在 Orchestrator 中配置的特定用户的凭据。	UIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR	默认情况下，会在机器人启动时启动预加载的执行程序。 要更改此行为并仅在第一个流程运行时启动预加载的执行程序，请将此变量设置为 None。	UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	禁用预加载的执行程序功能。	UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST	在机器人 JS SDK 和机器人执行程序之间建立连接时，自动接受机器人同意对话框。 该变量接受用分号分隔的自定义应用程序 URL。如果端口号与标准端口（80 或 443）不同，请在 URL 中包含该端口号。	UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
UIPATH_DNS_MACHINENAME	允许在创建 RDP 会话时使用本地主机的 DNS 主机名。要在对 RDP 使用 Kerberos 身份验证的环境中执行 Unattended 作业，请将此值设置为 True。	UIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS	使机器人能够处理使用 Windows 凭据进行身份验证的代理配置。	UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES	配置回退包文件夹的路径。使用分号分隔多个路径。 如果没有此变量，机器人会在 Nuget.config 文件中搜索回退包文件夹。
NUGET_SCRATCH	允许同一台计算机上的多个用户模式机器人共享用于存储包的本地路径。 该值必须是不同于 Nuget 安装文件夹的路径，并且充当 NuGet 的临时文件夹。 备注： 应只有 NUGET_SCRATCH 变量使用已配置的临时文件夹。	NUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE	保留日志记录凭据（域\用户名）的原始大小写。	UIPATH_PRESERVE_CREDENTIALS_CASE = True
UIPATH_SESSION_BEHAVIOR	配置会话还原在作业完成后的行为方式。 可用的选项如下： TryReuseAndRestoreSession — 默认选项。尝试重用会话，并在作业完成后将其恢复到先前的状态。如果没有可以重复使用的初始会话，则会在还原时注销。 ForceNewSession — 创建一个全新的会话，无论之前的会话状态如何。始终在还原时注销。 LeaveSessionActive — 防止恢复初始会话状态。 LeaveSessionDisconnected — 还原时始终断开会话。	UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected