View a markdown version of this page

オンライン評価の取得 - Amazon Bedrock AgentCore
ライフサイクル状態AgentCore SDK および AWS SDK のコードサンプルコンソール

オンライン評価の取得

GetOnlineEvaluationConfig API は、既存のオンライン評価設定の完全な詳細と現在のステータスを取得します。この同期オペレーションは、データソース、評価者、実行ステータス、運用メタデータを含む完全な設定を返します。

この API を使用して、設定のライフサイクルステータス (ACTIVE、CREATING、、CREATE_FAILED、UPDATE_FAILED、、または ERROR) UPDATINGをモニタリングしDELETING、現在の実行ステータス (ENABLED または DISABLED) をチェックし、評価者リスト、データソース設定、出力先を含むすべての設定パラメータを取得します。

ライフサイクル状態

オンライン評価設定の statusフィールドは、ライフサイクル状態を報告します。ライフサイクル状態は、評価ジョブがトレースをアクティブに処理しているかどうかを制御する executionStatusフィールドとは別のものです。

  • ACTIVE – 設定は完全にプロビジョニングされ、すぐに使用できます。

  • CREATING – 設定はプロビジョニング中です。更新または削除ACTIVEする前に、 に移行するのを待ちます。

  • CREATE_FAILED – 作成が正常に完了しませんでした。この状態で設定を更新することはできません。 DeleteOnlineEvaluationConfig を呼び出して設定を削除し、新しい設定を作成します。

  • UPDATING – 更新が進行中です。オペレーションが完了するまで待ってから、追加の変更を加えます。

  • UPDATE_FAILED – 最新の更新は適用されませんでした。UpdateOnlineEvaluationConfig をもう一度呼び出すか、 で設定を削除して再試行できますDeleteOnlineEvaluationConfig。

  • DELETING – 設定は削除中です。

  • ERROR – アクションを必要とする問題が発生しました。failureReason フィールドをチェックして問題を特定します。一般的な原因には、IAM ロールへのアクセス不足、ロググループのアクセス許可の欠落、サービスクォータの超過などがあります。問題を修正したら、 UpdateOnlineEvaluationConfig を呼び出して再試行するか、 DeleteOnlineEvaluationConfig設定を削除します。

AgentCore SDK および AWS SDK のコードサンプル

次のコードサンプルは、さまざまな開発アプローチを使用してオンライン評価設定の詳細を取得する方法を示しています。開発環境と設定に最適な方法を選択します。

例
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

コンソール

コンソールインターフェイスを使用して、特定のオンライン評価設定に関する詳細情報を表示できます。

オンライン評価設定の詳細を取得するには

  1. Amazon Bedrock AgentCore コンソールを開きます。

  2. ナビゲーションペインで、評価 を選択します。

  3. 評価設定カードで、作成した評価設定を一覧表示する表を表示します。

  4. 特定の評価設定の情報を表示するには、設定名を選択して詳細を表示します。