配置本地部署机器人代理

机器人代理的默认配置是在安装过程中设置的。在使用机器人代理之前，请查看配置设置并确保它们适合贵组织。特别要确保适当设置了已允许文件上传。

说明

本主题中的信息仅适用于使用本地部署机器人代理在 ACL 机器人中运行 ACL 脚本的组织。

拥有 ACL Robotics 专业版的个人和组织没有本地部署的机器人代理。在 HighBond 机器人或工作流机器人中运行的 Python/HCL 脚本不使用机器人代理。

在哪里指定配置设置

您可以在两个位置指定机器人代理配置设置：

机器人中的代理管理屏幕
Windows 服务器上机器人代理安装目录中的 Agent.exe.config 文件

在代理管理屏幕中配置设置

说明

代理管理屏幕中的配置设置，会应用于多代理聚类中的所有代理。

在平台主页页面 (www.diligentoneplatform.com) 中，选择机器人应用程序以将其打开。
如果您已经进入 Diligent One，可以使用左侧导航菜单切换到机器人应用程序。
在仪表盘的右上角，单击设置。
在左侧窗格中，确保选择了代理管理。
在配置下，在已允许文件上传中选择适当选项。
允许的文件上传控制将哪些输出结果从机器人代理上传到云端的机器人应用程序：
- 仅限结果文件和日志
  如果在分析标头中进行了相应说明，则将上传结果文件（如 Excel 文件）和日志。您还可以手动将相关文件上传到机器人的输入/输出选项卡。
- 结果表、文件和日志
  如果在分析标头中进行了相应说明，则将上传 Analytics 结果表、结果文件（如 Excel 文件）和日志。您还可以手动将相关文件上传到机器人的输入/输出选项卡。
- 不允许文件上传
  无法通过脚本或用户手动上传任何文件。带有 //RESULT FILE 或//RESULT LOG 标记的分析脚本将无法运行。
  若要在任何情况下都阻止任何文件类型的上传，您还必须将机器人代理中的 AllowUploadsOnFailure 配置设置设为 false。
说明
无论您在允许的文件上传中选择哪个选项，机器人任务失败后日志文件的上传均受机器人代理中的 AllowUploadsOnFailure 配置设置控制。有关详细信息，请参阅。
在配置下，为路径配置指定适当的目录，然后单击保存。
- 数据存储
  Windows 服务器或网络目录，用于永久存储由带有 //DATA 标记的分析脚本输出的 Analytics 数据表。
  单独的数据表目录，可以为仅定期访问的大型文件指定更经济的冷存储位置。
- 结果路径
  Windows 服务器或网络目录，用于由带有 //RESULT TABLE 标记的分析脚本输出的 Analytics 结果表。
重要信息
您在配置下指定的一个或多个目录必须可供机器人代理访问，或者如果您使用的是多代理群集，则必须可供所有代理访问。对于指定的每个目录，运行该代理的服务账户必须具有读/写/列举权限。有关详细信息，请参阅本地部署机器人代理安全性。

在 Agent.exe.config 文件中配置设置

要更新配置设置，请编辑机器人代理安装目录中的 Agent.exe.config 文件，然后重启 Robots Agent Windows 服务。

配置文件的默认位置是：

C:\Program Files (x86)\ACL Software\Robots Agent\agent\Agent.exe.config。

说明

您必须重新启动机器人代理服务，才能使更改生效。

对于多代理安装，必须更新 Agent.exe.config 文件，然后在每个 Windows 服务器上重新启动机器人代理服务。每个代理的配置设置可能相同，也可以不同，具体取决于您的特定需求。

Agent.exe.config 中的配置属性

密钥	值
RuntimeBasePath	该基本文件夹用于：临时分析作业文件夹由带 //RESULT FILE 标记的分析脚本输出的非 Analytics 结果文件由带 //RESULT LOG 标记的分析脚本输出的 Analytics 日志文件由失败的分析脚本输出的 Analytics 日志文件默认的基本文件夹是 C:\acl\robots\data\ 一个单独的运行时基本文件夹，允许您在一个更快的高性能设备，如固态驱动器（SSD），上进行分析作业处理。带有用户配置基本文件夹的分析作业文件夹的完整路径示例：E:\acl\robots\runtime\Production\Robot12\Task1\Run29\Temp
DataBasePath	该基本文件夹用于永久存储由带 //DATA 标记的分析脚本输出的 Analytics 数据表。默认的基本文件夹是 C:\acl\robots\data\ 为 Analytics 数据表设置单独的基础文件夹，可让您为仅定期访问的大型文件指定更经济的冷存储位置。具有用户配置基本文件夹的数据文件文件夹的完整路径示例：D:\acl\robots\data\Production\Robot12\Data 说明如果 DataBasePath 与机器人中代理管理界面的数据存储设置所指定的值不同，则代理管理界面中的值具有优先权。有关详细信息，请参阅。
ResultsBasePath	该基本文件夹用于由带 //RESULT TABLE 标记的分析脚本输出的 Analytics 结果表。默认的基本文件夹是 C:\acl\robots\data\ 包含用户配置基本文件夹的结果文件夹的完整路径示例：C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions 说明如果 ResultsBasePath 与机器人中代理管理界面的结果路径设置指定了不同的值，则代理管理界面中的值优先级更高。有关详细信息，请参阅。
AclSEProfileBase	当使用机器人数据服务从 Analytics 连接到机器人代理时，用于处理表的基础文件夹。默认的基本文件夹是 C:\acl\robots\aclse\
LogFile	机器人代理日志文件的文件路径和名称。默认路径和名称是 C:\acl\robots\logs\application.log
EnginePath	运行任务的可执行文件的文件路径。默认位置是 C:\Program Files (x86)\ACL Software\Robots Agent\AclScript.exe
KeepJobFolder	指定在机器人任务失败后是否保留临时分析作业文件夹。 true任务失败后保留临时分析作业文件夹 false任务失败后删除临时分析作业文件夹默认值为 false。说明机器人任务成功后，KeepJobFolder 设置将会失效。成功执行任务后，会自动删除临时分析作业文件夹。注意可以将该值设置为true以保留文件进行故障排除。将该值永久设置为true可能会导致服务器硬盘或固态驱动器空间不足。
AllowExecuteCommand	指定当分析脚本中出现两个 ACL脚本命令（EXECUTE 和 AICOMMAND）时，机器人代理该如何处理。 true命令会被处理 false命令不会被处理，且包含任一命令的脚本将执行失败默认值为 false。将向日志中写入一条消息，解释失败的原因。
MaxLogSizeKB	在文件归档并创建新日志文件之前，机器人代理日志文件的最大大小。默认值为 102400 (100 MB)。当前日志文件是 application.log。存档的日志文件与当前日志文件保存在同一个文件夹中，并赋予递增的数字后缀：application.0.log、application.1.log 等。
SkipPathAccessCheck	控制机器人代理在读取或写入表或文件时可以访问哪些文件夹。 true不检查文件夹访问权限。由机器人代理运行的脚本可以读取或写入任何 ACL 机器人中的表或文件。 false检查文件夹访问权限。由机器人代理运行的脚本仅能读取或写入与脚本处于相同机器人中的表或文件。默认值为 false。将值设置为 true 然后跳过文件夹权限检查，这可能会提高机器人代理在某些环境中运行脚本时的性能。您还能跨机器人执行读取或写入操作。注意限制脚本可以访问哪些文件夹是一项机器人安全功能，可防止意外或故意的访问数据违规行为。仅当您确定允许 ACL 脚本读取或写入任何 ACL 机器人中的表或文件不会带来安全风险时，才将该值设置为 true。说明 SkipPathAccessCheck 设置不影响在机器人之间共享和链接特定 Analytics 数据表的能力。有关详细信息，请参阅在 ACL 机器人中共享和链接数据表。
AllowUploadsOnFailure	指定当机器人任务失败时，是否将 Analytics 结果日志从机器人代理上传到云端的机器人应用程序。 true任务失败后上传日志文件 false任务失败后不上传日志文件默认值为真。说明如果 Agent.exe.config 文件中没有 AllowUploadsOnFailure 属性，请手动添加该属性，并根据组织的要求将值设置为 true 或 false。例如： <add key="AllowUploadsOnFailure" value="true"></add>

配置机器人代理以配合特定的代理服务器使用

您可以手动配置机器人代理，以使用您指定的代理服务器连接到机器人应用程序。要执行该手动配置，您需要执行以下操作：

向 Agent.exe.config 文件添加一个附加的节
更新两个附加的配置文件：AgentService.exe.config 和 Worker.exe.config

步骤

在安装了机器人代理的服务器上，转到机器人代理安装目录。
该安装目录的默认位置为：
C:\Program Files (x86)\ACL Software\Robots Agent\agent\
请参考下表，更新 \agent 子文件夹中的配置文件。
保存所有文件后，重启 Robots Agent Windows 服务，开始机器人代理与机器人应用程序之间使用指定代理服务器的通信。

说明

可以使用不同的代理服务器配置设置。下面的配置信息示例可能与您的要求不完全匹配。有关详细信息，请参阅 Microsoft 技术文档：

文件名	配置信息
Agent.exe.config	通过在该示例中显示的位置添加<system.net>节更新此文件。为您的组织替换适当的代理服务器地址和端口。 useDefaultCredentials="true" 指定使用运行机器人代理 Windows 服务的账户的凭据来访问代理服务器。 <?xml version="1.0" encoding="utf-8"?> <configuration> <appSettings> <other configuration settings> </appSettings> <system.net> <defaultProxy useDefaultCredentials="true"> <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" /> </defaultProxy> </system.net> </configuration>
AgentService.exe.config Worker.exe.config	在这两个文件中，根据下方显示的示例更新 <defaultProxy> 部分。为您的组织替换适当的代理服务器地址和端口。 useDefaultCredentials="true" 指定使用运行机器人代理 Windows 服务的账户的凭据来访问代理服务器。 <?xml version="1.0" encoding="utf-8"?> <configuration> <system.net> <defaultProxy useDefaultCredentials="true"> <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" /> </defaultProxy> </system.net> </configuration>

文件名

配置信息

Agent.exe.config

通过在该示例中显示的位置添加<system.net>节更新此文件。

为您的组织替换适当的代理服务器地址和端口。
useDefaultCredentials="true" 指定使用运行机器人代理 Windows 服务的账户的凭据来访问代理服务器。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <other configuration settings>
    </appSettings>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

AgentService.exe.config

Worker.exe.config

在这两个文件中，根据下方显示的示例更新 <defaultProxy> 部分。

为您的组织替换适当的代理服务器地址和端口。
useDefaultCredentials="true" 指定使用运行机器人代理 Windows 服务的账户的凭据来访问代理服务器。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

配置本地部署 机器人代理