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

# 更新您的 Amazon Connect 代理工作区中跨 AWS 区域的代理分布
<a name="update-agents-across-regions"></a>

正如您可以使用 `UpdateTrafficDistribution` API [跨区域分配电话流量](update-telephony-traffic-distribution.md)一样，您也可以使用它跨 AWS 区域分配座席，无论是全部还是逐步分配，这都是常规运营准备情况测试的一部分。例如，您可以将 40% 的代理留在一个 AWS 区域以完成活跃的联系，然后将剩余的代理转移到副本区域。

**注意**  
当您转移电话流量时，还要转移 and/or 代理的登录信息，以确保他们可以处理其他区域的呼叫。如果您不转移座席，语音通话将转至已转移的区域，但没有任何座席可以接听通话。

将代理添加到流量分配组后，使用 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API 以 10% 的增量在给定流量分布组中的关联实例之间分配代理。您的座席将能够在转移区域之前完成活动语音联系人。

**注意**  
如果座席在转移区域之前尝试结束联系时出现错误，则他们需要刷新座席工作区页面。有关更多信息，请参阅 [设置 Amazon Connect 代理工作区以支持代理跨 AWS 区域移动](setup-agentworkspace-switchover.md)。

**Topics**
+ [要求](#update-agent-traffic-distribution-requirements)
+ [在常规操作期间启用这两个区域](#change-signin-weights)
+ [如何跨 AWS 区域转移所有电话流量和代理](#shift-all-traffic)
+ [区域交换机界面横幅](#regional-switch-ui-banner)

## 要求
<a name="update-agent-traffic-distribution-requirements"></a>

如果不满足以下要求，则您的 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html)API 调用将失败，并显示`InvalidRequestException`：

1. 指定的流量分配组必须存在。

1. 流量分配组的状态必须为 `ACTIVE`。

1. 如果要更改 `SignInConfig` 分配，只能对默认流量分配组执行此操作。在创建副本 Amazon Connect 实例时会创建默认的流量分配组。参见[TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html)数据类型中的`IsDefault`参数。

当您从源 AWS 区域调用 `UpdateTrafficDistribution` 时，可以使用流量分配组 ID 或 Amazon 资源名称（ARN）。在副本区域中调用 `UpdateTrafficDistribution` 时，必须使用流量分配组 ARN。

## AWS 区域 在常规操作期间同时启用两者
<a name="change-signin-weights"></a>

`UpdateTrafficDistribution` API 包含一个称为 `SignInConfig` 的分配。它允许您选择使用哪些后端登录服务器来方便座席登录到其实例组。无论您的流量分配组中设置了什么 `SignInConfig`，座席都将登录到流量分配组中的两个实例。

为了获得最佳体验，我们建议在常规操作期间同时启用两个 AWS 区域。要实现此目的，请将 `true` 传递至两个 `SignInConfig` 分配。如果您需要将全部电话流量和代理转移到一个 AWS 区域，我们建议将`SignInConfig`要`false`转移流量的区域更改为。

例如，以下调用会导致座席有 50% 的几率使用 us-west-2 登录服务器和 50% 的几率使用 us-east-1 登录服务器从身份提供者那里进行给定登录调用。

```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
   "SignInConfig":{
      "Distributions":[
         {
            "Region":"us-west-2",
            "Enabled":true
         },
         {
            "Region":"us-east-1",
            "Enabled":true
         }
      ]
   }
}'
```

相反，以下登录分配会路由登录端点上 100% 的流量，以使用 us-east-1 登录服务器。

```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
   "SignInConfig":{
      "Distributions":[
         {
            "Region":"us-west-2",
            "Enabled":false
         },
         {
            "Region":"us-east-1",
            "Enabled":true
         }
      ]
   }
}'
```

此分配仅控制使用登录服务器的哪个区域，以便于座席能够登录到其实例组中的两个实例。它不会影响由 `UpdateTrafficDistribution` API 的 `AgentConfig` 部分控制的座席的分配。

**重要**  
如果在座席登录期间登录端点无响应，并且您的 `SignInConfig` 分配被跨区域拆分，则可以通过将分配更改为单个 AWS 区域来纠正错误。或者，如果您的 `SignInConfig` 在一个区域上加权并且它无响应，您可以尝试将 `SignInConfig` 转移到禁用区域。无论您的 `SignInConfig` 如何配置，座席仍将受益于在源区域和副本区域中均处于活动状态的会话，因为它们将尝试在这两个区域中登录到其 Amazon Connect 实例。

## 如何跨 AWS 区域转移所有电话流量和代理
<a name="shift-all-traffic"></a>

要将所有新的入站语音联系人、座席登录分配和座席分配从 us-west-2 转移到 us-east-1，请使用以下代码片段。

```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
   "SignInConfig":{
      "Distributions":[
         {
            "Region":"us-west-2",
            "Enabled":false
         },
         {
            "Region":"us-east-1",
            "Enabled":true
         }
      ]
   },
   "AgentConfig":{
      "Distributions":[
         {
            "Region":"us-west-2",
            "Percentage":0
         },
         {
            "Region":"us-east-1",
            "Percentage":100
         }
      ]
   },
   "TelephonyConfig":{
      "Distributions":[
         {
            "Region":"us-west-2",
            "Percentage":0
         },
         {
            "Region":"us-east-1",
            "Percentage":100
         }
      ]
   }
}
'
```

当您从源 AWS 区域调用 `UpdateTrafficDistribution` 时，可以使用流量分配组 ID 或 Amazon 资源名称 (ARN)。在副本区域中调用 `UpdateTrafficDistribution` 时，必须使用流量分配组 ARN。

## 区域交换机界面横幅
<a name="regional-switch-ui-banner"></a>

代理工作区和 CCP 将提供一个突出显示区域切换的用户界面横幅。

如果客服人员因流量分配组 (TDG) 调整而导致其区域发生变化时正在**联系**人中，他们将看到类似于下方的横幅。他们完成语音联系并关闭 ACW 状态后，座席将自动更新到新区域，无需执行任何操作。如果代理在关闭联系人时遇到问题，他们可以选择 Contin **ue in** Backup，将出现一个弹出窗口，要求确认切换到备用区域。

我们建议您调整操作手册和代理培训指南以反映这一点

![\[代理工作区用户界面显示横幅，突出显示 TDG 调整期间的区域故障转移。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/acgr-failover-banner.png)


![\[代理选择 “在 Backup 中继续” 时出现的确认弹出窗口。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/acgr-failover-confirmation.png)