Cómo ver los registros de seguimiento del agente

Antes de comenzar

Para ver los seguimientos de agentes, debes cumplir con los siguientes requisitos:

  • Habilitar APIs: Asegúrate de que las siguientes APIs estén habilitadas para tu Google Cloud proyecto:
    • API de Cloud Trace
    • API de Cloud Logging
    • API de telemetría
  • Configurar el seguimiento de agentes: Tu agente debe estar configurado para enviar datos de seguimiento a Google Cloud. Si deseas obtener instrucciones para habilitar el seguimiento de diferentes tipos de agentes, consulta Configura el seguimiento.
  • Configurar permisos: Para ver seguimientos y registros, necesitas roles de IAM que proporcionen los permisos necesarios, como los roles de Usuario de Cloud Trace (roles/cloudtrace.user) y Visualizador de registros (roles/logging.viewer). Para obtener más información, consulta Control de acceso de Cloud Trace y Control de acceso de Cloud Logging.

El seguimiento distribuido es una técnica de diagnóstico que hace un seguimiento de la progresión de una sola solicitud a medida que viaja a través de varios servicios y componentes distribuidos en tu arquitectura. Debido a que los agentes de IA generativa emplean bucles de razonamiento no determinísticos para elegir de forma dinámica herramientas y rutas de ejecución, las métricas convencionales en un momento determinado suelen ser insuficientes para la depuración. Los seguimientos son esenciales para la observabilidad de los agentes, ya que proporcionan una línea de tiempo completa y secuencial de estas interacciones impredecibles, lo que te permite ver exactamente por qué un agente tomó una decisión específica.

Explora los seguimientos

Para acceder a los datos de ejecución detallados de un agente, haz lo siguiente:

  1. En la Google Cloud consola, navega a la página Agent Platform > Agent Registry.

    Ir al registro de agentes

  2. Selecciona tu agente específico.

  3. Haz clic en la pestaña Seguimientos.

Esta interfaz te permite inspeccionar los detalles de ejecución paso a paso de tu agente. Un seguimiento es un registro inmutable y factual del comportamiento del agente, incluidas las entradas del modelo, las respuestas y las llamadas a herramientas. La vista de seguimiento incluye un grafo acíclico dirigido (DAG) de sus intervalos, entradas y salidas, y atributos de metadatos.

La pestaña Seguimientos proporciona tres vistas distintas para explorar tus datos de telemetría:

  • Vista de sesión: Agrupa las ejecuciones por sesiones de usuarios individuales, lo que te permite analizar conversaciones de varios turnos y el comportamiento del agente a lo largo del tiempo.
  • Vista de seguimiento: Se enfoca en los seguimientos de solicitudes individuales de extremo a extremo, que representan una sola ruta de ejecución.
  • Vista de intervalo: Proporciona una lista detallada de las operaciones individuales (intervalos) que se ejecutan dentro de tus seguimientos, como una llamada específica a un modelo de base, una solicitud a la API o una ejecución de herramienta externa.

Vista de seguimiento único (contexto de sesión)

Cuando seleccionas una sesión específica en la vista de sesión, se abre un panel de detalles con un panel de lista en el lado izquierdo que muestra todos los seguimientos individuales contenidos en esa sesión de varios turnos. El panel principal agrega el contexto de toda la sesión y muestra los mensajes de entrada y del asistente con formato, junto con las métricas generales de la sesión, como la duración, los tokens totales de GenAI y las puntuaciones de evaluación continua.

Vista de seguimiento único (seguimiento directo o contexto de intervalo)

Como alternativa, si seleccionas un seguimiento específico en la vista de seguimiento o un intervalo distinto en la vista de intervalo, el panel de detalles se abrirá directamente a esa ejecución específica. Debido a que estás viendo una sola operación en lugar de una sesión agrupada, el panel de lista de la izquierda está oculto, lo que permite una inspección inmediata y enfocada de la latencia, los atributos y los posibles errores específicos de esa operación.

Almacenamiento de datos y control de acceso

Para mantener la seguridad y el cumplimiento, Agent Platform de Gemini Enterprise separa los metadatos operativos del contenido conversacional real:

  • Métricas y atributos de ejecución: La telemetría estándar (como la latencia, los códigos de estado y los metadatos estructurales) se almacena directamente dentro de los intervalos de seguimiento.
  • Solicitudes y respuestas: Los datos potencialmente sensibles, como las solicitudes de los usuarios y las respuestas del modelo, no se almacenan en los intervalos. En cambio, se enrutan a Cloud Logging o Cloud Storage, según la configuración de tu organización. Esto permite a los administradores implementar controles detallados de Identity and Access Management (IAM) sobre los datos conversacionales sensibles.

La IU de Agent Platform de Gemini Enterprise comprende automáticamente la correlación subyacente entre tus intervalos de seguimiento y estos registros de solicitud y respuesta almacenados de forma segura. Cuando abres una vista de detalles de seguimiento, la plataforma vuelve a unir estos datos sin problemas y presenta una vista unificada del comportamiento del agente sin comprometer las reglas de administración de datos.

Para obtener más información sobre la configuración de destinos de almacenamiento para datos conversacionales, consulta Recopila y visualiza solicitudes y respuestas multimodales.

¿Qué sigue?