As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Registro e rastreamento para agentes do Connect AI
<a name="viewing-logs-for-connect-ai-agents-self-service"></a>

Para solucionar problemas do agente Connect AI de forma eficaz, use as seguintes opções de registro e rastreamento.
+ **ListSpans API (recomendada para agentes de IA do orquestrador)**: use a [ListSpans](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListSpans.html)API para recuperar traços de execução do agente de IA para uma sessão. Esse é o ponto de partida recomendado para depurar as interações do agente de IA do orquestrador, pois fornece visibilidade granular dos fluxos de orquestração do agente, das interações do LLM e das invocações de ferramentas, permitindo rastrear como o agente de IA raciocinou por meio de uma solicitação e quais ferramentas ele selecionou e executou.
+ **CloudWatch Registros**: ative o CloudWatch registro para seus agentes do Connect AI seguindo as etapas em[Agentes de IA do Monitor Connect](monitor-ai-agents.md).

  As interações de autoatendimento antigas geram entradas de registro com o tipo de evento `TRANSCRIPT_SELF_SERVICE_MESSAGE` no seguinte 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}"
  }
  ```

  As interações de autoatendimento da Agent geram entradas de registro com o tipo de evento. `TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION` Essas entradas incluem o contexto completo da orquestração, como o prompt com as configurações da ferramenta, o histórico de conversas com chamadas e resultados da ferramenta, a conclusão do modelo e a configuração do agente de IA. O exemplo a seguir mostra os campos principais:

  ```
  {
      "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}"
  }
  ```
+ **Registro no Amazon Lex (somente por autoatendimento)**: habilite o registro no Amazon Lex seguindo as etapas em [Registro de erros com registros de erros no Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/error-logs.html). 
+ **Registro em log do Amazon Connect**: habilite o registro em log do Amazon Connect adicionando um bloco de fluxo [Set logging behavior](set-logging-behavior.md) ao seu fluxo do Amazon Connect.