View a markdown version of this page

Obtenez une évaluation en ligne - Amazon Bedrock AgentCore
État du cycle de vieExemples de code pour le AgentCore SDK et AWS Kit SDKConsole

Obtenez une évaluation en ligne

L'GetOnlineEvaluationConfigAPI récupère les détails complets et l'état actuel d'une configuration d'évaluation en ligne existante. Cette opération synchrone renvoie la configuration complète, y compris les sources de données, les évaluateurs, l'état d'exécution et les métadonnées opérationnelles.

Utilisez cette API pour surveiller l'état du cycle de vie de la configuration (ACTIVE,CREATING,,CREATE_FAILED, UPDATINGUPDATE_FAILED, ouERROR)DELETING, vérifier l'état d'exécution actuel (ENABLEDouDISABLED) et récupérer tous les paramètres de configuration, y compris les listes d'évaluateurs, les paramètres de source de données et les destinations de sortie.

État du cycle de vie

Le status champ d'une configuration d'évaluation en ligne indique l'état de son cycle de vie, qui est distinct du executionStatus champ qui contrôle si la tâche d'évaluation traite activement les traces.

  • ACTIVE— La configuration est entièrement provisionnée et prête à être utilisée.

  • CREATING— La configuration est en cours de mise en service. Attendez qu'il soit transféré ACTIVE avant de le mettre à jour ou de le supprimer.

  • CREATE_FAILED— La création ne s'est pas terminée correctement. Vous ne pouvez pas mettre à jour une configuration dans cet état ; appelez DeleteOnlineEvaluationConfig pour la supprimer, puis créez-en une nouvelle.

  • UPDATING— Une mise à jour est en cours. Attendez que l'opération soit terminée avant d'apporter des modifications supplémentaires.

  • UPDATE_FAILED— La dernière mise à jour ne s'appliquait pas. Vous pouvez réessayer en appelant UpdateOnlineEvaluationConfig à nouveau ou en supprimant la configuration avecDeleteOnlineEvaluationConfig.

  • DELETING— La configuration est en cours de suppression.

  • ERROR— Un problème est survenu qui nécessite une intervention de votre part. Vérifiez le failureReason champ pour identifier le problème. Les causes courantes incluent un accès insuffisant aux rôles IAM, l'absence d'autorisations de groupe de journaux et le dépassement des quotas de service. Une fois le problème résolu, appelez UpdateOnlineEvaluationConfig pour réessayer ou DeleteOnlineEvaluationConfig pour supprimer la configuration.

Exemples de code pour le AgentCore SDK et AWS Kit SDK

Les exemples de code suivants montrent comment obtenir les détails de configuration de l'é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 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}")

config_details = eval_client.get_online_config(config_id)
# Display configuration details
print(f"Config Name: {config_details['onlineEvaluationConfigName']}")
print(f"Config ID: {config_details['onlineEvaluationConfigId']}")
print(f"Status: {config_details['status']}")
AWS SDK

  1. import boto3

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

response = client.get_online_evaluation_config(
    onlineEvaluationConfigId='your_config_id'
)
AWS CLI

  1. aws bedrock-agentcore-control get-online-evaluation-config \
    --online-evaluation-config-id your_config_id

Console

Vous pouvez consulter des informations détaillées sur une configuration d'évaluation en ligne spécifique via l'interface de la console.

Pour obtenir les détails de configuration de l'é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. Pour afficher les informations relatives à une configuration d'évaluation spécifique, choisissez le nom de la configuration pour en afficher les détails.