View a markdown version of this page

Actualizar la evaluación en línea - Amazon Bedrock AgentCore
Control de ejecuciónEjemplos de código para AgentCore CLI, AgentCore SDK y AWS SDKConsola

Actualizar la evaluación en línea

La UpdateOnlineEvaluationConfig API modifica una configuración de evaluación en línea existente, lo que le permite cambiar los evaluadores, las fuentes de datos, los ajustes de ejecución y otros parámetros. Esta operación gestiona las actualizaciones de forma inteligente sin interrumpir la ejecución de las evaluaciones.

Las actualizaciones solo se pueden realizar cuando la configuración de la evaluación está en ACTIVEUPDATE_FAILED, o ERROR en ese estado. Si la configuración se está creando, actualizando o eliminando actualmente, recibirá un error de conflicto y deberá volver a intentarlo una vez finalizada la operación.

Control de ejecución

El parámetro de estado de ejecución controla si la configuración de evaluación en línea procesa activamente los seguimientos de los agentes. Comprender estos estados le ayuda a gestionar los costes y el rendimiento de la evaluación.

  • Habilitar la evaluación: al cambiar de DISABLED a ENABLED, el sistema proporciona el servicio para comenzar a procesar los rastreos de las fuentes de datos especificadas.

  • Desactivación de la evaluación: al cambiar de ENABLED a DISABLED, el sistema deja de procesar nuevos rastreos y, al mismo tiempo, conserva la configuración para usarla en el futuro.

Ejemplos de código para AgentCore CLI, AgentCore SDK y AWS SDK

Los siguientes ejemplos de código muestran cómo actualizar las configuraciones de 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 CLI

  1. Para actualizar una configuración de evaluación en línea con la AgentCore CLI, edite directamente la configuración en su agentcore.json archivo y, a continuación, vuelva a implementar:

    agentcore deploy

    Abraagentcore.json, busque la configuración en la onlineEvalConfigs matriz, modifique sus ajustes y, a continuación, ejecútela. agentcore deploy Los cambios no surtirán efecto hasta que se desplieguen.

    # Pause a running online evaluation
agentcore pause online-eval "your_config_name"

# Resume a paused online evaluation
agentcore resume online-eval "your_config_name"
    nota

    La configuración debe estar en ACTIVE el estado de ciclo de ERROR vida o ciclo de vida antes de poder actualizarla. UPDATE_FAILED

    nota

    Para controlar si el trabajo de evaluación se está ejecutando (ENABLED/DISABLED), utilice agentcore pause online-eval yagentcore resume online-eval.

    nota

    Ejecútelo desde el interior de un directorio de AgentCore proyecto (creado conagentcore create).

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}")

# update description
eval_client.update_online_config(
    config_id=config_id,
    description="Updated description for online evaluation"
)
print("✅ Description updated")
AWS SDK

  1. import boto3

client = boto3.client('bedrock-agentcore-control')

update_config_response = client.update_online_evaluation_config(
    onlineEvaluationConfigId='your_config_id',
    description="Updated description for online evaluation"
)
AWS CLI

  1. aws bedrock-agentcore-control update-online-evaluation-config \
    --online-evaluation-config-id your_config_id \
    --description "Updated description for online evaluation"

Consola

Modifique los ajustes de configuración de la evaluación en línea mediante la interfaz de edición de la consola, que proporciona opciones de validación de formularios y configuración guiada.

Para actualizar una configuración de 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. Elija uno de los siguientes métodos para actualizar la configuración:

    • Elija el nombre de la configuración de evaluación para ver sus detalles y, a continuación, elija Editar en la esquina superior derecha de la página de detalles.

    • Seleccione la configuración de evaluación para que aparezca resaltada y, a continuación, elija Editar en la parte superior de la tarjeta de configuraciones de evaluación.

  5. Actualice los campos según sea necesario.

  6. Seleccione Actualizar la configuración de evaluación para guardar los cambios.