翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
オンライン評価を作成する
CreateOnlineEvaluationConfig API は、ライブトラフィックを使用してエージェントのパフォーマンスを継続的にモニタリングする新しいオンライン評価設定を作成します。この非同期オペレーションは、通常のオペレーション中に生成されるエージェントトレースを評価するように サービスに指示します。
オンライン評価を作成するには、一意の設定名を指定し、モニタリング対象を選択し、最大 10 人の評価者を選択し、実行用の IAM サービスロール ARN を指定します。データソースは CloudWatch Logs で、正確なロググループ名またはロググループ名のプレフィックス、またはエージェントエンドポイントで選択できます。必要なenableOnCreateパラメータは、最初の を制御しますexecutionStatus。 は で設定trueを開始しENABLED、 で設定falseを開始しますDISABLED。
実行ステータスコントロール
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"
入力ロググループを選択する
データソースが CloudWatch Logs の場合は、次のいずれかdataSourceConfig.cloudWatchLogsの方法で を設定します。
-
logGroupNames– ロググループ名の明示的なリストを指定します。 -
logGroupNamePrefixes– 1~5 個のロググループ名のプレフィックスを指定します。このサービスは、後で作成される一致するロググループなど、名前がプレフィックスの 1 つで始まるロググループのトレースを評価します。
いずれの場合も、サービスが選択したロググループ内のエージェントのトレースを識別serviceNamesできるように を設定します。
logGroupNamePrefixes を使用して Amazon Bedrock AgentCore ランタイムロググループを照合する場合は、ランタイムがエージェント独自のロググループにスパンを送信していることを確認します。まだ共有aws/spansロググループを使用しているエージェントの場合は、ランタイムUNIFIED_TRACES_DESTINATION_ENABLED=trueに を設定します。詳細については、「Amazon Bedrock AgentCore ランタイムでホストされているエージェントのスパン送信先」を参照してください。
# Match input log groups by prefix instead of exact names dataSourceConfig={ "cloudWatchLogs": { "logGroupNamePrefixes": ["/aws/agentcore/my-agent-"], "serviceNames": ["my_agent.DEFAULT"] } }
専用ロググループ、カスタムロググループ、ソースロググループなど、結果とスコアメトリクスが書き込まれる場所の詳細については、「結果と出力」を参照してください。
評価者の保護
を 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 ロール では、次のいずれかを選択します。
注記
アカウントでロールマネージャーが有効になっている場合、AgentCore はロールをアタッチし、ここで説明するロール選択ステップはカスタマイズオプションに置き換えられます。別のロールを使用するには、[カスタマイズ] を選択します。詳細については、「IAM ユーザーガイド」の「IAM ロールの作成」を参照してください。
-
既存のロールを使用する – 必要なアクセス許可が既にある IAM サービスロールを選択します。
-
新しいロールの作成 – 新しい IAM サービスロールを作成します。
-
-
エージェントAgentCoreのオンライン評価設定を作成するには、評価設定の作成を選択します。