View a markdown version of this page

Obtenga una evaluación en línea - Amazon Bedrock AgentCore

Obtenga una evaluación en línea

La GetOnlineEvaluationConfig API recupera los detalles completos y el estado actual de una configuración de evaluación en línea existente. Esta operación sincrónica devuelve la configuración completa, incluidas las fuentes de datos, los evaluadores, el estado de ejecución y los metadatos operativos.

Utilice esta API para supervisar el estado del ciclo de vida de la configuración (ACTIVE,,CREATING,CREATE_FAILED, oERROR) UPDATING UPDATE_FAILEDDELETING, comprobar el estado de ejecución actual (ENABLEDoDISABLED) y recuperar todos los parámetros de la configuración, incluidas las listas de evaluadores, los ajustes de las fuentes de datos y los destinos de salida.

Estados del ciclo de vida

El status campo de una configuración de evaluación en línea informa sobre el estado de su ciclo de vida, que es independiente del executionStatus campo que controla si el trabajo de evaluación procesa los seguimientos de forma activa.

  • ACTIVE— La configuración está completamente aprovisionada y lista para usarse.

  • CREATING— Se está aprovisionando la configuración. Espere a que se realice la transición ACTIVE antes de actualizarla o eliminarla.

  • CREATE_FAILED— La creación no se completó correctamente. No puede actualizar una configuración en este estado; llame DeleteOnlineEvaluationConfig para eliminarla y, a continuación, cree una nueva.

  • UPDATING— Hay una actualización en curso. Espere a que se complete la operación antes de realizar cambios adicionales.

  • UPDATE_FAILED— La actualización más reciente no se aplicó. Puede volver a intentarlo llamando de UpdateOnlineEvaluationConfig nuevo o eliminando la configuración conDeleteOnlineEvaluationConfig.

  • DELETING— Se está eliminando la configuración.

  • ERROR— Se ha producido un problema que requiere su acción. Marque el failureReason campo para identificar el problema. Entre las causas más comunes se incluyen el acceso insuficiente a los roles de IAM, la falta de permisos para los grupos de registro y la superación de las cuotas de servicio. Tras solucionar el problema, llama UpdateOnlineEvaluationConfig para volver a intentarlo o DeleteOnlineEvaluationConfig eliminar la configuración.

Ejemplos de código para el AgentCore SDK y AWS SDK

Los siguientes ejemplos de código muestran cómo obtener los detalles de la configuración de la evaluación en línea mediante diferentes enfoques de desarrollo. Elija el método que mejor se adapte a su entorno de desarrollo y a sus preferencias.

ejemplo
AgentCore SDK
  1. from bedrock_agentcore_starter_toolkit import Evaluation # Initialize the evaluation client eval_client = Evaluation() config_id = "config-abc123" print(f"\nUsing config_id: {config_id}") config_details = eval_client.get_online_config(config_id) # Display configuration details print(f"Config Name: {config_details['onlineEvaluationConfigName']}") print(f"Config ID: {config_details['onlineEvaluationConfigId']}") print(f"Status: {config_details['status']}")
AWS SDK
  1. import boto3 client = boto3.client('bedrock-agentcore-control') response = client.get_online_evaluation_config( onlineEvaluationConfigId='your_config_id' )
AWS CLI
  1. aws bedrock-agentcore-control get-online-evaluation-config \ --online-evaluation-config-id your_config_id

Consola

Puede ver información detallada sobre una configuración de evaluación en línea específica a través de la interfaz de la consola.

Para obtener los detalles de la configuración de la evaluación en línea

  1. Abre la AgentCore consola Amazon Bedrock.

  2. En el panel de navegación, elija Evaluación.

  3. En la tarjeta de configuraciones de evaluación, consulte la tabla que muestra las configuraciones de evaluación que ha creado.

  4. Para ver la información de una configuración de evaluación específica, elija el nombre de la configuración para ver sus detalles.