Crear una evaluación en línea
La CreateOnlineEvaluationConfig API crea una nueva configuración de evaluación en línea que monitorea continuamente el desempeño de su agente mediante el tráfico en vivo. Esta operación asíncrona configura el servicio para evaluar las trazas de los agentes a medida que se generan durante el funcionamiento normal.
Al crear una evaluación en línea, se especifica un nombre de configuración único, la fuente de datos que se va a supervisar (ya sea una lista de grupos de CloudWatch registros o un punto final de agente) y una lista de evaluadores que se van a aplicar (hasta 10, combinando evaluadores integrados y personalizados). También proporciona un ARN de rol de servicio de IAM para su ejecución. El enableOnCreate parámetro es obligatorio y determina si la evaluación comienza a ejecutarse inmediatamente después de su creación (executionStatus= true) o permanece deshabilitada hasta que se habilite explícitamente (executionStatus= false).
Temas
Control del estado de ejecución
El executionStatus parámetro determina si el trabajo de evaluación procesa activamente las trazas:
-
ACTIVADO: el trabajo de evaluación se ejecuta de forma continua, procesa las trazas entrantes y genera los resultados de la evaluación.
-
DESACTIVADO: la configuración de evaluación existe, pero el trabajo está en pausa. No se procesa ni evalúa ningún rastro.
Puede controlar el estado de ejecución mediante la CLI:
# Pause a running online evaluation agentcore pause online-eval "your_config_name" # Resume a paused online evaluation agentcore resume online-eval "your_config_name"
Protección del evaluador
Al crear una configuración de evaluación con el valor executionStatus establecido enENABLED, el sistema bloquea automáticamente los evaluadores personalizados que haya seleccionado. Una vez bloqueado:
-
No se permiten modificaciones: no puede actualizar la configuración, las solicitudes ni los ajustes del evaluador. Clone un evaluador nuevo si necesita realizar cambios.
-
No se permite la eliminación: no se puede eliminar el evaluador mientras algún trabajo de evaluación lo esté utilizando (en ejecución).
Ejemplos de código para AgentCore CLI, AgentCore SDK y AWS SDK
Los siguientes ejemplos de código muestran cómo crear configuraciones de evaluación en línea utilizando diferentes enfoques de desarrollo. Elija el método que mejor se adapte a su entorno de desarrollo y a sus preferencias.
ejemplo
Consola
Puede crear configuraciones de evaluación en línea mediante la interfaz visual de la AgentCore consola Amazon Bedrock. Este método proporciona formularios guiados y validaciones para ayudarle a configurar los ajustes de la evaluación.
Para crear una evaluación AgentCore en línea
-
Abre la AgentCore consola Amazon Bedrock.
-
En el panel de navegación izquierdo, elija Evaluación.
-
Elija Crear configuración de evaluación.
-
(Opcional) En Nombre de la evaluación, introduzca un nombre para la configuración de evaluación en línea.
-
(Opcional) Para habilitar la configuración de evaluación una vez creada, seleccione la casilla de verificación situada debajo del nombre de la evaluación.
-
(Opcional) En la descripción de la configuración de evaluación, introduzca una descripción para la configuración AgentCore de evaluación.
-
(Opcional) Para el tiempo de espera de la sesión inactiva, introduzca una duración entre 1 y 60 minutos. El valor predeterminado es 15 minutos.
-
-
En Fuente de datos, elija una de las siguientes opciones:
-
Defina con un terminal de agente: elija un agente que haya creado anteriormente en AgentCore Runtime o cree un agente nuevo seleccionando Agentes. A continuación, elija un punto final del agente.
-
Seleccione un grupo de CloudWatch registros: seleccione hasta 5 grupos de registros. Introduzca el nombre del servicio que utiliza su agente para la observabilidad. <agent-runtime-name>En el caso de los agentes alojados en AgentCore Runtime, el nombre del servicio sigue el formato. <agent-runtime-endpoint-name>. Para los agentes que se ejecutan fuera AgentCore de Runtime, el nombre del servicio se configura en la variable de entorno OTEL_RESOURCE_ATTRIBUTES.
-
-
Para los evaluadores, seleccione hasta 10 evaluadores por configuración de evaluación, incluidos los evaluadores integrados y personalizados.
-
(Opcional) En el caso de los filtros, añada hasta 5 filtros para identificar qué sesiones evaluar.
-
(Opcional) Para el muestreo, elija un porcentaje entre el 0,01% y el 100% para controlar el porcentaje de sesiones que se evalúan. El valor predeterminado es el 10%.
-
Para el rol de IAM de Amazon Bedrock, elija una de las siguientes opciones:
-
Utilice un rol existente: seleccione un rol de servicio de IAM que ya tenga los permisos necesarios.
-
Crear un nuevo rol: cree un nuevo rol de servicio de IAM.
-
-
Elija Crear configuración de evaluación para crear la configuración de evaluación AgentCore en línea.