View a markdown version of this page

Crea una valutazione online - Fondamento Amazon AgentCore

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea una valutazione online

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

Per creare una valutazione online, fornisci un nome di configurazione univoco, scegli cosa monitorare, seleziona fino a 10 valutatori e fornisci un ARN del ruolo del servizio IAM per l'esecuzione. L'origine dati può essere CloudWatch Logs, selezionata in base ai nomi esatti dei gruppi di log o ai prefissi dei nomi dei gruppi di log, oppure un endpoint dell'agente. Il enableOnCreate parametro richiesto controlla l'inizialeexecutionStatus: true avvia la configurazione in e ENABLED la false avvia in. DISABLED

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, elabora le tracce in entrata e genera risultati di valutazione.

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

È possibile 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"

Seleziona i gruppi di log di input

Se la tua origine dati è CloudWatch Logs, configura esattamente dataSourceConfig.cloudWatchLogs in uno dei seguenti modi:

  • logGroupNames— Fornisci un elenco esplicito dei nomi dei gruppi di log.

  • logGroupNamePrefixes— Fornire da 1 a 5 prefissi per i nomi dei gruppi di log. Il servizio valuta le tracce di qualsiasi gruppo di log il cui nome inizia con uno di questi prefissi, inclusi i gruppi di log corrispondenti creati successivamente.

In entrambi i casi, impostalo serviceNames in modo che il servizio possa identificare le tracce dell'agente nei gruppi di log selezionati.

Se usi logGroupNamePrefixes per abbinare i gruppi di log AgentCore di Amazon Bedrock Runtime, assicurati che il runtime invii gli intervalli al gruppo di log dell'agente. Per gli agenti che utilizzano ancora il gruppo di aws/spans log condiviso, impostato UNIFIED_TRACES_DESTINATION_ENABLED=true sul runtime. Per ulteriori informazioni, consulta Span destination for agent hosted in Amazon Bedrock runtime AgentCore .

# Match input log groups by prefix instead of exact names dataSourceConfig={ "cloudWatchLogs": { "logGroupNamePrefixes": ["/aws/agentcore/my-agent-"], "serviceNames": ["my_agent.DEFAULT"] } }

Per ulteriori informazioni su dove vengono scritti i risultati e le metriche dei punteggi, inclusi i gruppi di log dedicati, personalizzati e di origine, consulta Risultati e output.

Protezione del valutatore

Quando si crea una configurazione di valutazione con executionStatus set toENABLED, il sistema blocca automaticamente tutti i valutatori personalizzati selezionati. Una volta bloccato:

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

  • Eliminazione non consentita: non è possibile eliminare il valutatore mentre un processo di valutazione lo utilizza (in esecuzione).

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

I seguenti esempi di codice dimostrano 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 a quella localeagentcore.json. Corri agentcore deploy a crearla nel tuo AWS account.

    Nota

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

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

    Inserimento del nome della configurazione di valutazione online
  2. Seleziona i valutatori da includere. Puoi scegliere tra i valutatori integrati e gli eventuali valutatori personalizzati che hai creato.

    Elenco a selezione multipla del valutatore
  3. Imposta la frequenza di campionamento: 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 in fase di distribuzione
  5. Rivedi la configurazione e premi Invio per confermare.

    Rivedi la configurazione della 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 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 Nome della valutazione, inserisci un nome per la configurazione di valutazione online.

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

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

    4. (Facoltativo) Per il timeout di inattività della sessione, inserisci 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 che hai 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 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 in esecuzione all'esterno AgentCore di Runtime, il nome del servizio è configurato nella variabile di ambiente OTEL_RESOURCE_ATTRIBUTES.

  5. Per i 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, scegli una percentuale compresa tra lo 0,01% e il 100% per controllare la percentuale di sessioni valutate. L'impostazione predefinita è il 10%.

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

    Nota

    Se il role manager è abilitato nel tuo account, AgentCore assegna il ruolo per te e la fase di selezione del ruolo qui descritta viene sostituita da un'opzione Personalizza. Per utilizzare un ruolo diverso, scegli Personalizza. Per ulteriori informazioni, consulta Creazione di ruoli IAM nella Guida per l’utente IAM.

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

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

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