Créez une évaluation en ligne
L'CreateOnlineEvaluationConfigAPI crée une nouvelle configuration d'évaluation en ligne qui surveille en permanence les performances de votre agent à l'aide du trafic en temps réel. Cette opération asynchrone permet au service d'évaluer les traces des agents au fur et à mesure qu'elles sont générées pendant le fonctionnement normal.
Lorsque vous créez une évaluation en ligne, vous spécifiez un nom de configuration unique, la source de données à surveiller (soit une liste de groupes de CloudWatch journaux, soit un point de terminaison d'agent) et une liste d'évaluateurs à appliquer (jusqu'à 10, combinant des évaluateurs intégrés et personnalisés). Vous fournissez également un ARN de rôle de service IAM pour l'exécution. Le enableOnCreate paramètre est obligatoire et détermine si l'évaluation démarre immédiatement après sa création (executionStatus= true) ou reste désactivée jusqu'à ce qu'elle soit explicitement activée (executionStatus= false).
Rubriques
Contrôle du statut d'exécution
Le executionStatus paramètre détermine si la tâche d'évaluation traite activement les traces :
-
ACTIVÉ — La tâche d'évaluation s'exécute en continu, traite les traces entrantes et génère des résultats d'évaluation.
-
DÉSACTIVÉ — La configuration d'évaluation existe mais la tâche est suspendue. Aucune trace n'est traitée ou évaluée.
Vous pouvez contrôler l'état d'exécution à l'aide de 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"
Protection de l'évaluateur
Lorsque vous créez une configuration d'évaluation avec executionStatus set toENABLED, le système verrouille automatiquement tous les évaluateurs personnalisés que vous avez sélectionnés. Une fois verrouillé :
-
Aucune modification autorisée : vous ne pouvez pas mettre à jour la configuration, les instructions ou les paramètres de l'évaluateur. Clonez un nouvel évaluateur si vous devez apporter des modifications.
-
Aucune suppression autorisée : vous ne pouvez pas supprimer l'évaluateur tant qu'une tâche d'évaluation l'utilise (en cours d'exécution).
Exemples de code pour la AgentCore CLI, le AgentCore SDK et AWS Kit SDK
Les exemples de code suivants montrent comment créer des configurations d'évaluation en ligne à l'aide de différentes approches de développement. Choisissez la méthode qui correspond le mieux à votre environnement de développement et à vos préférences.
Exemple
Console
Vous pouvez créer des configurations d'évaluation en ligne à l'aide de l'interface visuelle de AgentCore la console Amazon Bedrock. Cette méthode fournit des formulaires guidés et une validation pour vous aider à configurer vos paramètres d'évaluation.
Pour créer une évaluation AgentCore en ligne
-
Ouvrez la AgentCore console Amazon Bedrock.
-
Dans le volet de navigation de gauche, choisissez Evaluation.
-
Choisissez Créer une configuration d'évaluation.
-
(Facultatif) Dans Nom de l'évaluation, entrez le nom de la configuration d'évaluation en ligne.
-
(Facultatif) Pour activer la configuration d'évaluation après sa création, cochez la case sous le nom de l'évaluation.
-
(Facultatif) Pour la description de la configuration d'évaluation, entrez une description de la configuration AgentCore d'évaluation.
-
(Facultatif) Pour le délai d'inactivité de la session, entrez une durée comprise entre 1 et 60 minutes. La valeur par défaut est de 15 minutes.
-
-
Pour Source de données, choisissez l'une des options suivantes :
-
Définissez avec un point de terminaison d'agent : choisissez un agent que vous avez créé précédemment dans AgentCore Runtime, ou créez un nouvel agent en choisissant Agents. Choisissez ensuite un point de terminaison dans l'agent.
-
Sélectionnez un groupe de CloudWatch journaux : sélectionnez jusqu'à 5 groupes de journaux. Entrez le nom du service utilisé par votre agent à des fins d'observabilité. Pour les agents hébergés sur AgentCore Runtime, le nom du service suit le format<agent-runtime-name>. <agent-runtime-endpoint-name>. Pour les agents exécutés en dehors de AgentCore Runtime, le nom du service est configuré dans la variable d'environnement OTEL_RESOURCE_ATTRIBUTES.
-
-
Pour les évaluateurs, sélectionnez jusqu'à 10 évaluateurs par configuration d'évaluation, y compris les évaluateurs intégrés et personnalisés.
-
(Facultatif) Pour les filtres, ajoutez jusqu'à 5 filtres pour identifier les sessions à évaluer.
-
(Facultatif) Pour l'échantillonnage, choisissez un pourcentage compris entre 0,01 % et 100 % pour contrôler le pourcentage de sessions évaluées. La valeur par défaut est de 10 %.
-
Pour le rôle Amazon Bedrock IAM, choisissez l'une des options suivantes :
-
Utiliser un rôle existant : sélectionnez un rôle de service IAM qui possède déjà les autorisations requises.
-
Créer un nouveau rôle : créez un nouveau rôle de service IAM.
-
-
Choisissez Créer une configuration d'évaluation pour créer la configuration d'évaluation AgentCore en ligne.