View a markdown version of this page

評価者の更新 - Amazon Bedrock AgentCore

評価者の更新

UpdateEvaluator API は、既存のカスタム評価者の設定、説明、または評価レベルを変更します。この非同期オペレーションは、ロック解除された評価者でのみ許可されます。

変更ロック保護: 評価者が有効な評価設定で使用されている場合、更新は許可されません。

API は、更新されたメタデータとともにすぐに を返します。評価者のステータスをモニタリングして、GetEvaluatorAPI を使用して変更が正常に適用されていることを確認します。

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

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

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

    agentcore deploy

    を開きagentcore.jsonevaluators配列内の評価者を検索し、その設定を変更してから、 agentcore deploy を実行します。変更はデプロイするまで有効になりません。

    注記

    実行中のオンライン評価によって評価者がロックされている場合は、変更agentcore pause online-evalを行う前にまず を使用してオンライン評価を一時停止するか、代わりに評価者のクローンを作成する必要があります。変更をデプロイしたら、 を使用してオンライン評価を再開しますagentcore resume online-eval

    注記

    AgentCoreプロジェクトディレクトリ内 ( で作成) agentcore create からこれを実行します。

AgentCore SDK
  1. from bedrock_agentcore_starter_toolkit import Evaluation eval_client = Evaluation() eval_client.update_evaluator( evaluator_id=evaluator_id, description="Updated custom evaluator description" )
AWS SDK
  1. import boto3 client = boto3.client('bedrock-agentcore-control') list_configs_response = client.update_evaluator( evaluatorId=evaluator_id, description="Updated custom evaluator description" )
AWS CLI
  1. aws bedrock-agentcore-control update-evaluator \ --evaluator-id 'evaluator-abc123' \ --description "Updated custom evaluator description"

コンソール

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

カスタム評価者を更新するには

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

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

  3. 評価設定の横にあるカスタム評価者を選択します。

  4. カスタム評価者カードで、作成したカスタム評価者を一覧表示する表を表示します。

  5. 次のいずれかの方法を選択して、カスタム評価者を更新します。

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

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

      注記

      評価者がオンライン評価で使用されている場合は、更新できません。代わりに、評価者を複製し、クローンされたバージョンを更新できます。

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

  7. 評価者の更新を選択して変更を保存します。