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).
Argomenti
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
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
-
Apri la AgentCore console Amazon Bedrock.
-
Nel riquadro di navigazione a sinistra, scegli Valutazione.
-
Scegli Crea configurazione di valutazione.
-
(Facoltativo) Per il nome della valutazione, inserite un nome per la configurazione di valutazione online.
-
(Facoltativo) Per abilitare la configurazione di valutazione dopo la sua creazione, selezionate la casella di controllo sotto il nome della valutazione.
-
(Facoltativo) Per la descrizione della configurazione di valutazione, inserite una descrizione per la configurazione di AgentCore valutazione.
-
(Facoltativo) Per il timeout di inattività della sessione, inserite una durata compresa tra 1 e 60 minuti. Il valore predefinito è 15 minuti.
-
-
Per Origine dati, scegli una delle seguenti opzioni:
-
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.
-
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.
-
-
Per gli valutatori, seleziona fino a 10 valutatori per configurazione di valutazione, inclusi i valutatori integrati e personalizzati.
-
(Facoltativo) Per i filtri, aggiungi fino a 5 filtri per identificare le sessioni da valutare.
-
(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%.
-
Per il ruolo IAM di Amazon Bedrock, scegli una delle seguenti opzioni:
-
Usa un ruolo esistente: seleziona un ruolo di servizio IAM che disponga già delle autorizzazioni richieste.
-
Crea un nuovo ruolo: crea un nuovo ruolo di servizio IAM.
-
-
Scegli Crea configurazione di valutazione per creare la configurazione di valutazione AgentCore online.