View a markdown version of this page

Registro y rastreo de los agentes de IA - Amazon Connect Customer

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 rastreo de los agentes de IA

Para solucionar los problemas de los agentes de IA de forma eficaz, utilice las siguientes opciones de registro y rastreo.

  • ListSpans API (recomendada para los agentes de IA de Orchestrator): utilice la ListSpans API para recuperar los rastros de 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 detallada de los flujos de orquestación de los agentes, las interacciones de la LLM y las invocaciones de herramientas, lo que permite rastrear cómo el agente de IA razonó a través de una solicitud y qué herramientas seleccionó y ejecutó.

  • CloudWatch Registros: habilita el CloudWatch registro para tus agentes de IA siguiendo los pasos que se indican en. Supervise a los agentes de IA utilizando CloudWatch

    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 entre agencias generan entradas de registro con el tipo de evento. TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION Estas entradas incluyen el contexto completo de la orquestación, como la ventana 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): habilite el registro de Amazon Lex siguiendo los pasos que se indican en Registrar errores con registros de errores en Amazon Lex V2.

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