Behebung von Self-Service-Problemen mit Amazon Q in Connect - Amazon Connect
Enable logging (Protokollierung aktivieren)Unerwartete EskalationUnerwartete Kündigung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Behebung von Self-Service-Problemen mit Amazon Q in Connect

Verwenden Sie dieses Thema, um häufig auftretende Probleme mit der Self-Service-Funktionalität von Amazon Q in Connect zu diagnostizieren und zu lösen.

Protokollierung für Self-Service-Interaktionen mit Amazon Q in Connect aktivieren

Um Self-Service-Probleme effektiv zu beheben, müssen Sie die Protokolle für Amazon Q in Connect Self-Service-Interaktionen einsehen. Verwenden Sie die folgenden Anweisungen, um CloudWatch Logging, Amazon Lex-Logging und Amazon Connect Connect-Logging zu aktivieren.

  • CloudWatch Logs: Aktivieren Sie die CloudWatch Protokollierung für Ihre Amazon Q in Connect-Instance, indem Sie den Schritten unter folgenÜberwachen Sie Amazon Q in Connect.

    Self-Service-Interaktionen generieren Protokolleinträge mit dem Ereignistyp TRANSCRIPT_SELF_SERVICE_MESSAGE im folgenden Format:

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

  • Amazon Lex-Protokollierung: Aktivieren Sie die Amazon Lex Lex-Protokollierung, indem Sie die Schritte unter Fehler mit Fehlerprotokollen in Amazon Lex V2 protokollieren befolgen.

  • Amazon Connect Connect-Protokollierung: Aktivieren Sie die Amazon Connect Connect-Protokollierung, indem Sie Ihrem Amazon Connect Protokollierungsverhalten festlegen Connect-Flow einen Flow-Block hinzufügen.

Kunden erhalten unerwartet die Meldung „An den Agenten weiterleiten...“

Eine unerwartete Eskalation durch den Agenten tritt auf, wenn während der Interaktion mit dem Self-Service-Bot ein Fehler auftritt oder wenn das Modell keine gültige tool_use Antwort für liefert. SELF_SERVICE_PRE_PROCESS

Fehlerbehebungsschritte

  1. Überprüfen Sie das Amazon Q in Connect-Protokollen: Untersuchen Sie das completion Attribut im zugehörigen Protokolleintrag.

  2. Überprüfen Sie den Grund für den Stopp: Vergewissern Sie sich, dass dies der stop_reason Fall isttool_use.

  3. Analysierte Antwort überprüfen: Prüfen Sie, ob das parsed_response Feld ausgefüllt ist, da dies die Antwort darstellt, die Sie vom Modell erhalten werden.

Bekanntes Problem mit Claude 3 Haiku

Wenn Sie Claude 3 Haiku für die Self-Service-Vorverarbeitung verwenden, gibt es ein bekanntes Problem, bei dem das tool_use JSON als Text generiert wird, was zu einem von statt zu führen. stop_reason end_turn tool_use

Lösung: Aktualisieren Sie Ihre benutzerdefinierte Eingabeaufforderung, sodass die tool_use JSON-Zeichenfolge in <tool> Tags eingeschlossen wird, indem Sie diese Anweisung hinzufügen:

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

Self-Service-Chat oder Sprachanruf wird unerwartet beendet

Dieses Problem kann aufgrund von Timeouts oder Fehlern von Amazon Lex oder einer falschen Amazon Nova Pro-Konfiguration auftreten. Diese Probleme werden im Folgenden beschrieben.

Timeouts von Amazon Lex

  • Symptome: Amazon Connect Connect-Protokolle zeigen „Interner Serverfehler“ für den Kundeneingabe abrufen Block

  • Ursache: Ihr Self-Service-Bot hat bei der Bereitstellung von Ergebnissen innerhalb der 10-Sekunden-Frist eine Zeitüberschreitung erlitten. Timeout-Fehler werden in Amazon Q in Connect-Protokollen nicht angezeigt.

  • Lösung: Vereinfachen Sie Ihre Eingabeaufforderung, indem Sie komplexe Überlegungen vermeiden, um die Bearbeitungszeit zu verkürzen.

Fehler von Amazon Lex

  • Fehlendes Amazon Q im Connect-Flow-Block: Stellen Sie sicher, dass Sie den Amazon Q in Connect Block zu Ihrem Amazon Connect Connect-Flow hinzugefügt haben. Ein häufiges Versehen besteht darin, dass dieser Block fehlt, was zu dem folgenden Fehler führt:

    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

  • Allgemeine Amazon Lex Lex-Fehler: Überprüfen Sie die Amazon Lex-Protokolle auf Fehler und beheben Sie sie entsprechend.

Konfiguration von Amazon Nova Pro

Wenn Sie Amazon Nova Pro für Ihre benutzerdefinierten KI-Eingabeaufforderungen verwenden, stellen Sie sicher, dass die tool_use-Beispiele einem Python-kompatiblen Format entsprechen.