本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在跨 AWS 區域的 Amazon Connect 客服人員工作區中更新客服人員分佈
正如您可以使用 `UpdateTrafficDistribution` API [跨區域分佈電話流量](update-telephony-traffic-distribution.md)一樣，您也可以使用它來將客服人員全部或逐步分佈到各個 AWS 區域，作為常規運營準備測試的一部分。例如，您可以在一個 AWS 區域中保留 40% 的客服人員，以完成作用中的聯絡，並將剩餘的客服人員轉移到複本區域。
**注意**
當您轉移電話流量時，請一併轉移客服人員和/或客服人員登入，以確保他們可以處理其他區域的通話。如果您未轉移客服人員，而語音通話將前往已轉移的區域，就沒有客服人員能接聽電話。
在流量分佈群組新增客服人員之後，您可以使用 [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)
+ [區域切換 UI 橫幅](#regional-switch-ui-banner)
## 要求
如果不符合以下要求，您的 [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 Resource Name (ARN)。當您在複本區域呼叫 `UpdateTrafficDistribution` 時，您必須使用流量分佈群組 ARN。
## 在一般操作 AWS 區域 期間啟用兩者
該 `UpdateTrafficDistribution` API 包含一個名為 `SignInConfig` 的分佈。它可讓您選擇要使用哪些後端登入伺服器來協助客服人員登入其執行個體群組。無論流量分佈群組中的 `SignInConfig` 設定為何，客服人員都會登入流量分佈群組中的這兩個執行個體。
為了獲得最佳體驗，我們建議在一般操作期間啟用這兩個 AWS 區域。若要實現將 `true` 傳遞至兩個 `SignInConfig` 分佈。如果您需要將整個電話流量和客服人員轉移到一個 AWS 區域，建議您`false`將流量轉移來源區域的 `SignInConfig` 變更為 。
例如，下列呼叫會導致客服人員有 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 區域轉移所有電話流量和客服人員
若要將所有新的撥入語音聯絡、客服人員登入分佈和客服人員分佈從 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 Resource Name (ARN)。當您在複本區域呼叫 `UpdateTrafficDistribution` 時，您必須使用流量分佈群組 ARN。
## 區域切換 UI 橫幅
客服人員工作區和 CCP 將提供 UI 橫幅反白顯示區域切換。
如果客服人員在其區域因流量分佈群組 (TDG) 調整而變更時**正在聯絡**上，他們將看到類似以下的橫幅。一旦他們完成語音聯絡並關閉 ACW 狀態，客服人員就會自動更新到新區域，無需採取任何動作。如果客服人員無法關閉聯絡案例，他們可以在**備份中選取繼續**，此時會出現一個快顯視窗，要求確認以切換到替代區域。
我們建議您調整執行手冊和代理程式訓練指南以反映此內容
