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.

# Protokollierung und Rückverfolgung für KI-Agenten
<a name="viewing-logs-for-connect-ai-agents-self-service"></a>

Verwenden Sie die folgenden Protokollierungs- und Nachverfolgungsoptionen, um Probleme mit AI-Agenten effektiv zu beheben.
+ **ListSpans API (empfohlen für Orchestrator-AI-Agenten)**: Verwenden Sie die [ ListSpans ](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListSpans.html) API, um die Ausführungsspuren von AI-Agenten für eine Sitzung abzurufen. Dies ist der empfohlene Ausgangspunkt für das Debuggen von Orchestrator-AI-Agenteninteraktionen, da er einen detaillierten Einblick in Agenten-Orchestrierungsabläufe, LLM-Interaktionen und Tool-Aufrufe bietet, sodass Sie nachvollziehen können, wie der AI-Agent eine Anfrage beantwortet hat und welche Tools er ausgewählt und ausgeführt hat.
+ **CloudWatch Protokolle**: Aktivieren Sie die CloudWatch Protokollierung für Ihre AI-Agenten, indem Sie die Schritte unter befolgen. [Überwachen Sie KI-Agenten mit CloudWatch](monitor-ai-agents.md)

  Ältere 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}"
  }
  ```

  Agentische Self-Service-Interaktionen generieren Protokolleinträge mit dem Ereignistyp. `TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION` Diese Einträge beinhalten den gesamten Orchestrierungskontext, z. B. die Aufforderung mit den Toolkonfigurationen, den Gesprächsverlauf mit Toolaufrufen und Ergebnissen, die Fertigstellung des Modells und die Konfiguration des AI-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-Protokollierung, indem Sie die Schritte unter [ Protokollieren von Fehlern mit Fehlerprotokollen in Amazon Lex V2 ](https://docs.aws.amazon.com/lexv2/latest/dg/error-logs.html) befolgen. 
+ **Connect-Kundenprotokollierung**: Aktivieren Sie die Connect-Kundenprotokollierung, indem Sie Ihrem Connect [Protokollierungsverhalten festlegen](set-logging-behavior.md) Customer-Flow einen Flow-Block hinzufügen.