机器人用户指南

上次更新日期 2025年6月4日

自定义包文件夹和网络路径

包可以组合自动化中使用的所有部分，其中包括：活动、工作流、文件、数据源以及运行自动化所需的其他组件。在 Studio 中创建的项目将作为包发布到某个位置/订阅源，机器人稍后会从该位置/订阅源下载该项目，并用于运行自动化。

在 Studio 中，系统会默认配置以下位置/源：

Orchestrator 租户和 Orchestrator 主机
本地
正式
UiPath Marketplace

也可以使用自定义源，但是在设置自定义位置发布包之前，请确保机器人可以访问此位置。

重要事项：对于包位置，需要使用绝对路径。不支持相对路径。

有关订阅源工作原理及其更改方式的更多信息，请参阅详细介绍了此主题的“管理活动包”文档。

回退包文件夹

可以通过在机器人计算机上添加NUGET_FALLBACK_PACKAGES环境变量来配置回退包文件夹。这包含以分号;分隔的回退文件夹的绝对路径。如果环境变量不存在，机器人将尝试从Nuget.config文件读取 Nuget 包回退文件夹。

有关更多信息，请参阅回退文件夹文档。

重要提示：不支持在回退文件夹中部署流程，仅支持部署依赖项。

更改包的位置

包位置可以通过使用参数为 PACKAGES_FOLDER 的“设置命令行”或编辑 uipath.config 文件进行更改，以便您能够更改 Studio 和/或机器人工作流及其依赖项的下载位置。

重要提示：

需要重新启动！

对配置文件进行的任何更新都需要重新启动：

对于服务模式机器人：重新启动 UiPath 机器人服务。
对于用户模式机器人：通过重新启动设备或注销您的用户帐户后重新登录，重新启动用户服务。

通过命令行安装机器人时，如果不提供此参数，则默认文件夹为 %userProfile%\.nuget\packages。

可以使用 %USERNAME% 或 %USERPROFILE% 等环境变量，但需要通过以下方式转义：

使用命令行提示符调用安装时，可使用 UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%。

批处理脚本 - 使用 % - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%。

PowerShell 控制台或脚本 - 不需要转义。

在使用 Active Directory 域帐户时，建议您也在文件夹结构中使用域，例如 C:\packages\^%UserDomain^%.^%Username^%。

对多个机器人使用相同的路径

多个机器人可以使用相同的路径（本地文件夹或共享网络文件夹）来下载和执行自动化。

视位置和机器人部署类型而异，可能存在一些限制：

服务模式

本地路径

同一台计算机上的多个服务模式机器人使用本地路径不存在限制。

网络路径

在服务模式下部署机器人并使用安全 XAML 时，不支持网络路径。
安装在不同计算机上的服务模式机器人无法连接到网络上的同一文件夹。每台计算机都必须创建单独的文件夹。
仅支持非映射路径，例如 \\server\Packages。不支持映射的网络路径，例如 Z:\Packages。其原因在于如何按用户解析映射。在这种情况下，已安装文件的所有者是计算机帐户，因而无权访问每个用户的网络映射。

用户模式

本地路径

If the same local path is used by multiple user mode robots on the same machine, you must add the NUGET_SCRATCH machine environment variable on the robot machine. The value has to be a path to a folder other than the actual NuGet installation one. The folder set for the environment variable is used as a temporary folder for NuGet.

例如：

如果 uipath.config 文件中的 packagesInstallationFolder 参数为 C:\UiPath\Packages，则要允许多个用户模式机器人将相同的本地路径用于包，请创建一个新文件夹（例如 NuGetScratch），然后添加具有 C:\NuGetScratch 值的 NUGET_SCRATCH 计算机环境变量。

备注：

NuGetScratch 文件夹只能由 NUGET_SCRATCH 变量用作临时文件夹。
运行机器人的用户帐户必须对计算机上的两个文件夹具有读取和写入权限。

网络路径

使用网络路径时，路径必须包含计算机名称和用户名。

示例：

<packageSettings>
  <add key="packagesInstallationFolder" value="\\NetworkServer\SharedFolder\UiPath\Packages\" />
</packageSettings><packageSettings>
  <add key="packagesInstallationFolder" value="\\NetworkServer\SharedFolder\UiPath\Packages\" />
</packageSettings>