View a markdown version of this page

Logging und Tracing für Connect AI-Agenten - Amazon Connect

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.

Logging und Tracing für Connect AI-Agenten

Verwenden Sie die folgenden Protokollierungs- und Ablaufverfolgungsoptionen, um Probleme mit dem Connect AI-Agenten effektiv zu beheben.

  • ListSpans API (empfohlen für Orchestrator-AI-Agenten): Verwenden Sie die ListSpansAPI, um die Ausführungsspuren des AI-Agenten für eine Sitzung abzurufen. Dies ist der empfohlene Ausgangspunkt für das Debuggen von Interaktionen mit Orchestrator-AI-Agenten, da er detaillierte Einblicke in die Orchestrierungsabläufe der Agenten, LLM-Interaktionen und Tool-Aufrufe bietet, sodass Sie nachvollziehen können, wie der AI-Agent eine Anfrage bearbeitet hat und welche Tools er ausgewählt und ausgeführt hat.

  • CloudWatch Protokolle: Aktivieren Sie die CloudWatch Protokollierung für Ihre Connect AI-Agenten, indem Sie die Schritte unter befolgenÜberwachen Sie Connect AI-Agenten.

    Bei älteren Self-Service-Interaktionen werden Protokolleinträge mit dem Ereignistyp TRANSCRIPT_SELF_SERVICE_MESSAGE im folgenden Format generiert:

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

    Self-Service-Interaktionen mit Agenten generieren Protokolleinträge mit dem Ereignistyp. TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION Diese Einträge umfassen den vollständigen Orchestrierungskontext, z. B. die Eingabeaufforderung mit den Toolkonfigurationen, den Konversationsverlauf mit Toolaufrufen und -ergebnissen, die Fertigstellung des Modells und die Konfiguration des KI-Agenten. Das folgende Beispiel zeigt die wichtigsten Felder:

    {
    "assistant_id": "{UUID}",
    "event_timestamp": 1772748470993,
    "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "{UUID}",
    "prompt": "{full prompt including system instructions, tool configs, and conversation history}",
    "prompt_type": "ORCHESTRATION",
    "completion": "{model response with message and tool use}",
    "model_id": "{model id e.g.: us.anthropic.claude-haiku-4-5-20251001-v1:0}",
    "parsed_response": "{parsed customer-facing message}",
    "generation_id": "{UUID}",
    "ai_agent_id": "{UUID}"
}

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

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