Résoudre les problèmes liés au libre-service Amazon Q in Connect - Amazon Connect
Activer la journalisationEscalade inattendueRésiliation inattendue

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Résoudre les problèmes liés au libre-service Amazon Q in Connect

Utilisez cette rubrique pour diagnostiquer et résoudre les problèmes courants liés à la fonctionnalité de libre-service Amazon Q in Connect.

Activer la journalisation pour Amazon Q dans les interactions en libre-service Connect

Pour résoudre efficacement les problèmes liés au libre-service, vous devez consulter les journaux d'Amazon Q dans les interactions en libre-service Connect. Suivez les instructions suivantes pour activer la CloudWatch journalisation, la journalisation Amazon Lex et la journalisation Amazon Connect.

  • CloudWatch Journaux : activez la CloudWatch journalisation pour votre instance Amazon Q in Connect en suivant les étapes décrites dansSurveillez Amazon Q dans Connect.

    Les interactions en libre-service génèrent des entrées de journal avec le type d'TRANSCRIPT_SELF_SERVICE_MESSAGEévénement au format suivant :

    {
    "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}"
}

  • Journalisation Amazon Lex : activez la journalisation Amazon Lex en suivant les étapes décrites dans Journalisation des erreurs avec les journaux d'erreurs dans Amazon Lex V2.

  • Journalisation Amazon Connect : activez la journalisation Amazon Connect en ajoutant un bloc de Définir le comportement de journalisation flux dans votre flux Amazon Connect.

Les clients reçoivent de façon inattendue le message « Transférer à l'agent... »

Une escalade inattendue des agents se produit lorsqu'une erreur se produit lors de l'interaction avec le bot en libre-service ou lorsque le modèle ne produit pas de tool_use réponse valide pourSELF_SERVICE_PRE_PROCESS.

Étapes de résolution des problèmes

  1. Vérifiez l'Amazon Q dans les journaux Connect : examinez l'completionattribut dans l'entrée de journal associée.

  2. Validez le motif de l'arrêt : confirmez que stop_reason c'est le castool_use.

  3. Vérifier la réponse analysée : Vérifiez si le parsed_response champ est rempli, car il représente la réponse que vous recevrez du modèle.

Problème connu avec Claude 3 Haiku

Si vous utilisez Claude 3 Haiku pour le prétraitement en libre-service, il existe un problème connu selon lequel il génère le tool_use JSON sous forme de texte, ce qui se traduit par un « de » au lieu stop_reason deend_turn. tool_use

Solution : mettez à jour votre invite personnalisée pour inclure la chaîne tool_use JSON dans les <tool> balises en ajoutant cette instruction :

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

Le chat ou l'appel vocal en libre-service s'arrête de façon inattendue

Ce problème peut être dû à des délais ou à des erreurs provenant d'Amazon Lex ou à une configuration incorrecte d'Amazon Nova Pro. Ces problèmes sont décrits ci-dessous.

Délais d'attente depuis Amazon Lex

  • Symptômes : les journaux Amazon Connect indiquent une « erreur interne du serveur » pour le Obtenir l'entrée utilisateur blocage

  • Cause : votre bot en libre-service a expiré alors qu'il fournissait des résultats dans le délai de 10 secondes. Les erreurs de temporisation n'apparaîtront pas dans les journaux Connect d'Amazon Q.

  • Solution : Simplifiez votre demande en supprimant les raisonnements complexes afin de réduire le temps de traitement.

Erreurs provenant d'Amazon Lex

  • Bloc de flux Amazon Q in Connect manquant : assurez-vous d'avoir ajouté le Amazon Q in Connect bloc à votre flux Amazon Connect. Ce bloc est absent d'un oubli courant, ce qui entraîne l'erreur suivante :

    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

  • Erreurs générales liées à Amazon Lex : vérifiez la présence d'erreurs dans les journaux Amazon Lex et corrigez-les en conséquence.

Configuration d'Amazon Nova Pro

Si vous utilisez Amazon Nova Pro pour vos invites d'IA personnalisées, assurez-vous que les exemples tool_use suivent un format compatible avec Python.