View a markdown version of this page

Mettre à jour l'évaluation en ligne - Amazon Bedrock AgentCore
Contrôle d'exécutionExemples de code pour la AgentCore CLI, le AgentCore SDK et AWS Kit SDKConsole

Mettre à jour l'évaluation en ligne

L'UpdateOnlineEvaluationConfigAPI modifie une configuration d'évaluation en ligne existante, vous permettant de modifier les évaluateurs, les sources de données, les paramètres d'exécution et d'autres paramètres. Cette opération gère les mises à jour de manière intelligente sans perturber l'exécution des évaluations.

Les mises à jour ne peuvent être effectuées que lorsque votre configuration d'évaluation est ACTIVE en UPDATE_FAILED cours ou en ERROR état. Si la configuration est en cours de création, de mise à jour ou de suppression, vous recevrez une erreur de conflit et vous devriez réessayer une fois l'opération terminée.

Contrôle d'exécution

Le paramètre d'état d'exécution détermine si votre configuration d'évaluation en ligne traite activement les traces des agents. La compréhension de ces états vous aide à gérer les coûts et les performances des évaluations.

  • Activation de l'évaluation : lorsque vous passez de DISABLED à ENABLED, le système configure le service pour commencer à traiter les traces provenant des sources de données que vous avez spécifiées.

  • Désactivation de l'évaluation : lorsque vous passez de ENABLED à DISABLED, le système arrête de traiter les nouvelles traces tout en préservant votre configuration pour une utilisation future.

Exemples de code pour la AgentCore CLI, le AgentCore SDK et AWS Kit SDK

Les exemples de code suivants montrent comment mettre à jour les 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
AgentCore CLI

  1. Pour mettre à jour une configuration d'évaluation en ligne à l'aide de la AgentCore CLI, modifiez la configuration directement dans votre agentcore.json fichier, puis redéployez :

    agentcore deploy

    Ouvrezagentcore.json, recherchez la configuration dans le onlineEvalConfigs tableau, modifiez ses paramètres, puis exécutezagentcore deploy. Les modifications n'entreront pas en vigueur tant que vous n'aurez pas effectué le déploiement.

    # Pause a running online evaluation
agentcore pause online-eval "your_config_name"

# Resume a paused online evaluation
agentcore resume online-eval "your_config_name"
    Note

    La configuration doit être en état ou ACTIVE en UPDATE_FAILED état de ERROR cycle de vie pour que vous puissiez la mettre à jour.

    Note

    Pour contrôler si la tâche d'évaluation est en cours d'exécution (ENABLED/DISABLED), utilisez agentcore pause online-eval etagentcore resume online-eval.

    Note

    Exécutez-le depuis un répertoire de AgentCore projet (créé avecagentcore create).

AgentCore SDK

  1. from bedrock_agentcore_starter_toolkit import Evaluation

# Initialize the evaluation client
eval_client = Evaluation()
config_id = "config-abc123"
print(f"\nUsing config_id: {config_id}")

# update description
eval_client.update_online_config(
    config_id=config_id,
    description="Updated description for online evaluation"
)
print("✅ Description updated")
AWS SDK

  1. import boto3

client = boto3.client('bedrock-agentcore-control')

update_config_response = client.update_online_evaluation_config(
    onlineEvaluationConfigId='your_config_id',
    description="Updated description for online evaluation"
)
AWS CLI

  1. aws bedrock-agentcore-control update-online-evaluation-config \
    --online-evaluation-config-id your_config_id \
    --description "Updated description for online evaluation"

Console

Modifiez les paramètres de configuration de votre évaluation en ligne à l'aide de l'interface d'édition de la console, qui fournit des options de validation du formulaire et de configuration guidée.

Pour mettre à jour une configuration d'évaluation en ligne

  1. Ouvrez la AgentCore console Amazon Bedrock.

  2. Dans le volet de navigation, choisissez Evaluation.

  3. Dans la fiche Configurations d'évaluation, consultez le tableau répertoriant les configurations d'évaluation que vous avez créées.

  4. Choisissez l'une des méthodes suivantes pour mettre à jour la configuration :

    • Choisissez le nom de la configuration d'évaluation pour en afficher les détails, puis choisissez Modifier dans le coin supérieur droit de la page de détails.

    • Sélectionnez la configuration d'évaluation afin qu'elle soit mise en évidence, puis choisissez Modifier en haut de la carte Configurations d'évaluation.

  5. Mettez à jour les champs selon vos besoins.

  6. Choisissez Mettre à jour la configuration d'évaluation pour enregistrer les modifications.