ScreenAgent适用于 Windows

如果您拥有以下许可证，则可以使用 ScreenAgent 关闭 NiCE ScreenAgent 是一种服务，在需要屏幕录制的坐席桌面上运行。：

  • CXone ACD (voice) 或 Third Party Telephony Providers

  • Screen Recording Basic 或 Advanced

在计算机上安装 ScreenAgent 可在交互过程中录制或监视坐席屏幕上的活动。 ScreenAgent 在后台运行，并根据录制策略（请参阅Recording）自动录制。 主管和评估员还可以在交互过程中监控坐席的活动。

为确保 Recording Workforce Engagement (WEM) 提供利用最新技术的无缝客户体验，请确保您正在使用受支持的 ScreenAgent 版本：

  • ScreenAgent for Windows 版本 3.0.22 或更高版本

  • ScreenAgent for MAC 版本 3.0.1 或更高版本

如果您正在使用较低版本的 ScreenAgent，则需要将所有用户升级到 ScreenAgent 3.0.x 版本。 旧版本不受支持，并且可能不会录制坐席的屏幕。

您可以在下载页面中找到最新版本的 ScreenAgent。

要使用 ScreenAgent 3.0.x 版本，请确保您已允许以下 FQDN：

  • 对于 FedRamp：cxone-gov.niceincontact.com

  • 对于所有其他地区：cxone.niceincontact.com

您可以将 ScreenAgent 安装在坐席的计算机上，或者安装在虚拟桌面基础架构 (VDI) 环境中： 支持的 VDI 包括：

  • VMware Horizon

  • Citrix Virtual Desktops（以前称为 XenDesktop）

  • Citrix Virtual Apps（以前称为 XenApp）- 仅在本地环境中受支持

  • 非永久 VDI 环境

  • 多会话环境

  • 终端服务器类型的 VDI 环境

  • AVD 远程应用程序（需要 VDI 远程应用程序规避方法）

VMware Horizon 不需要任何特殊配置。 对于其他 VDI 环境，请参阅先决条件。

您可以在安装之前或之后检查 ScreenAgent 连接。

对于配置了 100% 屏幕录制的租户，屏幕录制在坐席登录后最多 25 秒开始。在这 25 秒内，屏幕录制不会正常工作。

 

您可以观看一个视频，其中概述了在坐席的计算机上安装 ScreenAgent 的过程。 该视频介绍了先决条件和安装步骤。

For more information, see ScreenAgent 的常见问题解答.

有关先前 ScreenAgent 版本中添加的功能列表，请参阅 ScreenAgent：累积版本说明。

先决条件

在安装 ScreenAgent 之前，请确保：

  1. 勾选 连接要求。

  2. 如果您的站点使用 VDI，请确保：

    • 您正在使用 ScreenAgent V3.x.x 及更高版本。

      • 对于 Citrix 虚拟应用程序模式：

        Citrix 不支持在云托管计算机上配置虚拟 IP 环回。 此功能对于 ScreenAgent 作为远程应用程序的操作至关重要，因此仅当 Citrix 在本地计算机上运行时才支持此功能。

        有关详细信息，请参阅 Citrix 文档。

        • 启用虚拟 IP 环回策略。 将 ScreenAgent.exe 和 Chrome.exe 添加到虚拟 IP 虚拟环回程序列表。 请记住，每个程序都必须在单独的行上列出。

        • 将 ScreenAgent 安装在 Citrix Virtual Apps 服务器上。

    • 在非永久 VDI 环境中：

      • 使用 ScreenAgent 版本 3.0 或更高版本。

      • 在 VDI 的基本映像上安装 ScreenAgent。

      • 拍摄基本映像的快照

      • 分发到所有 VDI 实例。

    • 对于多会话环境和终端服务器类型 VDI 环境：

      • 使用 ScreenAgent 版本 3.0 或更高版本。

      • 将 ScreenAgent 配置为在 OS 登录模式下工作。

      • 用户需要使用 OS 登录凭据登录 ScreenAgent。

      每个员工配置文件的 OS 登录值必须是唯一的。 OS 登录值不能用于多个员工配置文件，即使某些重复的员工配置文件处于非活动状态也是如此。 如果多个员工配置文件具有相同的 OS 登录值，则 ScreenAgent 将不会为使用该 OS 登录值的任何坐席运行。

    如果您正在多会话或非永久 VDI 环境中工作并且遇到问题，请联系 NICE 支持，以检查您的特定环境是否受支持。

    VMware Horizon 和 Citrix 虚拟桌面模式不需要任何特殊配置。

  3. 检查坐席的计算机配置。

    • 坐席的计算机上安装了 Microsoft .NET 4 或更高版本。

    • 坐席用软件电话解决方案之一：

      • Agent.

      • Salesforce Agent 软件电话与 ScreenAgent 安装在同一台计算机上。

      • MAX 软件电话。

    • 平台要求 中的相关计算机规格。

      请记住，如果计算机配置设置为全高清或 4K，并且 CPU 使用率较高，则可能需要使用功能更强大的 CPU（例如 i5）。

    • 端口 31322 打开。 此端口仅用于 ScreenAgent 和 MAX/Agent/Salesforce Agent 软件电话在坐席的计算机上进行内部通信。 使用 OS 登录时不需要。

  4. 请确保正在安装 ScreenAgent 的用户（例如管理员）在坐席的计算机上具有管理员特权。

  5. 请确保正在安装 ScreenAgent 的用户（例如管理员）具有以下 CXone Mpower 权限：

    • 可以访问支持下载：开启，此设置允许您访问“支持 - 下载”页面。

    • 访问密钥：创建，此设置用于为您的组织管理访问密钥。

  6. 为 ScreenAgent 生成访问密钥。

    您可以使用相同的访问密钥在租户中所有坐席的计算机上安装 ScreenAgent。

    访问密钥会接收生成它的 CXone Mpower 用户的所有权限。 如果该用户是管理员，则任何持有此访问密钥的人都将具有管理员特权。 因此，出于安全原因，请首先为 ScreenAgent 创建 CXone Mpower 用户和角色，然后使用 ScreenAgent 用户生成密钥。

    1. 为 ScreenAgent 服务创建角色：

      1. 单击应用程序选择器 应用程序选择器的图标 并选择Admin。

      2. 转至安全 > 角色和权限。

      3. 单击新角色。

      4. 为角色命名，例如 ScreenAgent 访问密钥。

      5. 除访问密钥和我的访问密钥外，移除该角色的所有权限。

      6. 保存并激活配置文件。

    2. 为 ScreenAgent 服务创建员工：

      1. 单击应用程序选择器 应用程序选择器的图标 并选择Admin。

      2. 单击员工。

      3. 单击新员工。

      4. 为员工命名，例如 ScreenAgent。

      5. 从主要角色下拉列表中，选择您刚刚创建的 ScreenAgent 访问密钥角色。

      6. 在“常规”选项卡上，清除所有属性。

      7. 创建 ScreenAgent 员工。 您只有在创建帐户后才能生成访问密钥。

    3. 再次打开 ScreenAgent 员工，然后转至“安全”选项卡。 单击添加访问密钥以生成访问密钥。

    4. 复制访问密钥 ID 以及机密访问密钥，然后将它们保存某个安全的地方。 如果您没有复制机密访问密钥，或者丢失了它，则您需要创建一个新机密访问密钥。 在所有坐席的计算机上安装 ScreenAgent 时，请使用此访问密钥 ID 和机密访问密钥。

    5. 单击激活电子邮件中的激活帐户按钮可激活 ScreenAgent 员工帐户。

  7. 下载 ScreenAgent MSI：

    1. 转至 CXone Mpower，然后以具有可以访问支持下载权限的用户身份登录。

    2. 单击您的用户名，然后选择支持和下载。

    3. 下载所需的 MSI。 请记下作为 MSI 下载目标的位置，您稍后将需要使用该文件位置。

  8. ScreenAgent 支持五种用于屏幕录制的代理身份验证方法 - Basic、Digest、Kerberos、NTLM 和 Negotiate。 使用代理身份验证方法时：

    • 确保在代理设置中的操作系统级别设置代理。

    • 对于“Basic”和“Digest”两种身份验证方法，您必须在 Windows 凭据管理器中设置凭据。

    • 安装并无变化。 但是，如果您想在不更改操作系统上代理的情况下为 ScreenAgent 使用代理，您可以在 ScreenAgent 安装中使用直接代理。

    • 请记住，这些身份验证方法仅用于屏幕录制，而不适用于屏幕监控。

安装 Windows 版 ScreenAgent

您可以使用部署工具或在每个坐席的计算机上手动安装 ScreenAgent。

如果您使用的是部署工具，请将安装配置为以下任一选项：

  • 运行具有用户权限（用户模式/用户上下文） - 无需重启坐席的计算机。

  • 运行具有管理权限 - 必须重新启动所有坐席的计算机。

您可以指定安装位置：

  • 默认情况下，将 ScreenAgent 安装在 C 盘的 \NICE-InContact\ScreenAgent 文件夹下。 您可以在安装命令中指定不同的安装路径。

  • 升级到更高版本时，您可以定义不同的安装路径。 先前版本将被删除，更高版本将被安装在指定位置。

  • 重新安装相同的 ScreenAgent 版本会替换同一位置中的现有安装。 要更改安装路径，请卸载现有实例，然后在重新安装时指定所需的位置。

一些 ScreenAgent 参数可以在安装后更改。 请参阅 更改 ScreenAgent 配置。 要更新其他安装参数，请重新安装 ScreenAgent 客户端。

要将 ScreenAgent 升级到更高版本，请安装 ScreenAgent 客户端。 您无需卸载先前的版本。 有关卸载 ScreenAgent 后系统上剩余内容的详细信息，请参阅 卸载后信息。

当您升级或重新安装 ScreenAgent 时，安装会自动使用现有配置，除非您指定不同的参数设置。 请参阅 使用当前配置重新安装或升级。 卸载 ScreenAgent 时，此配置不会保存，在您升级或重新安装时需要指定安装参数。

当未记录坐席时，升级或重新安装ScreenAgent。 如果坐席在更新期间正在处理呼叫，则该呼叫的对应屏幕录制将停止。 安装完成后，通话将根据录制策略和 Studio 脚本进行录音。

要安装 ScreenAgent：

  1. 确保所有先决条件都已满足。

  2. 以管理员身份打开命令提示符。 在命令行中，导航到您下载 MSI 的位置，然后输入带有相关参数的安装命令：

    1. 转至您下载 MSI 的文件夹，然后复制该文件夹的路径。 该路径通常是 %UserProfile%\downloads 文件夹。

    2. 以管理员身份运行命令提示符：

      1. 在 Windows 中，单击 Windows 按钮，然后键入 cmd。

      2. 右键单击“命令提示符”磁贴，然后单击以管理员身份运行。

    3. 键入 cd/，然后按下 Enter。

    4. 键入 cd 并粘贴文件位置，然后按下 Enter。

      例如，cd %UserProfile%\downloads。

    5. 将此命令复制并粘贴到命令提示符中，然后编辑安装参数。

      • 如果您没有 Web 代理或代理在操作系统级别定义，请使用此命令：

        msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi INSTALL_PATH=<可选：安装路径> ACCESS_KEY_ID=<access key ID> ACCESS_KEY_SECRET=<secret access key> REGION_TYPE=<subdomain（前 3 个字符）CXone MpowerURL> RESOLVE_USER=<可选：auto|oslogin> FRAME_PER_SECOND=<可选：1、2、3、4 或 5> RESOLUTION_LEVEL=<可选：null、low、medium或high> LOAD_CERTIFICATES=<可选：true|false> STATISTICS=<可选：true|false>/log install.log /quiet

      • 当您使用代理身份验证并且未在操作系统级别定义代理时，请使用以下命令：

        msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi INSTALL_PATH=<可选：安装路径> ACCESS_KEY_ID=<access key ID> ACCESS_KEY_SECRET=<the secret access key> REGION_TYPE=<URL的子域（前 3 个字符）>CXone Mpower WEB_PROXY=<仅当使用代理服务器连接到互联网时> RESOLVE_USER=<可选：auto|oslogin> FRAME_PER_SECOND=<可选：1、2、3、4 或 5> RESOLUTION_LEVEL=<可选：null、low、medium或high> LOAD_CERTIFICATES=<可选：true|false> STATISTICS=<可选：true|false> /log install.log /quiet

      安装命令示例（对于没有 Web 代理或在操作系统级别定义代理时）：

      msiexec /i ScreenAgent-64bit-3.0.37.msi INSTALL_PATH=d:\newdir ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 RESOLVE_USER=oslogin FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high  LOAD_CERTIFICATES=true STATISTICS=true /log install.log /quiet

    使用此命令：

    msiexec /i ScreenAgent-<32|64>bit-<MSI version>.msi KEEP_CURRENT_CONFIG= true

    KEEP_CURRENT_CONFIG= true 是可选的，因为此参数的默认值为 true。

    • 如果要在重新安装之前卸载，请参阅 卸载后信息 了解有关残留文件的详细信息。

    • 如果在之前的安装中设置了所有配置，则将使用所有现有配置安装 ScreenAgent。

    • 如果在之前的安装中缺少或未设置某些配置，则使用现有配置和缺少参数的默认值安装 ScreenAgent。

    • 安装后不保存安装路径;如果安装命令中未提供，则即使ScreenAgent，KEEP_CURRENT_CONFIG= true也会安装在默认位置。

    要保留某些参数设置并更改其他参数设置，请使用以上命令并根据需要添加其他参数。 例如，要仅更改每秒帧数和分辨率级别，请使用以下命令（KEEP_CURRENT_CONFIG=true是可选的）：

    msiexec /i ScreenAgent-64bit-2.2.18.msi KEEP_CURRENT_CONFIG=true FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high

  3. 从日志文件验证安装成功。 install.log文件位于安装 MSI 的文件夹中，通常是 %UserProfile%\downloads 文件夹。

    • 验证安装程序具有管理员特权。

    • 如果坐席的计算机上没有安装 Microsoft .NET Framework 4.0 或更高版本，则安装它。

    配置文件 configFile.ini 会在安装后自动隐藏。 要查看和打开文件，请在 Windows 文件资源管理器中启用隐藏项目。

  4. 确保坐席拥有可以录制（屏幕）属性（在 CXone Mpower 中，转到管理员 > 员工，然后单击坐席）。 此属性对于启用屏幕录制、屏幕监控或这两者都是必需的。

  5. 对一个呼叫录音，然后检查 ScreenAgent 日志文件。 ScreenAgent.log 文件位于：%appdata%\ScreenAgent\logs\ScreenAgent.log。

    您的 ScreenAgent 日志还会自动上传到云，以便在需要时供 CXone Mpower 支持团队访问。

    如果有任何错误，请参阅 录音疑难解答和常见问题解答。

您可以观看一段视频，其中概述了如何使用 ScreenAgent 改进具有实时屏幕监控的坐席交互。

对拒绝列表的 Google Chrome 注册表项配置

在坐席计算机上使用 Google Chrome 浏览器时，如果 Google Chrome 注册表项中不存在 UiAutomationProviderEnabled 值，则拒绝列表中指定的 URL 可能不会被排除在录制之外。 请参阅管理屏幕录制拒绝列表。

要将该值添加到注册表项：

  1. 确保坐席的计算机使用 Chrome 浏览器 126 或更高版本。

  2. 确保您拥有 Windows 管理员权限。

  3. 验证 HKLM:\SOFTWARE\Policies\Google\Chrome 注册表路径是否存在。

  4. 运行以下 Powershell 脚本行，将该值添加到 Google Chrome 注册表：

    Set-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Google\Chrome" -Name "UiAutomationProviderEnabled" -Value 1 -Type DWord

潜在的 VDI 远程应用程序规避方法

当代理使用 VDI 远程 应用程序并且 ScreenAgentWatchDog.exe 进程未启动时：

  1. 将ScreenAgent.exe发布到 RemoteApps。 确保只有管理员（而非坐席）才能访问它。

  2. 创建并发布 RemoteApps 的快捷方式。 使用脚本（如下所示的脚本之一）打开浏览器并运行 ScreenAgentWatchDog.exe。 坐席必须使用此快捷方式打开浏览器，否则 ScreenAgent 将不会运行。

在以下示例中，将 <USER_ID> 和 <TENANT_ID> 替换为相关信息。 此外，可将此示例中显示的 URL 替换为您想要使用的任何其他 URL。

var(--codeSnippetCopyLabel) 
@echo Off

cd " C:\Program Files (x86)\Microsoft\Edge\Application"
start msedge.exe https://account.activedirectory.windowsazure.com/applications/signin/<USER_ID>?tenantId=<TENANT_ID>

REM Check if ScreenAgentWatchDog is already running for the current user profile
tasklist /FI "USERNAME eq %USERNAME%" /FI "IMAGENAME eq ScreenAgentWatchDog.exe" | find /I "ScreenAgentWatchDog.exe" > nul
if "%errorlevel%" neq "0" (
    cd "%ProgramFiles%\NICE-InContact\ScreenAgent"
    start ScreenAgentWatchDog.exe
)

Exit

在以下示例中，将 <USER_ID> 和 <TENANT_ID> 替换为相关信息。 此外，可将此示例中显示的 URL 替换为您想要使用的任何其他 URL。

var(--codeSnippetCopyLabel)

WorkaroundChrome

@echo Off

cd "C:\Program Files (x86)\Google\Chrome\Application"
start chrome.exe https://account.activedirectory.windowsazure.com/applications/signin/<USER_ID>?tenantId=<TENANT_ID>

REM Check if ScreenAgentWatchDog is already running for the current user profile
tasklist /FI "USERNAME eq %USERNAME%" /FI "IMAGENAME eq ScreenAgentWatchDog.exe" | find /I "ScreenAgentWatchDog.exe" > nul
if "%errorlevel%" neq "0" (
    cd "%ProgramFiles%\NICE-InContact\ScreenAgent"
    start ScreenAgentWatchDog.exe
)

Exit

适用于 Multi-ACD (Open) 环境的 ScreenAgent

Multi-ACD (Open) 在虚拟或物理环境中受 ScreenAgent 支持。 在这些环境中，必须将 RESOLVE_USER 参数配置为值 oslogin。 有关参数的信息，请参阅安装命令参数。

更改 ScreenAgent 配置

安装后，您可以更改某些 ScreenAgent 配置。

配置文件 configFile.ini 会在安装后自动隐藏。 要查看和打开文件，请在 Windows 文件资源管理器中启用隐藏项目。

  1. 打开安装文件夹中的 configFile.ini 文件，通常位于 C:\Program Files\NICE-InContact\ScreenAgent下。

  2. 编辑参数值：

    • 更改 [recordingParameters] 部分下的 framePerSecond 值。 默认情况下，该值为 5。

      允许的值为 1、2、3、4 或 5。

      降低每秒帧数可减少文件大小、CPU 和 RAM。

      每秒帧数 减少帧数 对文件大小/带宽、CPU 和 RAM 的影响（估计）

      5

      默认（最大）

      无

      4

      减少 20%

      减少 ~15%

      3

      减少 40%

      减少 ~30%

      2

      减少 60%

      减少 ~45%

      1

      比同行平均水平

      减少 ~60%

    • 更改 [recordingParameters] 部分下的 resolutionLevel 值。 默认情况下，该值为 null，即当前屏幕分辨率。

      容许值为 null、low、medium或high （不区分大小写）。

      降低分辨率可减少文件大小、CPU 和 RAM。

      分辨率级别 分辨率降低 对文件大小/带宽、CPU 和 RAM 的影响（估计）

      Null

      默认（当前屏幕分辨率）

      无

      高

      屏幕分辨率/1.5

      减少 ~20%

      中

      屏幕分辨率/2

      减少 ~40%

      低

      屏幕分辨率/4

      减少 ~60%（仅建议用于 4K 屏幕）

      要重置为屏幕的分辨率，请将 resolutionLevel 值更改为 null。

    • 更改 [others] 部分下的 loadCertificates 值。 默认情况下，此值为 true。

      可接受的值为 true 或 false。

  3. 保存 configFile.ini 文件。

  4. 要应用更改，请重新启动 ScreenAgent 应用程序：

    1. 在 Windows 任务管理器中，结束当前 ScreenAgentWatchDog.exe 任务，然后结束 ScreenAgent.exe 进程。

    2. 从 ScreenAgent 安装文件夹中，运行 ScreenAgentWatchdog.exe。

检查 ScreenAgent 连接

使用 ScreenAgent 连接检查工具运行测试序列来检查网络访问，并确保 ScreenAgent 将正常工作。

  • 您可以在安装 ScreenAgent 之前或之后使用该工具。

  • 您可以从“下载”页面下载最新版本的连接检查工具。

  • 当坐席的网络配置发生更改或与常规配置不同时，建议使用此工具。 您不需要为每个坐席运行该工具。

  • 您可以使用同一命令多次运行连接检查工具。

  • 每次测试运行后，都会显示成功或失败通知。 运行结束时，摘要显示每个测试的状态。

  • 完成测试后，连接检查工具会创建日志文件。

  • 连接检查工具当前不包括用于检查实时屏幕监控网络的测试。

  1. 下载连接检查工具 EXE 文件：

    1. 转至 CXone Mpower，然后以具有可以访问支持下载权限的用户身份登录。

    2. 单击您的用户名，然后选择支持和下载。

    3. 下载所需的 EXE 文件。 请记下作为 EXE 文件下载目标的位置，您稍后将需要使用该文件位置。

  2. 运行连接检查工具。

    1. 以管理员身份运行命令提示符：

    2. 将命令复制并粘贴到命令提示符中，然后编辑表中列出的参数。

      <exe 文件的路径>ACCESS_KEY_ID=<access key ID> ACCESS_KEY_SECRET=<secret access key> REGION_TYPE= CXone Mpower<URL的子域（前 3 个字符）> WEB_PROXY=<可选：代理服务器的URL>

      参数

      说明

      示例

      path to exe file

      下载的 EXE 文件的文件位置。

      C:%UserProfile%\downloads

      ACCESS_KEY_ID

      粘贴在员工帐户中创建的访问密钥 ID。 要生成访问密钥，请参阅 为 ScreenAgent 生成访问密钥。

      ACCESS_KEY_ID=ABCDEF12345====

      ACCESS_KEY_SECRET

      粘贴在“员工”帐户中创建的机密访问密钥 ID。

      ACCESS_KEY_SECRET=12345ABCDEF

      REGION_TYPE

      输入 CXone Mpower URL 的子域（前 3 个字符）（例如：na1、na2、au1、eu1）

      REGION_TYPE=na1

      WEB_PROXY

      只有在使用代理服务器连接网络时才包含此参数。

      • 主机可以是主机名或 IP

      • 根据您的代理设置使用 http 或 https

      • 如果在代理设置中设置了服务器的用户名和密码，请使用该用户名和密码

      WEB_PROXY=http://admin:pwd@168.63.76.32:3128

      WEB_PROXY=https://proxyserver:8088

       

    命令示例：

    C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088

  3. 连接检查工具开始运行测试。 每次测试运行后，都会显示成功或失败通知。 如果测试失败，则会显示失败原因。 运行结束时，摘要会显示每个测试是否通过、失败或不需要运行 (N/A)。 例如，如果连接检查工具启动时 ScreenAgent 未在后台运行，则关闭 ScreenAgent 的测试并重新启动它不需要运行。

    完成测试后，连接检查工具会在与连接检查工具安装文件相同的文件夹中创建一个日志文件 （SA_Connectivity_tool_log_<runUniqueUUID>）。 日志文件包含命令提示符处显示的所有信息。

连接测试

测试

说明
关闭 ScreenAgent 如果 ScreenAgent（ScreenAgent.exe 和 ScreenAgentWatchdog.exe）在后台运行，请将其关闭。 这确保它不会中断连接工具测试。
检查端口 31322 测试与端口 31322 的通信。
获取令牌 测试获取令牌。
获取刷新令牌 测试获取刷新令牌。
从通知服务接收日志存储桶的 STS 凭据 测试从通知服务 web 存储桶发送和接收消息。
从通知服务接收媒体存储桶的 STS 凭据 测试从通知服务 web 存储桶发送和接收消息。
将连接工具运行的日志上传到S3日志存储桶 测试上传到 S3 日志存储桶。
将文件上传到 S3 媒体存储桶 测试上传到 S3 媒体存储桶。
启动 ScreenAgent 如果之前已关闭，请重新启动 ScreenAgent（ScreenAgent.exe 和 ScreenAgentWatchdog.exe）。
停止端口 31322 上的服务器 停止用于测试与端口 31322 的通信的测试服务器。

在多租户环境中配置 ScreenAgent

在多租户环境中，每个代理都有自己的特定于他们正在处理的租户的ACCESS_KEY和SECRET_KEY。 对于位于同一区域中的租户，支持多个租户。

此过程使用 Microsoft Active 目录，并且其他目录服务解决方案的配置可能有所不同。

要为多个租户配置 Active 目录，请执行以下作：

  1. 为您管理的每个租户创建一个 JSON 文件：

    • 每个文件必须包含租户的 accessKey ID 和 AccessKey Secret。

      例如，如果您管理租户 A 和 租户 B，则可以将它们命名为 TenantA_connection.json 和 TenantB_connection.json （或对您的特定需求有意义的任何名称）。

    • 每个租户的成员必须有权访问相关文件。 例如，前面提到的 租户 A 中的所有用户都必须有权访问 TenantA_connection.json。

    对每个文件使用以下结构。 每个租户的参数值必须是唯一的。

    var(--codeSnippetCopyLabel) 
    {
      "accessKeyId": "{{ACCESS_KEY}}",
      "accessKeySecret": "{{SECRET_KEY}}"
    }

  2. 将这些文件放在您的网络中所有租户用户都可以访问它们的位置。 例如，在文件服务器上创建一个文件夹（例如 \\fileserver\shared\files\）。

    每个租户都可以拥有自己的共享文件夹。

  3. 使用以下步骤在 Active 目录 中为每个租户的用户创建一个安全组：

    1. 在域名控制器计算机上，打开 Active Directory 用户和计算机目录控制台。

    2. 右键单击要创建组（默认为Users）的组织单位 （OU），然后选择New > Group。

    3. 指定组名称。 例如，UsersGroup_TenantA。

    4. 选择 全局范围 和 安全 选项。

    5. 单击 OK。

    6. 右键单击新创建的安全组，然后选择 属性。

    7. 在 成员 选项卡上，添加与此租户对应的所有用户。

    8. 单击 确定 以完成更改。

    9. 重复上述步骤，为每个租户创建一个安全组。

  4. 创建一个组策略对象 （GPO），其中包含文件分发策略，该策略将涵盖所有租户：

    1. 打开 GPO 控制台。

    2. 右键单击用户所在的 域名 或 OU 上，然后选择创建 GPO。

    3. 指定 GPO 的名称（例如，租户_Files_Distribution），然后单击 确定。

    4. 右键单击您刚刚创建的 GPO，然后选择 编辑 以打开组政策管理编辑器。

    5. 转到用户配置>首选项> Windows 设置>文件。

    6. 右键单击文件并选择新建>文件，为每个单独的租户创建新的文件作。

    7. 配置以下 File 设置：

      1. 在 Action下，选择 Update。

      2. 在 源文件（s）下，输入在此过程开始时为租户创建的特定 JSON 文件的网络路径（例如，\\fileserver\shared\files\TenantA_connection.json）。

      3. 在 目标文件下，输入：%appdata%\ScreenAgent\TenantA_connection.json

    8. 在 常用 选项卡上，选择 项目级定位，然后单击 定位....

    9. 在 Targeting Editor 窗口中，点击 New Item，然后选择 安全 Group。

    10. 在 Group 字段中，指定之前为相应租户创建的 Users Group（例如，UsersGroup_TenantA）。

    11. 单击 确定 完成配置。

    12. 重复这些步骤，使用自己的 JSON 文件为每个单独的租户创建 File作。

  5. 要应用和刷新组策略，请在服务器上运行 gpupdate/force 或等待下一个组策略刷新周期。

  6. 每个用户都必须注销其当前会话，然后重新登录到其计算机上的用户帐户，以确保所有更改都生效。

安装命令参数

参数

说明

示例

msiexec /i ScreenAgent-32bit-<MSI version>.msi

32 位或 64 位

如果您安装的计算机为：

  • 32 位 Windows，请输入 32bit

  • 64 位 Windows，请输入 64bit

MSI 版本

输入从“支持和下载”页面下载的 MSI 版本安装文件。 例如，3.0.22。

msiexec /i ScreenAgent-64bit-3.0.22.msi

 

msiexec /i ScreenAgent-32bit-3.0.22.msi

KEEP_CURRENT_CONFIG

（可选）默认情况下，当您重新安装或升级 ScreenAgent 时，安装将使用当前配置。 请参阅 使用当前配置重新安装或升级。

当设置为 false 时，ScreenAgent 安装不使用现有配置。 此安装使用所有指定的参数以及对无配置的参数使用默认值。

默认值为 true。 对于全新安装，对无配置的参数使用默认值。

KEEP_CURRENT_CONFIG=true

INSTALL_PATH

（可选）您可以指定安装路径。 安装文件将保存在指定安装路径下的 \NICE-InContact\ScreenAgent 文件夹中。

如果不添加此参数，即使 KEEP_CURRENT_CONFIG= true，ScreenAgent 也会使用 C 盘上的默认安装路径进行安装。

INSTALL_PATH=d:\newdir

ACCESS_KEY_ID

粘贴在员工帐户中创建的访问密钥 ID。 要生成访问密钥，请参阅 为 ScreenAgent 生成访问密钥。

ACCESS_KEY_ID=ABCDEF12345====

ACCESS_KEY_SECRET

粘贴在“员工”帐户中创建的机密访问密钥 ID。

ACCESS_KEY_SECRET=12345ABCDEF

REGION_TYPE

输入 CXone Mpower URL 的子域（前 3 个字符）（例如：na1、na2、au1、eu1）

REGION_TYPE=na1
STATISTICS （可选）默认情况下，该值被设置为 true，并允许 ScreenAgent 收集用户计算机上的数据（RAM、CPU）。

如果您不希望 ScreenAgent 收集数据，可以将该值更改为 false。

允许的值为 true 和 false。

您可以在安装后更改此配置。

 STATISTICS=true

WEB_PROXY

只有在使用代理服务器连接网络时才包含此参数。

请记住：

  • 主机可以是主机名或 IP

  • 根据您的代理设置使用 http 或 https

  • 如果在代理设置中设置了服务器的用户名和密码，请使用该用户名和密码

例如：

  • http://server_username:server_password@host:port

  • https://server_username:server_password@host:port

  • https://host:port

当您使用与代理 pac 文件配合使用的代理 URL 时，请在代理 URL 前面添加前缀 pac+，例如，如果代理 URL 为 https://<proxy server>.pac，则使用：

WEB_PROXY=pac+https://<proxy server>.pac

WEB_PROXY=http://admin:pwd@168.63.76.32:3128

 

 

WEB_PROXY=https://proxyserver:8088

 

 

 

 

 

 

 

 
RESOLVE_USER

（可选）将 RESOLVE_USER=oslogin 配置为使用代理的 OS 登入。 在此模式下，ScreenAgent 使用坐席的 OS 登录信息连接到服务器，并且可以进行高级配置，例如 Multi-ACD (Open)、多会话环境等。 使用 OS 登录时，ScreenAgent 不使用端口 31322。

如果您不添加此参数，ScreenAgent 会使用默认值自动安装，并依赖 CXone Mpower 客户端（MAX、Agent 等）连接到服务器。 在此模式下，ScreenAgent 使用端口 31322 连接到 CXone Mpower 客户端。

坐席的 OS 登录在“员工”设置的“常规”选项卡中以域\用户名格式加以定义。

  • 对于 Multi-ACD (Open) 环境，此参数必须配置为 oslogin 值。

    这将使 Screen Agent 客户端能够从操作系统读取坐席的 OS 登录信息。

  • 如果客户有多个坐席在同一台计算机上工作（而不是并行），则应使用 OSLogin 配置。 如果无法配置 OSLogin，则坐席必须在轮班结束时从 Windows 注销，以便 ScreenAgent 正常工作，以便下一个坐席登录到该计算机。

RESOLVE_USER=oslogin
FRAME_PER_SECOND

（可选）可以为输出 MP4 文件设置每秒录制的帧数。 如果不添加此参数，ScreenAgent 将使用默认值每秒 5 帧进行安装。

允许的值为 1、2、3、4 或 5。 降低每秒帧数可减少文件大小、带宽、CPU 和 RAM。

您可以在安装后更改此配置。

FRAME_PER_SECOND=3
RESOLUTION_LEVEL

（可选）您可以设置所录制 MP4 文件的分辨率，以优化 RAM 和 CPU 消耗。 如果未添加此参数，ScreenAgent 以默认的分辨率设置 null（当前屏幕分辨率）安装。

容许值为 null、low、medium或high （不区分大小写）。 降低分辨率可减少文件大小、CPU 和 RAM。

您可以在安装后更改此配置。

RESOLUTION_LEVEL=low

LOAD_CERTIFICATES

（可选）如果 ScreenAgent 不应访问并加载自签名证书，请将此参数设置为 false Windows 证书存储。

可接受的值为 true 或 false。

如果不添加此参数，ScreenAgent 将从 Windows 证书存储中访问自签名证书。

您可以在安装后更改此配置。

LOAD_CERTIFICATES=false

/log install.log

打印日志文件中的安装结果。

/log install.log

/quiet

（可选）如果您想在安装过程中抑制弹出窗口则包括此项。 您将能够在日志文件中查看安装结果。

/quiet

卸载后信息

从客户端计算机上卸载 ScreenAgent 时，系统上的项目：

  • AppData 文件夹内容：保留整个 %AppData%\ScreenAgent\ 文件夹，包括日志和配置文件。

  • 安装文件夹：...\Program Files\NICE-InContact\ScreenAgent 处的文件夹仍然存在，但在卸载过程中会删除其内容。

这些残留文件和文件夹：

  • 请勿干扰 ScreenAgent 的新安装或更新安装。

  • 如果需要完整的干净环境，可以手动删除。

如果要删除 ScreenAgent 的所有痕迹，请确保在卸载后手动删除这些文件夹。