

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 VDI 环境中使用 Amazon Connect
<a name="using-ccp-vdi"></a>

虚拟桌面基础架构 (VDI) 环境会让您的解决方案变得更加复杂，需要单独进行 POC 工作和性能测试，以优化解决方案。与其他任何基于WebRTC的浏览器应用程序一样，联络控制面板 (CCP) 可以在厚客户端、精简版和零客户端 VDI 环境中运行，最好由您的 VDI 支持团队处理。configuration/support/optimization虽然如此，以下一系列注意事项和最佳实践仍然能够为基于 VDI 的客户提供帮助。

## 使用分离式 CCP 模型
<a name="use-split-ccp"></a>

建议使用分离式 CCP 模型，在 VDI 中运行无媒体 CCP，在本地 PC 上运行媒体 CCP。您可以使用 Amazon Connect Streams API 创建一个不含应用程序数据和呼叫信令的媒体的 CCP，从而构建自定义 CCP。这样，媒体通过标准的 CCP 传送到本地桌面，数据和呼叫控件则通过无媒体 CCP 传送到远程连接。有关直播 API 的更多信息，请参阅 GitHub 存储库，网址为[https://github.com/aws/amazon-connect-streams](https://github.com/aws/amazon-connect-streams)。

**注意**  
**Firefox 用户**：如果在分离式模式下使用 VDI，则无法在 VDI 之外为 CCP 使用 Firefox 浏览器。CCP 符合 Firefox 麦克风使用指南，只有在 CCP 选项卡处于焦点时才能连接到用户的麦克风。

下图显示了座席工作站如何由本地浏览器和虚拟桌面组成。它通过 WebRTC 连接到 Amazon Connect，并通过 VDI 连接到企业虚拟基础设施。

![\[座席工作站、虚拟桌面、企业虚拟基础设施和 Amazon Connect。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/use-split-ccp.png)


## 云桌面
<a name="use-cloud-desktops"></a>

如果您使用 Citrix WorkSpaces、Amazon 或 Omnissa 云桌面，则可以创建新的代理用户界面或更新现有的代理用户界面（例如自定义 CCP），将音频处理卸载到代理的本地设备上，并将音频自动重定向到 Amazon Connect。这将带来更流畅的座席体验，并在具有挑战性的网络中提高音频质量。首先，您可以使用 [Amazon Connect 开源库](https://github.com/amazon-connect/amazon-connect-streams)创建新的座席用户界面或更新现有的座席用户界面，例如自定义 CCP。

## 设计 VDI 环境时应考虑的事项
<a name="considerations-vdi"></a>
+ **座席位置**，理想情况下，座席使用 CCP 时所在的位置与 VDI 主机位置之间的跃点数应为最少且往返时间应为最短。
+ **VDI 解决方案的主机位置**，理想情况下，VDI 主机位置与您的座席位于同一网段上，内部资源以及边缘路由器之间的跃点数应为最少。另外，您还需要尽可能缩短到 WebRTC 和 Amazon EC2 范围端点的往返时间。
+ **网络**，流量在端点之间经过的每个跃点都会增加发生故障和延迟的可能性。如果底层路由未经过优化，或者管道的速度或容量不够，VDI 环境就特别容易出现呼叫质量问题。虽然 Direct Connect 可以提高从边缘路由器到的呼叫质量 AWS，但它不能解决内部路由问题。您可能需要升级或优化您的私有 LAN/WAN，或重定向到外部设备以绕过呼叫音频问题。在大多数情况下，如果需要这样做，那么 CCP 并不是唯一会出现问题的应用程序。
+ **专用资源**，建议在网络和桌面级别使用，以防止备份和大型文件传输等活动影响可用的座席资源。要防止资源争用，一种方法是限制为只允许通过相似方式使用其环境的 Amazon Connect 用户访问桌面，而不是与可能通过不同方式使用对应资源的其他业务部门共享资源。
+ **使用带有远程连接的软电话**，在 VDI 环境中，这可能会对音频质量产生影响。
**提示**  
如果您的座席连接到远程端点并在该环境中运行，建议您要么将音频重新路由到外部 E.164 端点，要么通过本地设备连接到媒体并通过远程连接发送信号。

# 优化 Citrix 云桌面的 Amazon Connect 音频
<a name="using-ccp-vdi-citrix-step-by-step"></a>

当您的座席使用 Citrix 虚拟桌面基础架构（VDI）环境时，Amazon Connect 可以更轻松地提供高质量的语音体验。您的座席可以利用他们的 Citrix 远程桌面应用程序（例如 Citrix Workspaces）将音频处理分流到座席的本地设备，并自动将音频重定向到 Amazon Connect，从而在具有挑战性的网络中提高音频质量。

首先，您可以使用 [Amazon Connect 开源库](https://github.com/amazon-connect/amazon-connect-streams)创建新的座席用户界面或更新现有的座席用户界面，例如自定义联系人控制面板（CCP）。

## 系统要求
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

本节介绍了在 Amazon Connect 中使用 Citrix Unified Communications SDK 的系统要求。
+ **Citrix Workspace 应用程序版本**

  建议使用最新版本的 Citrix Workspace Application，如[本文档](https://community.citrix.com/tech-zone/learn/tech-briefs/ucssdk/)所述。但是，您必须至少使用 CWA 2305 或更高版本。
+ **Citrix 服务器版本**

  建议 Citrix VDA（Virtual Delivery Agent）的版本为 2203 LTSR 或更高版本。
+ **Citrix 服务器设置**

  默认情况下不支持使用 Citrix UC SDK，系统管理员需要按如下方式添加允许列表注册表条目：
  + **键路径：**`Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\WebSocketService`
  + **键名称：**`ProcessWhitelist`
  + **键类型：**`REG_MULTI_SZ`
  + **键值:**
    + `Chrome.exe`
    + `msedge.exe`

  成功配置注册表后，使用**任务管理器**重启 `CitrixHdxWebSocketService` 以完成设置。  
![\[在 Windows 中使用任务管理器重新启动 CitrixHdxWebSocketService。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-setup.png)
+ **网络/防火墙配置**
  + **Citrix 服务器配置**

    管理员需要允许 Citrix 服务器访问下图所示域的 Amazon Connect TCP/443 流量。有关更多信息，请参阅 [设置网络](ccp-networking.md)。
  + **座席计算机配置**

    此解决方案要求座席的瘦客户端与 Amazon Connect 之间建立媒体连接。要允许座席计算机与 Amazon Connect 的 Softphone Media UDP 端口 3478 之间的流量，请参阅 [设置网络](ccp-networking.md)。  
![\[Citrix 服务器和座席计算机防火墙设置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/using-ccp-vdi-citrix-server-firewall.png)
+ **不支持 CCP 部署**
  + 本地 CCP

## 在通话期间确认瘦客户端和 Amazon Connect 之间的媒体流
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ **使用任务管理器（Windows）进行验证**

  在座席的瘦客户端上启动**任务管理器**，然后检查 HDX 服务是否正在运行。如果它正在运行，则表示媒体正在按预期重定向。  
![\[在 Windows 中使用任务管理器。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/using-ccp-vdi-citrix-confirm-media-flow-windows.png)

# 为亚马逊 WorkSpaces 云桌面优化 Amazon Connect 音频
<a name="using-ccp-vdi-workspaces"></a>

Amazon Connect 简化了为在亚马逊 WorkSpaces 虚拟桌面基础设施 (VDI) 环境中运营的代理提供高质量语音体验的过程。通过利用亚马逊 WorkSpaces 的WebRTC重定向功能，代理可以将Amazon Connect音频处理重定向到其本地设备。这种方法可以提高音频质量，即使在严峻的网络条件下也是如此。要利用此功能，您需要执行以下操作：
+ 使用 [Amazon Connect 开源库](https://github.com/amazon-connect/amazon-connect-streams)创建新的座席用户界面或更新现有的座席用户界面，例如自定义联系人控制面板（CCP）。
+ 将亚马逊配置 WorkSpaces 为启用 WebRTC 重定向。

## 系统要求
<a name="using-ccp-vdi-citrix-step-by-step-requirements"></a>

本节介绍使用带有 WorkSpaces WebRTC 重定向功能的 Amazon Connect 的系统要求。
+ **WorkSpaces 协议**

  WorkSpaces 需要使用 Amazon DCV。有关更多信息，请参阅[什么是 Amazon DCV？](https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html)。
+ **客户端版本**

  用户应使用 WorkSpaces Web Acces WorkSpaces s 或 Windows 客户端版本 5.21.0 或更高版本。完成[设置和安装](https://docs.aws.amazon.com/workspaces/latest/userguide/amazon-workspaces-windows-client.html#windows_setup)说明。
+ **组策略**

  需要在 DCV 组策略中启用 WebRTC 重定向。在[管理 DCV 的组策略设置](https://docs.aws.amazon.com/workspaces/latest/adminguide/group_policy.html#gp_configurations_dcv)主题中，打开标题为**为 DCV 启用或禁用 WebRTC 重定向**的折叠部分，然后完成这些说明。
+ **网络/防火墙配置**
  + **工作空间 VDI 配置**

    管理员需要允许工作空间访问下图所示域的 Amazon Connect TCP/443 流量。有关更多信息，请参阅 [设置网络](ccp-networking.md)。
  + **座席计算机配置**

    此解决方案需要在座席瘦客户端与 Amazon Connect 之间建立媒体连接。要允许座席计算机与 Amazon Connect Softphone Media UDP 端口 3478 之间的流量，请参阅 [设置网络](ccp-networking.md)。  
![\[工作空间 VDI 和座席计算机防火墙设置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/vdi-workspaces.png)
+ **不支持 CCP 部署**
  + 本地 CCP

## 在通话期间确认座席机器和 Amazon Connect 之间的媒体流
<a name="using-ccp-vdi-citrix-confirm-media-flow"></a>
+ 确保 DCV WebRTC 浏览器扩展程序已启用并处于“就绪”状态。

# 针对 Omnissa 云桌面优化 Amazon Connect 音频
<a name="using-ccp-vdi-omnissa-step-by-step"></a>

当您的座席使用 Omnissa 虚拟桌面基础架构（VDI）环境时，Amazon Connect 使其可以更轻松地提供高质量的语音体验。您的座席可以利用其 Omnissa 远程桌面应用程序（例如 Omnissa Horizon Client），将音频处理任务卸载到座席的本地设备，并自动将音频重定向到 Amazon Connect，从而在具有挑战性的网络条件下也能实现音频质量的提升。

首先，您可以使用 [Amazon Connect 开源库](https://github.com/amazon-connect/amazon-connect-streams)创建新的座席用户界面或更新现有的座席用户界面，例如自定义联系人控制面板（CCP）。

## 系统要求
<a name="using-ccp-vdi-omnissa-step-by-step-requirements"></a>

本节描述将 Omnissa Horizon SDK 与 Amazon Connect 结合使用时的系统要求。
+ **Omnissa Horizon 客户端版本**
  + 最低要求版本：座席和客户端均需 8.15.0（Horizon 2503）
  + 目前，Omnissa 仅支持运行 Windows 的座席工作站使用此功能。
  + 下载最新的 Omnissa 客户端
**重要**  
2503 版本将是首个支持 ICE 重启功能的版本。早期版本不支持此功能。
Omnissa Horizon Client 版本 2503 将通过 [Omnissa Customer Connect](https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/8) 提供。请查看 Customer Connect 以获取最新版本。
+ **Omnissa 扩展程序和 SDK 要求**
  + Horizon WebRTC Web App 同时支持扩展程序和 SDK 8.15.0 或更高版本。
  + 此浏览器扩展程序使网页应用能够支持 Horizon Agent 内部的 WebRTC SDK，可在[此处](https://chromewebstore.google.com/detail/horizon-webrtc-web-app-su/emildoafpcgihdmhphelfhghioccllfi?pli=1)从 Chrome 应用商店下载该程序。
+ **浏览器支持（最新 3 个版本）**
  + Google Chrome
  + Microsoft Edge (Chromium)
+ **Omnissa 服务器设置**：Omnissa Horizon SDK 默认情况下不启用。系统管理员需要在 Omnissa Horizon Agent 虚拟机内部配置以下注册表设置 [建议通过注册表编辑器（regedit）配置]。
  + **打开注册表编辑器**
    + 对于 Windows：
      + 按 **Windows \$1 R**
      + 键入 **regedit** 并按 **Enter**。
  + 创建/导航到以下注册表路径：

    ```
    Key Path: Computer\HKLM\SOFTWARE\Policies\Omnissa\Horizon\WebRTCRedirSDKWebApp
    Key Names and Values:
    chrome_enabled (REG_DWORD) = 1
    edge_chrome_enabled (REG_DWORD) = 1
    enabled (REG_DWORD) = 1
    ```

    ```
    Key Path: Computer\HKLM\SOFTWARE\Policies\Omnissa\Horizon\WebRTCRedirSDKWebApp\UrlAllowList
    Key Name: https://*.connect.aws/*
    Key Name: https://*.connect.aws.a2z.com/* 
    Key Type: REG_SZ
    ```

  在安装 Omnissa Agent 之后，无论 SDK 启用状态如何，html5server.exe 和 wsnm.exe 进程将始终在任务管理器中运行。下图显示正在任务管理器中运行的 html5server.exe 进程。  
![\[任务管理器，html5server.exe 进程正在运行。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/omnissa-1.png)

  下图显示正在任务管理器中运行的 wsnm.exe 进程。  
![\[任务管理器，wsnm.exe 进程正在运行。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/omnissa-2.png)
+ **故障排查**
  + 可从以下位置找到 Omnissa 日志文件：

    ` %tmp%\omnissa-{username}\horizon-html5Client-{pid}.log`
**注意**  
`{pid}` 指 Horizon 客户端“horizon-protocol.exe”进程 ID，可以在任务管理器中找到该 ID。
  + 用于增强日志记录的注册表设置

    要为故障排查启用详细日志记录，请添加以下注册表项：

    ```
    HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\Html5mmr: - "html5mmr.log.noThrottle" = dword:00000001
    ```

    ```
    HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\Html5mmr\WebrtcRedir:
     - "html5mmr.log.webrtc.allowFullText" = dword:00000001
     - "html5mmr.log.webrtc.allowThrottle" = dword:00000000
     - "html5mmr.log.webrtc.sharedlib.internal" = dword:00000001
     - "html5mmr.log.webrtc.sharedlib.network" = dword:00000001
     - "html5mmr.log.webrtc.sharedlib.media" = dword:00000001
     - "html5mmr.log.webrtc.shim.logToConsole" = dword:00000001
     - "html5mmr.log.webrtc.sharedlib.signal" = dword:00000001
     - "html5mmr.log.noThrottle" = dword:00000001
     - "html5mmr.log.webrtc.tracelevel" = dword:00000001
    ```

    这些注册表设置能够启用详细日志记录，这有助于诊断与 Omnissa VDI 集成相关的问题。
+ **网络/防火墙配置**
  + **Omnissa VDI 配置**

    管理员需要允许 Omnissa 服务器访问下图中所提及域的 Amazon Connect TCP/443 流量。有关此设置，请参阅[设置网络](ccp-networking.md)主题。
  + **座席工作站配置**

    此解决方案要求座席的瘦客户端与 Amazon Connect 之间建立媒体连接。请按照[设置网络](ccp-networking.md)主题允许座席机器与 Amazon Connect Softphone Media UDP 端口 3478 之间的通信。

     下图说明了 UDP 端口 3478 的使用。  
![\[示图显示 UDP 端口 3478 的使用。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/omnissa-3.png)

## 您的自定义 CCP 上必要的代码更改
<a name="omnissa-required-initccp-changes"></a>

要在 Omnissa VDI 环境中启用音频优化，您必须使用以下更改配置您的自定义 CCP。

1. 在 CCP 初始化之前添加以下代码片段。它有助于管理 CCP 的窗口标识，这在座席打开多个窗口时尤其重要。它添加了一个时间戳和“Active Softphone Tab”标记，以帮助识别活动的 CCP 窗口。

   ```
   const ACTIVE_SOFTPHONE_TAB = "Active Softphone Tab";
   
       window.addEventListener('message', (event) => {
   
           if (event.data.type === 'get_horizon_window_title') {
               let title = document.title;
              const currentTime = new Date();
               if (!title.endsWith(ACTIVE_SOFTPHONE_TAB)) {
                   title += ` ${currentTime.getHours()}${currentTime.getMinutes()}${currentTime.getSeconds()} ` + ACTIVE_SOFTPHONE_TAB;
                   document.title += ` ${currentTime.getHours()}${currentTime.getMinutes()}${currentTime.getSeconds()} ` + ACTIVE_SOFTPHONE_TAB;
               }
   
               event.source.postMessage(
                   { type: 'horizon_window_title_response', title: title, source: 'parent' },
                   event.origin
               );
           }
       });
   ```

1. 在您的 initCCP 配置中添加 VDI 平台参数。这是为了启用音频重定向功能。

   ```
   softphone: {
       allowFramedSoftphone: true,  
       VDIPlatform: "OMNISSA"
   }
   ```
**重要**  
设置 `VDIPlatform: "OMNISSA"` 后，如果 Omnissa 音频优化失败，CCP 将不会回退到标准的 Web 浏览器音频。这意味着：  
如果座席在 Omnissa 虚拟机之外访问 CCP，则呼叫将失败。
在设置此参数之前，CCP 开发人员必须确定 CCP 是否正在 Omnissa 虚拟机内运行。
**实施选项**：  
使用单独的 URL 路径访问 Omnissa 和非 Omnissa。
使用 URL 参数来确定环境。
实现一个 API 以根据用户上下文确定正确的配置。

## 在通话期间如何确认瘦客户端和 Amazon Connect 之间的媒体流
<a name="verify-omnissa"></a>

1. 确保 Omnissa Horizon WebRTC 扩展程序已启用并处于“就绪”状态。

1. 检查浏览器工具栏中的扩展程序图标：

   1. 蓝色图标表示“就绪”状态且功能正常。

   1. 灰色图标表示“未就绪”状态且存在潜在问题。

   下图显示 Omnissa Horizon WebRTC 浏览器扩展程序处于启用及“就绪”状态时的样子。  
![\[Omnissa Horizon WebRTC 浏览器扩展程序处于启用状态时。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/omnissa-4.png)

1. 查看进程状态：

   1. 打开任务管理器。

   1. 验证 html5server.exe 和 wsnm.exe 进程是否正在运行。

   1. 确保这些进程在呼叫期间保持运行。如果任一进程崩溃，VDI 功能都将失败。

1. 测试音频流：

   1. 拨打测试电话

   1. 通过在虚拟机的浏览器中禁用麦克风访问来验证音频优化 - 在本地处理音频时，呼叫应继续工作

   1. 检查是否存在任何音频延迟或质量问题。

1. 使用 Wireshark 来验证：

   Wireshark 是一款免费的开源网络数据包分析器。有关更多信息，请访问 Wireshark [网站](https://www.wireshark.org/)。

   1. 从[此处](https://www.wireshark.org/download.html)下载 Wireshark。

   1. 安装 Wireshark 后，在瘦客户端上打开 Wireshark，开始监控您的本地网络。

   1. 连接到呼叫，在顶部的筛选栏中输入以下过滤器：

      ```
      (udp.srcport == 3478 or udp.dstport == 3478) and ((ip.dst_host = "15.193.6.0/24"))
      ```

   1. 确认您能看到座席计算机和 Amazon Connect 之间的媒体数据包流。

   1. 如果看不到任何数据包：
      + 检查网络连接和防火墙规则。
      + 验证音频优化设置。
**注意**  
上面显示的 IP 范围适用于美国东部（弗吉尼亚州北部） AWS 区域。有关其他区域的 IP 范围，请参阅[设置网络](ccp-networking.md)。  
下图显示 IP 范围。  

![\[Omnissa Horizon WebRTC 浏览器扩展程序处于启用状态时。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/omnissa-5.png)


1. 控制台日志记录

   1. 对于 Windows：打开浏览器开发者工具（按 F12）。

   1. 查找以下与 WebRTC 相关的用来确认 Omnissa 初始化的消息：R`TC.js is using OmnissaVDIStrategy`

      配置消息类似如下示例。

      ```
      {
              "component": "softphone",
              "level": "LOG",
              "text": " RTC.js is using OmnissaVDIStrategy",
              "time": "2025-04-03T20:47:40.460Z",
              "exception": null,
              "objects": [],
              "line": 64,
              "agentResourceId": "20c6b5a3-259e-4e18-a8a7-b962d54a6344",
              "loggerId": "1743713238678-pz6yp1q4n9s",
              "contextLayer": "CRM"
          },
      ```

## 限制
<a name="omnissa-limitations"></a>

不支持以下 CCP 配置：
+ 原生 CCP：原生 CCP 不支持音频优化功能。使用原生 CCP 处理的通话，其媒体流将继续通过虚拟机内部的浏览器进行传输。
+ Salesforce CTI 适配器：不支持 VDI 平台检测，这导致媒体流通过虚拟机的浏览器进行路由，而不是经过优化的客户端音频处理。

# 使用代理工作区优化 Citrix WorkSpaces、Amazon 和 Omnissa 云桌面的音频
<a name="optimize-audio-cdd"></a>

您可以使用 Amazon Connect 代理工作区来简化亚马逊 WorkSpaces、Citrix 和 Omnissa 虚拟桌面基础设施 (VDI) 环境中高质量语音体验的交付。

Amazon Connect 支持[亚马逊 WorkSpaces、[Citrix](using-ccp-vdi-citrix-step-by-step.md) 和 [Omnis](using-ccp-vdi-omnissa-step-by-step.md) sa 云桌面的音频优化](using-ccp-vdi-workspaces.md)。此优化功能会将媒体从座席的本地桌面重定向至 Amazon Connect。它简化了座席体验，并通过减少网络跃点数提高了音频质量。您的座席可以在座席工作区中利用这些音频优化功能。

## 需要了解的重要事项
<a name="optimize-audio-cdd-important-notes"></a>
+ 对于非 SSO 用户，如果代理从 Amazon Connect 管理员网站导航到代理工作区，则会在 URL 中附加一个反向链接的查询参数。该 URL 的格式为 `https://your-instance-url/agent-app-v2?referrer=admin`。要构建该 VDI 平台查询参数，需要从 URL 中删除 referrer 参数（例如，可以使用记事本编辑该 URL）。将该 VDI 平台参数直接附加到 URL 的 `/agent-app-v2` 路径中。
+ 要在 VDI 环境内确保音频优化功能生效，座席必须始终使用该带有书签的 URL 来访问其工作区。
+ 如果您没有在实际的 VDI 环境中使用座席工作区，请不要附加该 VDI 查询参数。
+ 建议座席在 VDI 环境中进行持续联系时使用一台媒体设备。因为媒体设备信息是在联系开始时中继的，所以如果座席在正在进行的联系期间切换媒体设备，他们将无法访问更新后的设备中的音频。

## 如何在代理工作区中使用音频优化
<a name="howto-optimize-audio-cdd"></a>

要在代理工作区中使用音频优化，用户需要在 URL 中有一个查询参数，其中包含使用代理工作区的 VDI 环境的值。此过程向联络控制面板（CCP）发出信号，要求其对从该特定 VDI 环境到座席正在使用的本地设备的呼叫执行 WebRTC 重定向。

请完成以下步骤以使用针对 VDI 环境的查询参数。

### 在不进行 SSO 登录的情况下使用音频优化
<a name="without-sso"></a>

1. 前往 Amazon Connect 代理工作区，然后将代理工作区的 URL 复制到记事本。

1. 附加一个查询参数，其键 `VDIPlatform` 和值等于您的特定 VDI 环境。例如：

   1. 对于 Citrix 云桌面，查询参数的值为 `CITRIX`。以下代码显示了完整 URL 的示例：
      + `https://your-instance-url/agent-app-v2?VDIPlatform=CITRIX`

   1. 对于 Amazon WorkSpaces 云桌面，查询参数的值为`AWS_WORKSPACE`。以下代码显示了完整 URL 的示例：
      + `https://your-instance-url/agent-app-v2?VDIPlatform=AWS_WORKSPACE`

   1. 对于 Omnissa 云桌面，查询参数的值为 `OMNISSA`。以下代码显示了完整 URL 的示例：
      + `https://your-instance-url/agent-app-v2?VDIPlatform=OMNISSA`

1. 复制该 URL 并将其粘贴到座席的浏览器中。

1. 建议所有座席将此 URL 添加为书签。这样，座席将来只需单击已添加书签的链接即可轻松访问它。

### 在进行 SSO 登录的情况下使用音频优化
<a name="with-sso"></a>

1. 如果您使用 SSO 直接登录到 Amazon Connect 代理工作区，则需要更改 SSO 设置的中继状态 URL 以附加 VDI 查询参数。为此，请完成以下步骤：

   1. 将用于访问座席工作区的中继状态复制并粘贴为身份提供者（IdP）的中继状态。

   1. 参见[中继状态示例 URLs](configure-saml.md#destination-relay)。在示例中，``%2Fagent-app-v2`` 是目标。

   1. 将具有相应值的 `VDIPlatform` 参数添加到该中继状态。使用上面链接中的示例，Amazon Connect 座席工作区的完整中继状态 URL 如下所示：

      1. 在 Citrix 桌面中

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=CITRIX`

      1. 在 Amazon 中 WorkSpaces

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=AWS_WORKSPACE`

      1. 在 Omnissa 中

         `https://us-east-1.console.aws.amazon.com/connect/federate/instance-id?destination=%2Fagent-app-v2?VDIPlatform=OMNISSA`

1. 设置为`VDIPlatform`中继状态 URL 会自动在代理工作区中为正在使用的特定 VDI 环境设置音频优化。

   1. 从您的 IdP 登录，并确认 ``VDIPlatform`` 作为查询参数存在。