Come posso risolvere gli errori di integrazione di Amazon Lex nella mia istanza Amazon Connect?

Breve descrizione

Di seguito sono elencati i motivi più comuni per cui l'integrazione dei bot Amazon Lex nei flussi di lavoro dei contatti può fallire:

• La quota di risorse è stata superata.
• Non puoi associare il bot Amazon Lex V2 utilizzando l'Interfaccia della linea di comando AWS (AWS CLI).
• Stai cercando di accedere ad AWS Lex in Amazon Connect.
• L'intento di Amazon Lex non viene identificato nei flussi di contatti o l'input del cliente non viene riconosciuto.
• La sessione Amazon Lex scade.
• Il flusso di contatti sta eseguendo il flusso di errori.

Risoluzione

Per risolvere i problemi di integrazione di Amazon Lex con Amazon Connect, verifica innanzitutto se il bot Amazon Lex funziona in modo indipendente. Ad esempio, verifica che funzioni nella console Amazon Lex. Ciò aiuta a determinare se il problema proviene dal bot Amazon Lex sottostante o da Amazon Connect.

Successivamente, attiva i log di flusso e i log delle conversazioni di Amazon Lex per risolvere altri problemi di integrazione.

Infine, risolvi i problemi più comuni per cui l'integrazione dei bot Amazon Lex nei flussi di lavoro dei contatti potrebbe fallire.

La quota di risorse è stata superata

Viene visualizzato il seguente messaggio di errore: "Resource quota exceeded" (Quota di risorse superata).

Questo perché hai superato il limite su almeno uno dei seguenti servizi Amazon Connect:

• La quota predefinita di bot Amazon Lex per istanza è 70. Per supportare più di 70 bot Amazon Lex, esegui la migrazione ad Amazon Lex V2. Per ulteriori informazioni, consulta Amazon Lex V1 to V2 migration guide (Guida per la migrazione da Amazon Lex V1 a V2).
• Il valore predefinito di alias di bot Amazon Lex V2 per istanza è 100.
• Il timeout della chat di integrazione del bot Amazon Lex è di 6 secondi. Questo è il tempo massimo entro il quale il bot Amazon Lex deve rispondere alla richiesta di chat del cliente. Questo numero non può essere aumentato.

Per ulteriori informazioni, consulta Amazon Connect service quotas (Quote di servizio di Amazon Connect).

Non riesci ad associare il bot Amazon Lex V2 utilizzando AWS CLI

Il comando associate-lex-bot di AWS CLI non funziona con Amazon Lex V2, ma associate-bot di AWS CLI funziona sia per Amazon Lex V1 sia per Amazon Lex V2. Pertanto, se utilizzi Amazon Lex V2, utilizza il comando associate-bot di AWS CLI.

Nota: se ricevi messaggi di errore durante l'esecuzione dei comandi dell'Interfaccia della linea di comando AWS (AWS CLI), assicurati di utilizzare la versione più recente di AWS CLI.

Stai cercando di accedere ad AWS Lex in Amazon Connect

L'accesso multi-account non è supportato. Affinché l'integrazione funzioni, Amazon Connect e il bot Amazon Lex devono essere nello stesso account AWS. Tuttavia, il bot Amazon Lex può trovarsi in una Regione AWS diversa.

Nota: una best practice consiste nel disporre del bot Amazon Lex nella stessa regione dell'istanza Connect. Se utilizzi un bot Amazon Lex di un'altra regione, le prestazioni potrebbero non essere ottimali.

L'intento di Amazon Lex non viene identificato nei flussi di contatti o l'input del cliente non viene riconosciuto

Se utilizzi Amazon Lex V2, assicurati di aver impostato l'attributo della lingua corretto. Una best practice consiste nell'utilizzare il blocco Imposta voce nel flusso di contatti. Posizionalo davanti al blocco Get User input (Recupera input utente). Ad esempio, se le impostazioni internazionali del bot Amazon Lex sono en, GB, imposta la lingua nel blocco Imposta voce su Inglese (Regno Unito). Quindi, nel blocco Imposta voce, attiva Imposta l'attributo della lingua.

Importante: per i bot Amazon Lex V2, l'attributo della lingua in Amazon Connect deve corrispondere al modello di lingua utilizzato per creare il bot Amazon Lex. Questo è diverso rispetto ad Amazon Lex V1. Utilizza un blocco Imposta voce per indicare il modello di lingua di Amazon Connect oppure utilizza un blocco Imposta attributi contatti.

La sessione Amazon Lex scade

Quando configuri i valori di timeout per i contatti vocali, assicurati di utilizzare gli attributi di sessione appropriati nel blocco Recupera input cliente che chiama il tuo bot Amazon Lex. Per ulteriori informazioni sul controllo della funzionalità di timeout, consulta Consigli per la configurazione.

Il flusso di contatti sta eseguendo il flusso di errori

Assicurati di fornire un alias per il tuo bot Amazon Lex che corrisponda all'alias fornito nel campo Recupera input cliente obbligatorio del flusso di contatti.

Importante: assicurati che il bot Amazon Lex sia associato all'alias corretto nel flusso di contatti dell'istanza. Inoltre, assicurati che l'alias corrisponda alla versione corretta dell'alias che intendi utilizzare per il tuo bot Amazon Lex.

Se hai ancora problemi dopo aver completato le fasi precedenti, contatta il Supporto AWS. Per istruzioni su come accedere al Supporto AWS, consulta Get administrative support for Amazon Connect (Ottenere supporto amministrativo per Amazon Connect).

È consigliabile fornire le seguenti informazioni con il ticket:

• L'ID/ARN dell'istanza del tuo contact center. Per trovare l'ARN dell'istanza, consulta Find your Amazon Connect instance ID/ARN (Trovare l'ID/ARN dell'istanza Amazon Connect).
• Una descrizione dettagliata del problema.
• Eventuali messaggi di errore che ricevi.
• Screenshot dell'errore.
• Log del flusso di contatti, se applicabile.

---