# Vista de agentes
La *vista de agentes* proporciona un panel de control personalizado para los agentes de la cuenta. Puede ver los datos de los agentes alojados en servicios nativos de AWS como AgentCore Runtime, Lambda o Amazon EC2. La vista también muestra los agentes que emiten telemetría a CloudWatch.
**Información general**
Las métricas y los paneles muestran los datos de los intervalos de agentes muestreados. Para obtener información acerca de los intervalos de agentes, consulte [Intervalos](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/observability-telemetry.html#agent_spans).
Las siguientes métricas de agentes son compatibles con:
+ Agentes y puntos de conexión: número de agentes y alias instrumentados y que emiten intervalos
+ Sesiones: número de sesiones creadas por agentes instrumentados que emiten intervalos. Una sesión es similar a una conversación y contiene un contexto amplio
+ Seguimientos: número de seguimientos creados por agentes instrumentados que emiten intervalos. Un rastro es un ciclo individual de solicitud y respuesta en una sesión
+ Tasa de errores: porcentaje de errores en las interacciones de los agentes
+ Tasa de limitación: porcentaje de interacciones de agentes limitadas
Elija **Ver detalles** para ver las métricas de los agentes en gráficos.
![\[Vista de agentes\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/GenAI_AgentCoreGraphs.png)
**Métricas de tiempo de ejecución**
Las métricas y los paneles del tiempo de ejecución muestran datos de la primitiva del tiempo de ejecución. Con esta primitiva, puede alojar los agentes en el tiempo de ejecución de Amazon Bedrock AgentCore. Para más información, consulte [Creación de un tiempo de ejecución de AgentCore](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agents-runtime-create.html).
AgentCore Runtime admite estas métricas
+ Agentes y alias del tiempo de ejecución: hace un seguimiento del número de agentes y alias alojados en AgentCore Runtime
+ Sesiones del tiempo de ejecución: hace un seguimiento del número de sesiones creadas por los agentes que se ejecutan en AgentCore Runtime. Una sesión es similar a una conversación y contiene un contexto amplio de todo el flujo de interacciones. Útil para monitorear el uso general de la plataforma, planificar la capacidad y comprender los patrones de interacción de los usuarios
+ Invocaciones del tiempo de ejecución: número total de solicitudes hechas a la API del plano de datos. Cada llamada a la API cuenta como una invocación, independientemente del tamaño de la carga útil de la solicitud o del estado de la respuesta
+ Errores del tiempo de ejecución: número de errores del sistema y del usuario. Para ver las definiciones de errores del sistema y del usuario, consulte [Métricas del tiempo de ejecución proporcionadas por AgentCore](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/observability-runtime-metrics.html)
+ Limitaciones del tiempo de ejecución: el número de solicitudes limitadas por el servicio debido a que se han superado las TPS (transacciones por segundo) permitidas. Estas solicitudes devuelven ThrottlingException con el código de estado HTTP 429. Monitoree esta métrica para determinar si debe revisar las cuotas de servicio u optimizar los patrones de las solicitudes
Consulte los cambios en las métricas a lo largo del tiempo en el panel predeterminado. Amplíe **Ver detalles** para mostrar los gráficos de las métricas.
![\[Vista del tiempo de ejecución\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/GenAI_Runtime.png)
**Agentes**
Los agentes son componentes que recopilan y envían datos de monitoreo desde las aplicaciones. La tabla de agentes muestra todos los agentes configurados en su cuenta. Estos agentes se pueden alojar en servicios nativos de AWS como AgentCore Runtime, Lambda o Amazon EC2. En la tabla también se muestran otros agentes instrumentados para emitir telemetría a CloudWatch.
Puede usar **Filtrar agentes** para encontrar un agente específico que quiera analizar a fondo o también puede utilizar los nombres de las columnas para ordenar los agentes y encontrar el agente necesario. Seleccione el icono de engranaje para mostrar u ocultar columnas adicionales.
![\[Vista de agentes del tiempo de ejecución\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/GenAI_agents.png)
Para ver los detalles del agente, amplíe el nombre del agente.
![\[Información general de los agentes del tiempo de ejecución\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/GenAI_agentsdetails_new.png)
**Detalles del agente: información general**
La pestaña Información general muestra paneles automáticos de las métricas de los agentes. Estas métricas provienen de muestras de intervalos y métricas de tiempo de ejecución (cuando el agente utiliza AgentCore Runtime).
El panel **Evaluadores** incluye información derivada de los intervalos con las evaluaciones activadas.
+ Los mejores deltas en las puntuaciones de los evaluadores: muestra los agentes evaluadores que han experimentado más cambios desde el último periodo, en función del periodo de tiempo que haya seleccionado.
+ Métricas de configuración de evaluación: muestra las métricas del estado operativo de los agentes evaluadores, lo que incluye el número de veces que se ejecutaron las evaluaciones y el número de errores detectados.
Para editar una configuración de evaluación con la consola de Amazon Bedrock AgentCore, haga clic en el enlace de la columna **Evaluador** o **Configuración de evaluación**. Para revisar los resultados del evaluados, haga clic en una puntuación de la columna **Puntuación media**. Para ver todas las evaluaciones del agente, elija la pestaña **Evaluaciones**. Para obtener más información, consulte [Detalles del agente: evaluaciones](session-traces-evaluations.md).
El panel **Métricas de agentes** incluye métricas derivadas de intervalos muestreados:
+ Sesiones y seguimientos: recuento de sesiones y seguimientos de este agente
+ Uso del token de MF: recuento total del consumo de tokens del modelo fundacional. Puede filtrar el gráfico según un modelo fundacional concreto
+ Errores del sistema y del cliente: recuento de los errores del sistema durante el procesamiento de las solicitudes. Los altos niveles de errores en el servidor pueden indicar posibles problemas de infraestructura o servicio que requieren una investigación. Los errores del cliente se derivan de las solicitudes no válidas. Los altos niveles de errores del lado del cliente pueden indicar problemas con el formato de las solicitudes o los permisos
+ Errores y latencia por intervalo: los índices de error y la latencia de un intervalo concreto. Tenga en cuenta que un intervalo puede aparecer en muchos agentes
+ Limitaciones: número de solicitudes limitadas por el servicio debido a que se superan las TPS (transacciones por segundo) permitidas
+ Llamadas de tokens de acceso y Auth:Authorization entrantes: número de solicitudes de autenticación entrantes procesadas por el agente, como las comprobaciones de autorización y las validaciones de tokens de acceso procedentes de clientes o servicios externos
+ Distribución de Auth:Usage salientes: patrón de distribución de los métodos de autenticación salientes utilizados por el agente, que muestra la frecuencia y los tipos de mecanismos de autenticación empleados al acceder a servicios externos
El panel **Métricas de Runtime** incluye las métricas que AgentCore Runtime genera automáticamente:
+ Sesiones e invocaciones de Runtime: recuento de sesiones e invocaciones que este agente concreto generó mientras estaba alojado en Runtime
+ Latencia de Runtime: latencia de las solicitudes de los agentes alojados en Runtime
+ Limitaciones de Runtime: número de solicitudes limitadas por el servicio debido a que se superan las TPS (transacciones por segundo) permitidas
# Detalles de agentes: sesiones
Un agente puede tener varias sesiones. Vea la sesión en la pestaña *Sesiones*. Utilice **Filtrar sesiones** u ordene las columnas para encontrar la sesión necesaria.
Elija el **ID de sesión** para ver las métricas del resumen de la sesión y la lista de seguimientos que pertenecen a esa sesión. Las métricas de sesión incluyen:
+ Rastros: número de rastros que pertenecen a las sesiones
+ Errores del servidor: recuento de los errores del sistema durante el procesamiento de las solicitudes. Los altos niveles de errores en el servidor pueden indicar posibles problemas de infraestructura o servicio que requieren una investigación
+ Errores del cliente: los errores del cliente se derivan de las solicitudes no válidas. Los altos niveles de errores del lado del cliente pueden indicar problemas con el formato de las solicitudes o los permisos
+ Limitaciones: número de solicitudes limitadas correspondientes a esta sesión debido a que se superaron las TPS (transacciones por segundo) permitidas
+ Detalles de la sesión: metadatos sobre la sesión, como la hora de inicio, la hora de finalización y el ID de la sesión
Para analizar una lista de seguimientos en una sesión, seleccione **Filtrar rastros** para reducirlos u ordene las columnas de la tabla para que aparezca el seguimiento concreto que quiere investigar.
Tras seleccionar un rastro, en el panel derecho se muestran los detalles del rastro. Para cada rastro, puede ver el resumen de este, los intervalos y los detalles del contenido del rastro.
En **Resumen del rastro**, puede ver las siguientes métricas:
**nota**
Los campos de la página de resumen son coherentes en **Vista de agentes**, **Vista de sesiones** y **Vista de rastros**.
+ Intervalos: número de intervalos en un rastro
+ Errores del servidor: recuento de los errores del sistema durante el procesamiento de las solicitudes. Los altos niveles de errores en el servidor pueden indicar posibles problemas de infraestructura o servicio que requieren una investigación
+ Errores del cliente: los errores del cliente se derivan de las solicitudes no válidas. Los altos niveles de errores del lado del cliente pueden indicar problemas con el formato de las solicitudes o los permisos
+ Limitaciones: el número de solicitudes limitadas correspondientes a esta sesión se debe a que se superan las TPS (transacciones por segundo) permitidas
+ Latencia de intervalo de P95: latencia del percentil 95 de todas las invocaciones de este intervalo en particular. Tenga en cuenta que un intervalo se puede utilizar en muchos agentes
+ Detalles del rastro: metadatos sobre el rastro, como la hora de inicio, la hora de finalización y el ID del rastro
![\[Vista de intervalo\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/GenAI_span.png)
Elija **Cronología** para ver la duración de cada intervalo y comprender el intervalo que tardó más y contribuyó a una respuesta lenta.
![\[Vista de trayectoria\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/GenAI_agenttrajectory.png)
Para analizar las relaciones de los intervalos y las llamadas posteriores, elija **Trayectoria** para comprender la relación interconectada de los intervalos y las llamadas posteriores de estos intervalos.
En **Intervalos**, seleccione un evento de intervalo individual para revisar los datos del intervalo en su formato original. Revise los datos del intervalo en su forma original. Para una solución de problemas detallada, seleccione la pestaña **Eventos** para examinar las entradas y salidas del modelo.
# Detalles del agente: seguimientos
Cada agente puede tener varios seguimientos. Vea los detalles de los rastros en la pestaña **Rastros**. Elija **Filtrar rastros** u ordene las columnas para encontrar el rastro necesario.
![\[Vista de resumen de rastros\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/Trace-summary.png)
# Detalles del agente: evaluaciones
Las evaluaciones proporcionan métricas de supervisión continua de la calidad para agentes de IA. Puede utilizar la información proporcionada por el panel para evaluar el rendimiento, la calidad y la fiabilidad de los agentes de IA.
En lugar de basarse en casos de prueba simulados, las evaluaciones capturan las sesiones reales de usuarios y las interacciones de los agentes, lo que proporciona una visión completa del rendimiento de los agentes, desde la entrada hasta la salida final. Con las evaluaciones de los agentes, puede definir reglas de muestreo para evaluar solo un porcentaje de las sesiones o rastros y, a continuación, aplicar una variedad de evaluadores para evaluar y puntuar el rendimiento operativo de un agente de IA. Las evaluaciones y puntuaciones resultantes se muestran en el panel Evaluaciones, lo que le permite supervisar las tendencias, identificar posibles problemas de calidad, configurar alarmas e investigar y diagnosticar posibles problemas.
El panel Evaluaciones muestra todas las evaluaciones que se han activado y configurado para el agente seleccionado. Para obtener más información sobre la configuración de las evaluaciones para un agente, consulte [Evaluaciones de AgentCore](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/evaluations.html). Puede ampliar cada evaluación para ver las sesiones, los rastros y los periodos que se evaluaron.
![\[Evaluaciones\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/evals_overview.png)
**Topics**
+ [Detalles de las evaluaciones](#session-traces-evaluations-details)
+ [Gráficos de evaluaciones](#session-traces-evaluations-graphs)
+ [Uso de los resultados de evaluaciones](#session-traces-evaluations-raw-results)
## Detalles de las evaluaciones
Para cada evaluación, el panel incluye las siguientes secciones:
------
#### [ Evaluation configuration metrics ]
Proporciona métricas para la configuración de evaluación general. Un evaluador define cómo evaluar un aspecto específico del rendimiento de un agente de IA. Para ver más detalles sobre un evaluador, elija su nombre en la columna **Evaluador**. Para ver un gráfico de barras y analizar las tendencias de un evaluados, elija el valor en la columna **Recuento**.
![\[Métricas de configuración de evaluación\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/evals_01.png)
------
#### [ Session evaluations ]
Proporciona los resultados de la evaluación a los evaluadores por sesión. Una sesión representa una agrupación lógica de interacciones relacionadas de un solo usuario o flujo de trabajo. Una sesión puede contener uno o más rastros. Puede elegir una sesión para filtrarla hasta ver la lista de rastros de esa sesión en la sección **Evaluaciones de rastros**.
![\[Evaluaciones de sesiones\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/evals_02.png)
------
#### [ Trace evaluations ]
Proporciona los resultados de la evaluación a los evaluadores por rastro. Un rastro es un registro completo de la ejecución o solicitud de un solo agente. Un rastro puede contener uno o más intervalos. Elija una rastro para ver los detalles del rastro junto con todos los evaluadores que se ejecutaron en ese rastro.
![\[Evaluaciones de rastros\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/evals_03.png)
------
#### [ Span evaluations ]
Proporciona los resultados de la evaluación a los evaluadores por intervalo. Un intervalo representa las operaciones individuales llevadas a cabo durante esa ejecución. Elija un intervalo para ver sus detalles junto con todas las operaciones llevadas a cabo durante ese intervalo.
![\[Evaluaciones de intervalos\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/evals_04.png)
------
## Gráficos de evaluaciones
El panel Evaluaciones también incluye un gráfico de barras para cada evaluador. Los gráficos muestran las tendencias de cada evaluador a lo largo del tiempo y permiten configurar alarmas para valores métricos específicos. Para configurar una alarma, haga clic en una barra del gráfico y, a continuación, elija el icono de **alarma** (campana). Para obtener más información, consulte [Uso de las alarmas de Amazon CloudWatch](CloudWatch_Alarms.md).
![\[Gráficos de evaluaciones\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/evals_graphs.png)
## Uso de los resultados de evaluaciones
Si necesita acceso directo a los datos de los resultados de evaluaciones, o si desea crear visualizaciones personalizadas o trabajar fuera de la consola de Evaluaciones de AgentCore, puede acceder a los resultados de evaluaciones directamente a través de los paneles de Registros de CloudWatch, Métricas de CloudWatch y CloudWatch.
**Topics**
+ [Acceso a los resultados de evaluaciones en Resultados de CloudWatch](#accessing-evaluation-results-logs)
+ [Acceso a las métricas de evaluaciones en Métricas de CloudWatch](#accessing-evaluation-metrics)
+ [Creación de paneles personalizados](#creating-custom-dashboards)
+ [Configuración de alarmas en métricas de evaluaciones](#setting-alarms-evaluation-metrics)
+ [Recursos adicionales](#additional-resources)
### Acceso a los resultados de evaluaciones en Resultados de CloudWatch
Los resultados de evaluaciones se publican automáticamente en Registros de CloudWatch en formato de métricas integradas (EMF).
**Buscar el grupo de registro de resultados de evaluaciones**
1. Abra la consola de CloudWatch.
1. En el panel de navegación, elija **Administración de registros** > **Grupos de registro**.
1. Busque los grupos de registro con el prefijo `/aws/bedrock-agentcore/evaluations/` o navegue por ellos.
1. Dentro de este grupo de registro, los eventos de registro contienen los resultados de evaluaciones.
Para obtener más información sobre cómo trabajar con grupos de registros y consultar datos de registro, consulte [Uso de grupos de registro y flujos de registro](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) y [Análisis de datos de registros con Información de registros de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html).
### Acceso a las métricas de evaluaciones en Métricas de CloudWatch
Las métricas de los resultados de evaluaciones se extraen automáticamente de los registros en formato de métricas integradas (EMF) y se publican en Métricas de CloudWatch.
**Buscar métricas de evaluaciones**
1. Abra la consola de CloudWatch.
1. En el panel de navegación, elija **Métricas** > **Todas las métricas**.
1. Seleccione el espacio de nombres **Bedrock AgentCore/Evaluations**.
1. Explore las métricas disponibles por dimensiones.
Para obtener más información sobre cómo ver las métricas y trabajar con ellas, consulte [Uso de métricas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) y [Representación gráfica de las métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html).
### Creación de paneles personalizados
Puede crear paneles personalizados para visualizar las métricas de evaluaciones junto con otras métricas operativas.
**Creación de un panel con métricas de evaluaciones**
1. En la consola de CloudWatch, elija **Paneles** en el panel de navegación.
1. Elija **Crear panel**.
1. Agregue widgets y seleccione métricas del espacio de nombres **Bedrock AgentCore/Evaluations**
1. Personalice el intervalo de tiempo, la estadística y el tipo de visualización según sus necesidades.
Para obtener instrucciones detalladas, consulte [Creación de un panel de CloudWatch personalizado](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html) y [Uso de paneles de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
### Configuración de alarmas en métricas de evaluaciones
Puede configurar alarmas para recibir notificaciones cuando las métricas de evaluaciones superen los umbrales que haya especificado; por ejemplo, cuando la corrección sea inferior a los niveles aceptables.
**Creación de una alarma en métricas de evaluaciones**
1. En la consola de CloudWatch, elija **Alarmas** > **Todas las alarmas**.
1. Elija **Crear alarma**.
1. Elija **Seleccionar métrica** y navegue hasta el espacio de nombres **Bedrock AgentCore/Evaluations**.
1. Seleccione la métrica que quiere supervisar.
1. Configure las condiciones del umbral (el umbral de detección dinámica de anomalías está disponible cuando no es necesario especificar ningún umbral numérico estático) y las acciones de notificación.
Para obtener instrucciones detalladas, consulte [Uso de alarmas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) y [Cree una alarma de CloudWatch basada en un umbral estático](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html).
### Recursos adicionales
+ [Formato de métricas integradas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Monitoring-CloudWatch-Metrics.html)
+ [Sintaxis de consulta Información de registros de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html)
+ [Creación de alarmas compuestas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Composite_Alarm.html)