Aggiorna la distribuzione degli agenti nello spazio di lavoro degli agenti Amazon Connect tra le Regioni AWS
È possibile utilizzare l'API UpdateTrafficDistribution non solo per distribuire il traffico di telefonia tra regioni, ma anche per distribuire gli agenti tra regioni AWS, in modo completo o graduale, nell'ambito dei normali test di prontezza operativa. Ad esempio, è possibile mantenere il 40% degli agenti in una regione AWS per completare i contatti attivi e spostare gli agenti rimanenti nella regione della replica.
Nota
Quando sposti il traffico di telefonia, sposti anche gli accessi degli agenti e/o dell’agente per assicurarti che sia possibile gestire le chiamate nell’altra Regione. Se non sposti gli agenti, le chiamate vocali verranno trasferite nella Regione modificata, ma non ci saranno agenti disponibili a ricevere le chiamate.
Dopo aver aggiunto gli agenti al gruppo di distribuzione del traffico, utilizza l'API UpdateTrafficDistribution per distribuire gli agenti tra le istanze collegate in un determinato gruppo di distribuzione del traffico con incrementi del 10%. Gli agenti saranno in grado di completare i contatti vocali attivi prima di cambiare regione.
Nota
Se un agente riceve un errore quando tenta di terminare un contatto prima di cambiare Regione, deve aggiornare la pagina dello spazio di lavoro dell’agente. Per ulteriori informazioni, consulta Configurazione del workspace dell'agente di Amazon Connect per supportare gli agenti che si spostano tra regioni AWS.
Indice
Requisiti
Se i seguenti requisiti non vengono soddisfatti, la chiamata all'API UpdateTrafficDistribution avrà esito negativo e restituirà un errore InvalidRequestException:
-
Il gruppo di distribuzione del traffico specificato deve esistere.
-
Lo stato del gruppo di distribuzione del traffico deve essere
ACTIVE. -
È possibile modificare la distribuzione
SignInConfigsolo per il gruppo di distribuzione del traffico predefinito. Il gruppo di distribuzione del traffico predefinito viene creato insieme all'istanza Amazon Connect di replica. Vedi il parametroIsDefaultnel tipo di dati TrafficDistributionGroup.
Quando si chiama UpdateTrafficDistribution dalla regione AWS di origine, è possibile utilizzare l'ID del gruppo di distribuzione del traffico o il nome della risorsa Amazon (ARN). Quando si chiama UpdateTrafficDistribution nella regione della replica, è necessario utilizzare l'ARN del gruppo di distribuzione del traffico.
Abilita entrambe le Regioni AWS durante le normali operazioni
L'API UpdateTrafficDistribution include una distribuzione chiamata SignInConfig. Consente di scegliere quali server di accesso di back-end utilizzare per facilitare l'accesso dell'agente al relativo gruppo di istanze. Indipendentemente dal valore SignInConfig impostato nel gruppo di distribuzione del traffico, gli agenti effettueranno l'accesso a entrambe le istanze del gruppo di distribuzione del traffico.
Per un'esperienza ottimale, è consigliabile abilitare entrambe le regioni AWS durante le normali operazioni. A tal fine, seleziona true per entrambe le distribuzioni SignInConfig. Se devi trasferire l'intero traffico di telefonia e gli agenti in un'unica regione AWS, è consigliabile impostare SignInConfig su false per la regione da cui stai spostando il traffico.
Ad esempio, la chiamata seguente fa sì che gli agenti abbiano il 50% di probabilità di utilizzare il server di accesso us-west-2 e il 50% di utilizzare quello us-east-1 per una determinata chiamata di accesso da parte del gestore di identità.
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 } ] } }'
Al contrario, la seguente distribuzione di accesso instrada il 100% del traffico sull'endpoint di accesso per l'utilizzo del server di accesso 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 } ] } }'
Questa distribuzione controlla solo la regione del server di accesso utilizzata per facilitare l'accesso dell'agente a entrambe le istanze del gruppo di istanze. Non influisce sulla distribuzione degli agenti, controllata dalla parte AgentConfig dell'API UpdateTrafficDistribution.
Importante
Se l'endpoint di accesso non risponde durante l'accesso dell'agente e la distribuzione SignInConfig è suddivisa tra regioni, puoi risolvere gli errori modificando la distribuzione in un'unica regione AWS. In alternativa, se il valore SignInConfig è ponderato per una regione e questa non risponde, puoi provare a spostare SignInConfig nella regione disabilitata. Indipendentemente dalla configurazione del valore SignInConfig, gli agenti trarranno comunque beneficio dall'avere una sessione attiva sia nella regione di origine che in quella di replica, perché tenteranno di accedere alla propria istanza Amazon Connect in entrambe le regioni.
Come spostare tutto il traffico di telefonia e gli agenti tra regioni AWS
Per spostare tutti i nuovi contatti vocali in entrata, la distribuzione degli accessi degli agenti e la distribuzione degli agenti da us-west-2 a us-east-1, utilizza il seguente frammento di codice.
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 } ] } } '
Quando si chiama UpdateTrafficDistribution dalla regione AWS di origine, è possibile utilizzare l'ID del gruppo di distribuzione del traffico o il nome della risorsa Amazon (ARN). Quando si chiama UpdateTrafficDistribution nella regione della replica, è necessario utilizzare l'ARN del gruppo di distribuzione del traffico.