La observabilidad de agentes en Gemini Enterprise Agent Platform proporciona visibilidad integral del rendimiento, el comportamiento y el estado de los agentes implementados y los servidores del Protocolo de contexto del modelo (MCP). Si supervisas las métricas clave, rastreas las rutas de ejecución y observas tu sistema multiagente en su totalidad, puedes diagnosticar problemas, optimizar el consumo de recursos y mejorar la confiabilidad de tus agentes.
En este documento, se proporciona una descripción general de las herramientas de observabilidad disponibles en Gemini Enterprise Agent Platform, incluidas la topología de todo el sistema, la supervisión de agentes individuales y las métricas del servidor de MCP.
Configuración de la telemetría
Para propagar estos paneles de observabilidad, topologías y seguimientos, tus agentes deben estar configurados para enviar datos de telemetría en el formato de OpenTelemetry a los sistemas de almacenamiento en Google Cloud Observability.
Asegúrate de que los entornos de tu agente y del servidor de MCP estén configurados correctamente para emitir estos datos. Los componentes integrados de Cloud de Confiance by S3NS emiten automáticamente telemetría en el formato de OpenTelemetry. Por ejemplo, Model Armor emite de forma nativa telemetría estandarizada, lo que te permite exponer y supervisar sin problemas las intercepciones de políticas en tiempo real directamente en tus datos de seguimiento sin necesidad de ninguna instrumentación personalizada.
Para obtener instrucciones y requisitos de configuración de la telemetría del agente, consulta los siguientes recursos:
- Para instrumentar agentes creados con el ADK, consulta Instrumenta aplicaciones del ADK con OpenTelemetry.
- Para instrumentar agentes en Agent Runtime que no se crearon con el ADK, consulta Instrumenta aplicaciones de IA generativa.
- Para obtener telemetría del servidor de MCP, consulta Usa Cloud Trace para supervisar el uso de las herramientas de MCP.
- Para obtener información sobre la telemetría de Model Armor, consulta Configura el registro de Model Armor.
Indicadores de observabilidad
Gemini Enterprise Agent Platform proporciona observabilidad a través de métricas, seguimientos y registros.
Cuando seleccionas un agente específico del Registro, la pestaña Observabilidad proporciona un conjunto de paneles específicos para supervisar su estado operativo, rendimiento y uso de la infraestructura. Usa la navegación de la izquierda en la pestaña Observabilidad para alternar entre las siguientes vistas:
- Descripción general: Realiza un seguimiento del uso de alto nivel durante el período seleccionado, incluidas las sesiones totales, los turnos promedio por sesión y las invocaciones totales del agente. Los gráficos de series temporales muestran el uso de tokens (entrada frente a salida), el volumen general de tráfico del agente, los percentiles de latencia (p50, p95, p99) y las tasas de error.
- Evaluación: Muestra monitores en línea para la evaluación continua de la calidad. Esto incluye widgets de series temporales que hacen un seguimiento de la calidad promedio de las respuestas, las métricas de seguridad, las tasas de alucinación y la calidad del uso de herramientas.
- Modelos: Desglosa el rendimiento por el modelo de base subyacente. Puedes supervisar la latencia de p95, los recuentos totales de llamadas, las tasas de error, las fallas de cuota y el uso de tokens aislados por modelos específicos.
- Herramientas: Supervisa las herramientas y los servicios externos conectados al agente. En esta vista, se detallan la latencia de p95, los recuentos de llamadas y las tasas de error por herramienta, así como la frecuencia de las interacciones en las que no se llamó a ninguna herramienta.
- Uso: Proporciona métricas a nivel de la infraestructura para el entorno de ejecución del agente, incluida la asignación de CPU del contenedor, la asignación de memoria del contenedor y el uso de tokens.
- Registros: Muestra un flujo filtrable de registros de agentes sin procesar, incluidos la gravedad, las marcas de tiempo y los resúmenes de ejecución para solucionar problemas en profundidad. Para obtener más información, consulta Visualiza los registros del agente.
Además de los paneles de la pestaña Observabilidad, puedes usar la pestaña Seguimientos del agente para inspeccionar la ejecución paso a paso de sesiones específicas, incluidos los grafos acíclicos dirigidos de intervalos y entradas/salidas. Para obtener más información, consulta Visualiza los seguimientos del agente. También puedes usar la pestaña Topología para ver las dependencias de entrada y salida específicas de ese agente único.
En el caso de los servidores de MCP, puedes supervisar el recuento de solicitudes y la duración de las solicitudes p95 para hacer un seguimiento del uso y la capacidad de respuesta.
Auditorías de acciones de agentes
Para respaldar las auditorías de seguridad y cumplimiento empresarial, Gemini Enterprise Agent Platform usa
el registro de atribución doble para registrar la actividad de los agentes en Cloud Logging. Cuando un
agente realiza una acción o llama a una herramienta en nombre de una persona (autoridad delegada por el usuario),
los registros de auditoría y ejecución registran la identidad del agente
basada en SPIFFE
(principal://... en los registros de auditoría o spiffe://... en los registros de ejecución) y la
identidad del usuario humano que inicia la acción. Cuando un agente actúa de forma autónoma con su
propia autoridad, los registros atribuyen la acción directamente a la identidad única del agente.
Los auditores y los administradores de seguridad pueden aislar y revisar los eventos iniciados por el agente
en Cloud Logging filtrando por la marca is_agentic=true en las consultas
de registro. Combinar is_agentic=true con la identidad del agente o la principal del usuario
te permite rastrear las rutas de ejecución de extremo a extremo y verificar la aplicación de políticas en
todas las interacciones del agente.
Convenciones de IA generativa de OpenTelemetry
Los seguimientos de agentes y los registros de instrucciones y respuestas dependen en gran medida de las convenciones semánticas de OpenTelemetry para sistemas de IA generativa para estandarizar la forma en que se captura, estructura y, luego, informa la telemetría de IA generativa.
Cumplir con estas convenciones es fundamental para el seguimiento de agentes, ya que establece un formato universal y neutral en cuanto al proveedor para describir flujos de trabajo de agentes complejos y de varios pasos, como ejecuciones de herramientas, pasos de recuperación y consumo de tokens. Esta estandarización ayuda a lograr una interoperabilidad fluida entre diferentes backends de observabilidad y herramientas de análisis, tanto dentro como fuera de Cloud de Confiance by S3NS.
¿Qué sigue?
- Visualiza las relaciones de los agentes como un gráfico de topología.
- Consulta los seguimientos del agente para depurar su comportamiento.
- Evalúa tus agentes.