View a markdown version of this page

Registro y seguimiento de los agentes de Connect AI - Amazon Connect

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Registro y seguimiento de los agentes de Connect AI

Para solucionar los problemas del agente Connect AI de forma eficaz, utilice las siguientes opciones de registro y seguimiento.

  • ListSpans API (recomendada para los agentes de IA de Orchestrator): utilice la ListSpansAPI para recuperar el seguimiento de la ejecución de los agentes de IA durante una sesión. Este es el punto de partida recomendado para depurar las interacciones entre los agentes de IA de Orchestrator, ya que proporciona una visibilidad pormenorizada de los flujos de orquestación de los agentes, las interacciones de la LLM y las invocaciones de herramientas, lo que te permite rastrear cómo el agente de IA razonó una solicitud y qué herramientas seleccionó y ejecutó.

  • CloudWatch Registros: habilite el CloudWatch registro para sus agentes de Connect AI siguiendo los pasos que se indicanAgentes de IA de Monitorear Connect.

    Las interacciones de autoservicio antiguas generan entradas de registro con el tipo de evento TRANSCRIPT_SELF_SERVICE_MESSAGE en el siguiente 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}"
}

    Las interacciones de autoservicio de los agentes generan entradas de registro con el tipo de evento. TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION Estas entradas incluyen el contexto completo de la organización, como el mensaje con las configuraciones de las herramientas, el historial de conversaciones con las llamadas a las herramientas y los resultados, la finalización del modelo y la configuración del agente de IA. El siguiente ejemplo muestra los campos clave:

    {
    "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 de Amazon Lex (solo de autoservicio): active el registro de Amazon Lex siguiendo los pasos que se indican en Registrar errores con registros de errores en Amazon Lex V2.

  • Registro de Amazon Connect: active el registro de Amazon Connect añadiendo un bloque de flujo Configurar el comportamiento del registro en su flujo de Amazon Connect.