Risolvi i problemi relativi al self-service di Amazon Q in Connect - Amazon Connect
Enable logging (Attiva registrazione)Inasprimento inaspettatoInterruzione inaspettata

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risolvi i problemi relativi al self-service di Amazon Q in Connect

Usa questo argomento per diagnosticare e risolvere problemi comuni con la funzionalità self-service di Amazon Q in Connect.

Abilita la registrazione per le interazioni self-service di Amazon Q in Connect

Per risolvere efficacemente i problemi relativi al self-service, devi visualizzare i log per le interazioni self-service di Amazon Q in Connect. Utilizza le seguenti istruzioni per abilitare il CloudWatch logging, il logging Amazon Lex e il logging Amazon Connect.

  • CloudWatch Registri: abilita CloudWatch la registrazione per la tua istanza Amazon Q in Connect seguendo la procedura riportata di seguito. Monitora Amazon Q in Connect

    Le interazioni self-service generano voci di registro con il tipo di evento TRANSCRIPT_SELF_SERVICE_MESSAGE nel seguente formato:

    {
    "assistant_id": "{UUID}",
    "event_timestamp": 1751414298692,
    "event_type": "TRANSCRIPT_SELF_SERVICE_MESSAGE",
    "session_id": "{UUID}",
    "utterance": "[CUSTOMER]...",
    "prompt": "{prompt used}",
    "prompt_type": "SELF_SERVICE_PRE_PROCESS|SELF_SERVICE_ANSWER_GENERATION",
    "completion": "{Response from model}",
    "model_id": "{model id e.g.: us.amazon.nova-pro-v1:0}",
    "session_message_id": "{UUID}",
    "parsed_response": "{model response}"
}

  • Registrazione Amazon Lex: abilita la registrazione di Amazon Lex seguendo la procedura descritta in Registrazione degli errori con i log degli errori in Amazon Lex V2.

  • Registrazione Amazon Connect: abilita la registrazione di Amazon Connect aggiungendo un blocco di Imposta il comportamento di registrazione flusso nel flusso di Amazon Connect.

I clienti ricevono inaspettatamente il messaggio «Escalating to agent...»

L'escalation imprevista dell'agente si verifica quando si verifica un errore durante l'interazione con il bot self-service o quando il modello non produce una risposta valida per. tool_use SELF_SERVICE_PRE_PROCESS

Fasi per la risoluzione dei problemi

  1. Controlla i log di Amazon Q in Connect: esamina l'completionattributo nella voce di registro associata.

  2. Convalida il motivo dell'interruzione: conferma che sia. stop_reason tool_use

  3. Verifica la risposta analizzata: controlla se il parsed_response campo è compilato, poiché rappresenta la risposta che riceverai dal modello.

Problema noto con Claude 3 Haiku

Se utilizzi Claude 3 Haiku per la preelaborazione self-service, esiste un problema noto a causa del quale il file tool_use JSON viene generato come testo, generando un of invece di. stop_reason end_turn tool_use

Soluzione: aggiorna il prompt personalizzato per inserire la stringa tool_use JSON all'interno dei tag aggiungendo questa istruzione: <tool>

You MUST enclose the tool_use JSON in the <tool> tag

La chat self-service o la chiamata vocale si interrompono in modo imprevisto

Questo problema può verificarsi a causa di timeout o errori di Amazon Lex o di una configurazione errata di Amazon Nova Pro. Questi problemi sono descritti di seguito.

Timeout da Amazon Lex

  • Sintomi: i log di Amazon Connect mostrano un «Errore interno del server» per il blocco Recupera input cliente

  • Causa: il tuo bot self-service è scaduto mentre forniva risultati entro il limite di 10 secondi. Gli errori di timeout non verranno visualizzati nei log di Amazon Q in Connect.

  • Soluzione: semplifica la richiesta eliminando i ragionamenti complessi per ridurre i tempi di elaborazione.

Errori da Amazon Lex

  • Manca il blocco di flusso Amazon Q in Connect: assicurati di aver aggiunto il Amazon Q in Connect blocco al flusso Amazon Connect. Una svista comune è la mancanza di questo blocco, che comporta il seguente errore:

    com.amazonaws.services.lexruntimev2.model.ValidationException: Amazon Lex needs active session for Amazon Q in Connect. 
                            Please provide valid session attribute x-amz-lex:q-in-connect:session-arn

  • Errori generali di Amazon Lex: verifica la presenza di eventuali errori nei log di Amazon Lex e risolvili di conseguenza.

Configurazione Amazon Nova Pro

Se utilizzi Amazon Nova Pro per i tuoi prompt AI personalizzati, assicurati che gli esempi tool_use seguano un formato compatibile con Python.