View a markdown version of this page

Crea una valutazione online - Amazon Bedrock AgentCore

Crea una valutazione online

L'CreateOnlineEvaluationConfigAPI crea una nuova configurazione di valutazione online che monitora continuamente le prestazioni dell'agente utilizzando il traffico in tempo reale. Questa operazione asincrona configura il servizio per valutare le tracce degli agenti man mano che vengono generate durante il normale funzionamento.

Quando si crea una valutazione online, si specifica un nome di configurazione univoco, l'origine dati da monitorare (un elenco di gruppi di CloudWatch log o un endpoint dell'agente) e un elenco di valutatori da applicare (fino a 10, combinando valutatori integrati e personalizzati). Fornisci anche un ARN del ruolo di servizio IAM per l'esecuzione. Il enableOnCreate parametro è obbligatorio e determina se la valutazione inizia a essere eseguita immediatamente dopo la creazione (executionStatus= true) o rimane disabilitata fino a quando non viene abilitata esplicitamente (executionStatus= false).

Controllo dello stato di esecuzione

Il executionStatus parametro determina se il processo di valutazione elabora attivamente le tracce:

  • ABILITATO: il processo di valutazione viene eseguito continuamente, elaborando le tracce in ingresso e generando risultati di valutazione.

  • DISABILITATO: la configurazione di valutazione esiste ma il processo è in pausa. Nessuna traccia viene elaborata o valutata.

Puoi controllare lo stato di esecuzione utilizzando 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"

Protezione del valutatore

Quando crei una configurazione di valutazione con executionStatus set toENABLED, il sistema blocca automaticamente tutti i valutatori personalizzati che hai selezionato. Una volta bloccato:

  • Nessuna modifica consentita: non è possibile aggiornare la configurazione, i prompt o le impostazioni del valutatore. Clona un nuovo strumento di valutazione se devi apportare modifiche.

  • Nessuna eliminazione consentita: non è possibile eliminare il valutatore mentre un processo di valutazione lo sta utilizzando (in esecuzione).

Esempi di codice per AgentCore CLI, AgentCore SDK e AWS SDK

I seguenti esempi di codice mostrano come creare configurazioni di valutazione online utilizzando diversi approcci di sviluppo. Scegliete il metodo più adatto al vostro ambiente di sviluppo e alle vostre preferenze.

Esempio
AgentCore CLI
  1. # Create online evaluation configuration agentcore add online-eval \ --name "your_config_name" \ --runtime "your_runtime_name" \ --evaluator "Builtin.GoalSuccessRate" "Builtin.Helpfulness" \ --sampling-rate 1.0 \ --enable-on-create

    Questo comando aggiunge la configurazione di valutazione online al tuo localeagentcore.json. Esegui agentcore deploy per crearlo nel tuo AWS account.

    Nota

    Eseguilo dall'interno di una directory di AgentCore progetto (creata conagentcore create).

Interactive
  1. Inserisci un nome per la configurazione di valutazione online.

    Inserimento del nome della configurazione di valutazione online
  2. Seleziona i valutatori da includere. Puoi scegliere tra valutatori integrati e qualsiasi valutatore personalizzato che hai creato.

    Elenco a selezione multipla di Evaluator
  3. Imposta la frequenza di campionamento, ovvero la percentuale di richieste degli agenti che verranno valutate.

    Frequenza di campionamento in ingresso
  4. Scegli se abilitare la valutazione automaticamente dopo l'implementazione.

    Abilita la selezione al momento della distribuzione
  5. Rivedi la configurazione e premi Invio per confermare.

    Rivedi la configurazione di valutazione online
AgentCore SDK
  1. from bedrock_agentcore_starter_toolkit import Evaluation # Initialize the evaluation client eval_client = Evaluation() # Replace these with your actual values config_name = "YOUR_CONFIG_NAME" agent_id = "YOUR_AGENT_ID" # e.g., agent_myagent-ABC123xyz # Create online evaluation configuration config = eval_client.create_online_config( config_name=config_name, # Must use underscores, not hyphens agent_id=agent_id, # Agent ID (e.g., agent_myagent-ABC123xyz) sampling_rate=1.0, # Percentage to evaluate (0-100). 1.0 = evaluate 1% of interactions evaluator_list=["Builtin.GoalSuccessRate", "Builtin.Helpfulness"], # List of evaluator IDs config_description="Online Evaluation Config", # Optional description auto_create_execution_role=True, # Automatically creates IAM role (default: True) enable_on_create=True # Enable immediately after creation (default: True) ) print("✅ Online evaluation configuration created!") print(f"Config ID: {config['onlineEvaluationConfigId']}") print(f"Status: {config['status']}") # Save the config ID for later operations config_id = config['onlineEvaluationConfigId'] print(f"\nSaved config_id: {config_id}")
AWS SDK
  1. import boto3 # Your input log group that contains agent traces LOG_GROUP_NAME = "/aws/agentcore/test-agent-traces" # The service.name attribute from Otel SERVICE_NAME = "strands_healthcare_single_agent.DEFAULT" # The role created earlier with the required permissions for eval role_arn = f"arn:aws:iam::{ACCOUNT_ID}:role/AgentCoreEvaluationRole" client = boto3.client('bedrock-agentcore-control') create_config_response = client.create_online_evaluation_config( onlineEvaluationConfigName="strands_healthcare_agent_1", description="Continuous evaluation of a healthcare agent", rule={ "samplingConfig": {"samplingPercentage": 80.0} }, dataSourceConfig={ "cloudWatchLogs": { "logGroupNames": [LOG_GROUP_NAME], "serviceNames": [SERVICE_NAME] } }, evaluators=[{"evaluatorId":"Builtin.Helpfulness"}], evaluationExecutionRoleArn=role_arn, enableOnCreate=True )
AWS CLI
  1. aws bedrock-agentcore-control create-online-evaluation-config \ --online-evaluation-config-name "strands_healthcare_agent_1" \ --description "Continuous evaluation of a healthcare agent" \ --rule '{"samplingConfig": {"samplingPercentage": 80.0}}' \ --data-source-config '{"cloudWatchLogs": {"logGroupNames": ["/aws/agentcore/test-agent-traces"], "serviceNames": ["strands_healthcare_single_agent.DEFAULT"]}}' \ --evaluators '[{"evaluatorId": "Builtin.Helpfulness"}]' \ --evaluation-execution-role-arn "arn:aws:iam::{YOUR_ACCOUNT_ID}:role/AgentCoreEvaluationRole" \ --enable-on-create

Console

Puoi creare configurazioni di valutazione online utilizzando l'interfaccia visiva della AgentCore console Amazon Bedrock. Questo metodo fornisce moduli guidati e procedure di convalida per aiutarti a configurare le impostazioni di valutazione.

Per creare una valutazione AgentCore online

  1. Apri la AgentCore console Amazon Bedrock.

  2. Nel riquadro di navigazione a sinistra, scegli Valutazione.

  3. Scegli Crea configurazione di valutazione.

    1. (Facoltativo) Per il nome della valutazione, inserite un nome per la configurazione di valutazione online.

    2. (Facoltativo) Per abilitare la configurazione di valutazione dopo la sua creazione, selezionate la casella di controllo sotto il nome della valutazione.

    3. (Facoltativo) Per la descrizione della configurazione di valutazione, inserite una descrizione per la configurazione di AgentCore valutazione.

    4. (Facoltativo) Per il timeout di inattività della sessione, inserite una durata compresa tra 1 e 60 minuti. Il valore predefinito è 15 minuti.

  4. Per Origine dati, scegli una delle seguenti opzioni:

    1. Definisci con un endpoint agente: scegli un agente creato in precedenza su AgentCore Runtime o crea un nuovo agente scegliendo Agenti. Quindi, scegli un endpoint dall'agente.

    2. Seleziona un gruppo di CloudWatch log: seleziona fino a 5 gruppi di log. Inserisci il nome del servizio utilizzato dal tuo agente per garantire l'osservabilità. <agent-runtime-name>Per gli agenti ospitati su AgentCore Runtime, il nome del servizio segue il formato. <agent-runtime-endpoint-name>. Per gli agenti che funzionano all'esterno AgentCore di Runtime, il nome del servizio è configurato nella variabile di ambiente OTEL_RESOURCE_ATTRIBUTES.

  5. Per gli valutatori, seleziona fino a 10 valutatori per configurazione di valutazione, inclusi i valutatori integrati e personalizzati.

  6. (Facoltativo) Per i filtri, aggiungi fino a 5 filtri per identificare le sessioni da valutare.

  7. (Facoltativo) Per il campionamento, scegliete una percentuale compresa tra lo 0,01% e il 100% per controllare la percentuale di sessioni da valutare. L'impostazione predefinita è 10%.

  8. Per il ruolo IAM di Amazon Bedrock, scegli una delle seguenti opzioni:

    1. Usa un ruolo esistente: seleziona un ruolo di servizio IAM che disponga già delle autorizzazioni richieste.

    2. Crea un nuovo ruolo: crea un nuovo ruolo di servizio IAM.

  9. Scegli Crea configurazione di valutazione per creare la configurazione di valutazione AgentCore online.