部署 Genesys 云后台助手 (GCBA)

Genesys Cloud Background Assistant (GCBA) 安装一项后台服务，该服务会在安装和系统重启期间自动启动。

  1. 访问 Genesys 云端背景助手 (GCBA) 安装程序。
    笔记： 特定于区域的下载页面也可用以下 URL 模式：https：//apps。{domainName}/background-assistant-windows/。例如， https://apps.mypurecloud.ie/background-assistant-windows/ 。
  2. 单击 “下载”。
  3. 打开下载的文件并运行 GCBA 安装程序。
  4. 单击 “ 下一步”。
  5. 在选择本地 GCBA 通信模式下，选择是否要使用环回地址或使用 Microsoft Edge 扩展进行内部通信。有关详细信息，请参阅我可以为 GCBA 使用哪些内部通信设置选项？
  6. 如果您与代理服务器集成，请选择使用代理服务器在代理设置下，输入代理服务器信息ProxyIP-or-Domain:PortNumber格式。
  7. 单击 “ 安装”。

设置完成后，Genesys Cloud Background Assistant 服务将作为后台服务运行。 要验证，请按照下列步骤操作：

  1. 打开 “管理工具”。
  2. 选择服务并验证 Genesys 后台援助服务是否出现。
    注释：

    3. Genesys Cloud Background Assistant 安装在 Program Files 目录的 Genesys\GenesysCloudBackgroundAssistant 文件夹中。For example, C:\Program Files (x86)\Genesys\GenesysCloudBackgroundAssistant.

静默安装不需要用户提示或界面。  

  1. 打开命令提示符。
  2. 导航到保存 GCBA 安装文件的目录。
  3. 键入以下命令之一：
    • 静默安装（默认使用环回地址）：  <GenesysCloudBackgroundAssistantSetup.exe name> -install /quiet
    • 使用环回地址进行静默安装： <GenesysCloudBackgroundAssistantSetup.exe name> -install COMMUNICATION_MODE="Loopback" /quiet
    • 使用 Edge 扩展进行静默安装： <GenesysCloudBackgroundAssistantSetup.exe name> -install COMMUNICATION_MODE="EdgeExtension" /quiet

注释： 
  • 如果您想使用静默安装方法更新现有 GCBA 版本的代理服务器设置，请卸载并使用更新后的代理服务器设置重新安装 GCBA。
  • 如果您与代理服务器集成，请添加以下命令行参数：  USEPROXY=1 PROXYSERVER="IP address or Domain Name:Port" 。

修复安装程序选项通过将损坏的文件从安装源恢复为原始默认版本来替换损坏的文件。 

  1. 访问 Genesys 云端背景助手 (GCBA) 安装程序。
    笔记： 特定于区域的下载页面也可用以下 URL 模式：https：//apps。{domainName}/background-assistant-windows/。例如， https://apps.mypurecloud.ie/background-assistant-windows/ 。
  2. 单击 “下载”。
  3. 点击维修。 

笔记：修复选项使用不包含客户特定设置（例如代理服务器详细信息）的默认文件替换损坏的文件。为了确保您保留 GCBA 设置，Genesys 建议您卸载并重新安装该应用程序，然后指定所需的设置。

火狐

在 Firefox 中，您必须启用允许 Firefox 自动信任您安装的第三方根证书选项。有关详细信息，请参阅For more information, see当我使用 Firefox 时，Genesys Cloud Background Assistant (GCBA) 不工作，我该如何解决这个问题？

谷歌浏览器

对于 Chrome 版本 141 或更高版本，配置以下注册表设置以绕过本地网络访问 (LNA) 权限提示。确保注册表 URL 匹配用于连接到 Genesys Cloud 的确切 URL 。您可以使用首选的企业端点管理工具在您的用户群中部署此配置。

  • Software\Policies\Google\Chrome\LocalNetworkAccessAllowedForUrls\1 = https://apps.mypurecloud.com

微软 Edge

对于 Edge 版本 141 或更高版本，如果 GCBA 设置为环回模式，配置以下注册表设置以绕过本地网络访问 (LNA) 权限提示。确保注册表 URL 匹配用于连接到 Genesys Cloud 的确切 URL 。您可以使用首选的企业端点管理工具在您的用户群中部署此配置。

  • SOFTWARE\Policies\Microsoft\Edge\LocalNetworkAccessAllowedForUrls\1 = https://apps.mypurecloud.com

如果您使用 Microsoft Edge 扩展程序进行 GCBA 内部通信，则可以按照以下步骤检查是否安装了 GCBA Connector 的 Edge 扩展程序：

  1. 打开 Edge。
  2. 类型edge://extensions在地址栏中，然后按进入。
  3. 验证 Genesys Cloud GCBA Connector 是否出现在已安装的扩展列表中。 

注释：
  • 如果注册表设置未配置为绕过本地网络访问 (LNA) 权限提示，则通过 Web 浏览器登录 Genesys Cloud 并在其中配置屏幕录制的用户环回模式提示授予本地网络访问权限。为了确保屏幕录制功能与 GCBA 兼容，用户必须选择允许当出现提示时。如果用户拒绝本地网络访问，则无法启动屏幕录制。
  • 安装 GCBA 后重新启动 Edge，然后检查已安装的 GCBA 连接器扩展。
  • 请参阅GCBA 发行说明查找最新版本的 GCBA 连接器扩展（仅适用于 Edge）。 

  1. 打开控制面板。
  2. 选择 “程序” > “卸载程序” 或 “添加或删除程序”。
  3. 选择加拿大广播公司从程序列表中，然后单击卸载。

笔记：如果您使用 Microsoft Edge 扩展进行 GCBA 的内部通信，则 Edge 浏览器中任何先前安装的 GCBA Connector 扩展也会被卸载。

  1. 打开命令提示符。
  2. 导航到保存 GCBA 安装文件的目录。
  3. 键入以下命令：<GenesysCloudBackgroundAssistantSetup exe name> -uninstall /quiet 。

笔记：如果您使用 Microsoft Edge 扩展进行 GCBA 的内部通信，则 Edge 浏览器中任何先前安装的 GCBA Connector 扩展也会被卸载。

在以下位置之一找到 GCBA 版本：

  • 控制面板
  • GCBA 服务窗口 > 服务描述

GCBA 无法自动更新。 使用第三方工具检查应用程序 cast XML 文件是否通知了更新的 GCBA 发行版本。

你可以在 https://apps.mypurecloud.com/background-assistant-windows/appcast.xml 找到最新版本。

下载更新后的 GCBA 版本后，运行安装程序以安装新的 GCBA 版本。 此过程卸载旧版本并安装新版本。

要执行手动升级，请按照以下步骤操作：

  1. 访问Genesys Cloud 后台助手 (GCBA) 安装。
  2. 单击 “下载”。
  3. 打开下载的文件并运行 GCBA 安装程序。
  4. 单击 “ 下一步”。
  5. 如果您与代理服务器集成，请选择使用代理服务器在代理设置下，输入代理服务器信息ProxyIP-or-Domain:PortNumber格式。 

要执行静默升级，请按照以下步骤操作：

  1. 打开命令提示符。
  2. 导航到保存 GCBA 安装文件的目录。
  3. 键入以下命令之一：
    • 如果要保留现有配置，请使用安装时使用的相同命令。如果现有通信是通过 Edge 的 GCBA Connector 扩展进行的，并且有新版本的扩展可用，则该扩展会自动升级。
    • 如果要更新现有的代理服务器配置，请在静默安装命令中添加或删除这些命令行参数：USEPROXY=1 PROXYSERVER="IP address or Domain Name:Port" 。
    • 如果要删除现有的代理服务器集成：<GenesysCloudBackgroundAssistantSetup exe name> -install USEPROXY=0 /quiet 。 

注释：

    要执行以下操作，代理必须拥有具备管理员权限的 Windows® 帐户。

    • 安装或卸载 GCBA
    • 启动、停止或重启 GCBA 服务
    • 结束任何 GcbaBrowser 进程

    确认代理没有具有管理员权限的 Windows 帐户。

    默认情况下，GCBA 会在计算机启动时自动运行。 使用管理权限，您可以停止或重新启动 GCBA 服务。

    1. 打开 “管理工具”。
    2. 选择服务。
    3. 在Genesys Cloud 后台助手， 选择停止服务或者开始服务。

    如果您想更改内部通信方式，建议您卸载 GCBA 并重新安装。Genesys 不建议或支持未卸载并重新安装 GCBA 的任何设置更改。有关详细信息，请参阅我可以为 GCBA 使用哪些内部通信设置选项？

    你可以在 C:\Program Files (x86)\ Genesys\ genesys\ genesyscloudBackgroundAssistant\ logs\ background-assistant.log 中找到 GCBA 日志文件。