オンライン評価を作成する
CreateOnlineEvaluationConfig API は、ライブトラフィックを使用してエージェントのパフォーマンスを継続的にモニタリングする新しいオンライン評価設定を作成します。この非同期オペレーションは、通常のオペレーション中に生成されるエージェントトレースを評価するようにサービスを設定します。
オンライン評価を作成するときは、一意の設定名、モニタリングするデータソース (CloudWatch ロググループまたはエージェントエンドポイントのリスト)、適用する評価者のリスト (最大 10、組み込み評価者とカスタム評価者の組み合わせ) を指定します。また、実行用の IAM サービスロール ARN も指定します。enableOnCreate パラメータは必須であり、作成直後に評価の実行を開始するか ( executionStatus = true)、明示的に有効になるまで無効のままにするか ( executionStatus = false) を決定します。
実行ステータスコントロール
executionStatus パラメータは、評価ジョブがトレースをアクティブに処理するかどうかを決定します。
-
ENABLED – 評価ジョブは継続的に実行され、受信トレースを処理し、評価結果を生成します。
-
DISABLED – 評価設定は存在しますが、ジョブは一時停止しています。トレースは処理または評価されません。
CLI を使用して実行ステータスを制御できます。
# Pause a running online evaluation agentcore pause online-eval "your_config_name" # Resume a paused online evaluation agentcore resume online-eval "your_config_name"
評価者の保護
を executionStatusに設定して評価設定を作成するとENABLED、システムは選択したカスタム評価者を自動的にロックします。ロック後:
-
変更不可 – 評価者の設定、プロンプト、または設定を更新することはできません。変更を加える必要がある場合は、新しい評価者のクローンを作成します。
-
削除不可 – 評価ジョブが評価者を使用している間 (実行中)、評価者を削除することはできません。
AgentCore CLI、AgentCore SDK、および AWS SDK のコードサンプル
次のコードサンプルは、さまざまな開発アプローチを使用してオンライン評価設定を作成する方法を示しています。開発環境と設定に最適な方法を選択します。
例
コンソール
Amazon Bedrock AgentCore コンソールのビジュアルインターフェイスを使用して、オンライン評価設定を作成できます。このメソッドは、評価設定の構成に役立つガイド付きフォームと検証を提供します。
AgentCore オンライン評価を作成するには
-
Amazon Bedrock AgentCore コンソールを開きます。
-
左側のナビゲーションペインで、評価 を選択します。
-
評価設定の作成 を選択します。
-
(オプション) 評価名 に、オンライン評価設定の名前を入力します。
-
(オプション) 作成後に評価設定を有効にするには、評価名の下にあるチェックボックスをオンにします。
-
(オプション) 評価設定の説明 に、AgentCore 評価設定の説明を入力します。
-
(オプション) セッションアイドルタイムアウト には、1~60 分の時間を入力します。デフォルトは 15 分です。
-
-
データソース で、次のいずれかを選択します。
-
エージェントエンドポイントで を定義する – AgentCore ランタイムで以前に作成したエージェントを選択するか、エージェント を選択して新しいエージェントを作成します。次に、エージェントからエンドポイントを選択します。
-
CloudWatch ロググループの選択 – 最大 5 つのロググループを選択します。オブザーバビリティのためにエージェントが使用するサービス名を入力します。AgentCore ランタイムでホストされているエージェントの場合、サービス名は <agent-runtime-name>.<agent-runtime-endpoint-name> の形式に従います。AgentCore ランタイムの外部で実行されているエージェントの場合、サービス名は OTEL_RESOURCE_ATTRIBUTES 環境変数で設定されます。
-
-
評価者 では、組み込み評価者とカスタム評価者を含め、評価設定ごとに最大 10 人の評価者を選択します。
-
(オプション) フィルター では、評価するセッションを識別するために最大 5 つのフィルターを追加します。
-
(オプション) サンプリング では、0.01%~100% のパーセンテージを選択して、評価されるセッションの割合を制御します。デフォルトは 10% です。
-
Amazon Bedrock IAM ロール では、次のいずれかを選択します。
-
既存のロールを使用する – 必要なアクセス許可が既にある IAM サービスロールを選択します。
-
新しいロールの作成 – 新しい IAM サービスロールを作成します。
-
-
エージェントAgentCoreのオンライン評価設定を作成するには、評価設定の作成を選択します。