View a markdown version of this page

オンライン評価を更新する - Amazon Bedrock AgentCore
実行コントロールAgentCore CLI、AgentCore SDK、および AWS SDK のコードサンプルコンソール

オンライン評価を更新する

UpdateOnlineEvaluationConfig API は既存のオンライン評価設定を変更し、評価者、データソース、実行設定、その他のパラメータを変更できます。このオペレーションは、実行中の評価を中断することなく、更新をインテリジェントに処理します。

更新は、評価設定が ACTIVE、UPDATE_FAILED、または ERRORステータスの場合にのみ実行できます。設定が現在作成、更新、または削除されている場合、競合エラーが表示され、オペレーションの完了後に再試行する必要があります。

実行コントロール

実行ステータスパラメータは、オンライン評価設定がエージェントトレースをアクティブに処理するかどうかを制御します。これらの状態を理解することで、評価コストとパフォーマンスを管理できます。

  • 評価の有効化 – DISABLED から ENABLED に変更すると、システムは指定されたデータソースからのトレースの処理を開始するようにサービスをプロビジョニングします。

  • 評価の無効化 – ENABLED から DISABLED に変更すると、システムは将来の使用のために設定を保持しながら、新しいトレースの処理を停止します。

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

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

例
AgentCore CLI

  1. AgentCore CLI でオンライン評価設定を更新するには、 agentcore.json ファイル内の設定を直接編集してから、再デプロイします。

    agentcore deploy

    を開きagentcore.json、onlineEvalConfigs配列内の設定を見つけ、その設定を変更してから、 agentcore deploy を実行します。変更はデプロイするまで有効になりません。

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

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

    設定は、更新する前に ACTIVE、UPDATE_FAILED、または ERRORライフサイクルステータスである必要があります。

    注記

    評価ジョブが実行されているかどうか (ENABLED/) DISABLED を制御するには、 agentcore pause online-evalと を使用しますagentcore resume online-eval。

    注記

    AgentCoreプロジェクトディレクトリ内 ( で作成) agentcore 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"

コンソール

フォーム検証とガイド付き設定オプションを提供するコンソールの編集インターフェイスを使用して、オンライン評価設定を変更します。

オンライン評価設定を更新するには

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

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

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

  4. 次のいずれかの方法を選択して設定を更新します。

    • 評価設定名を選択して詳細を表示し、詳細ページの右上にある編集を選択します。

    • 評価設定を選択して強調表示し、評価設定カードの上部にある編集を選択します。

  5. 必要に応じて、フィールドの値を更新します。

  6. 評価設定の更新を選択して変更を保存します。