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
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, 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
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
-
Apri la AgentCore console Amazon Bedrock.
-
Nel riquadro di navigazione a sinistra, scegli Valutazione.
-
Scegli Crea configurazione di valutazione.
-
(Facoltativo) Per Nome della valutazione, inserisci un nome per la configurazione di valutazione online.
-
(Facoltativo) Per abilitare la configurazione di valutazione dopo la sua creazione, seleziona la casella di controllo sotto il nome della valutazione.
-
(Facoltativo) Per la descrizione della configurazione di valutazione, immettere una descrizione per la configurazione di AgentCore valutazione.
-
(Facoltativo) Per il timeout di inattività della sessione, inserisci 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 che hai 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 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.
-
-
Per i 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, scegli una percentuale compresa tra lo 0,01% e il 100% per controllare la percentuale di sessioni valutate. L'impostazione predefinita è il 10%.
-
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.
-
Usa un ruolo esistente: seleziona un ruolo del servizio IAM che dispone già delle autorizzazioni richieste.
-
Crea un nuovo ruolo: crea un nuovo ruolo del servizio IAM.
-
-
Scegli Crea configurazione di valutazione per creare la configurazione di valutazione AgentCore online.