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à.

# Registrazione e tracciamento per gli agenti Connect AI
<a name="viewing-logs-for-connect-ai-agents-self-service"></a>

Per risolvere efficacemente i problemi degli agenti Connect AI, utilizza le seguenti opzioni di registrazione e tracciamento.
+ **ListSpans API (consigliata per gli agenti AI orchestratori): utilizza l'[ListSpans](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListSpans.html)API per recuperare le tracce di esecuzione degli agenti AI** per una sessione. Questo è il punto di partenza consigliato per il debug delle interazioni con gli agenti AI dell'orchestratore, in quanto fornisce una visibilità granulare sui flussi di orchestrazione degli agenti, sulle interazioni LLM e sulle chiamate degli strumenti, consentendoti di tracciare il modo in cui l'agente AI ha risposto a una richiesta e quali strumenti ha selezionato ed eseguito.
+ **CloudWatch Registri**: abilita CloudWatch la registrazione per i tuoi agenti Connect AI seguendo la procedura riportata di seguito. [Monitora gli agenti Connect AI](monitor-ai-agents.md)

  Le interazioni self-service precedenti 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}"
  }
  ```

  Le interazioni self-service agentiche generano voci di registro con il tipo di evento. `TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION` Queste voci includono il contesto di orchestrazione completo, ad esempio il prompt con le configurazioni degli strumenti, la cronologia delle conversazioni con le chiamate e i risultati degli strumenti, il completamento del modello e la configurazione dell'agente AI. L'esempio seguente mostra i campi chiave:

  ```
  {
      "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}"
  }
  ```
+ **Registrazione Amazon Lex (solo self-service)**: abilita la registrazione di Amazon Lex seguendo i passaggi in Registrazione degli [errori con i log degli errori in Amazon](https://docs.aws.amazon.com/lexv2/latest/dg/error-logs.html) Lex V2. 
+ **Registrazione di log Amazon Connect**: abilita la registrazione di log di Amazon Connect aggiungendo un blocco di flusso [Imposta il comportamento di registrazione](set-logging-behavior.md) nel flusso di Amazon Connect.