View a markdown version of this page

Registro e rastreamento para agentes do Connect AI - Amazon Connect

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

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 ListSpansAPI 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 emAgentes de IA do Monitor Connect.

    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.

  • Registro em log do Amazon Connect: habilite o registro em log do Amazon Connect adicionando um bloco de fluxo Set logging behavior ao seu fluxo do Amazon Connect.