View a markdown version of this page

結果と出力 - Amazon Bedrock AgentCore

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

結果と出力

オンライン評価の結果は自動的に Amazon CloudWatch に保存されます。デフォルトでは、サービスはそれらを JSON ログエントリとして専用の CloudWatch ロググループに書き込みます。

ロググループ構造

デフォルトの専用送信先を使用する場合、サービスは評価結果を /aws/bedrock-agentcore/evaluations/results/<online-evaluation-config-id> に書き込みます。Amazon Bedrock AgentCore コンソールの評価の詳細ページで、設定の解決済み結果ロググループを確認できます。

各評価では、このロググループ内に個別のログエントリが生成されます。さらに、評価スコアはモニタリングと分析のための CloudWatch メトリクスとして出力されます。

結果が書き込まれる場所を選択する

resultDestination で を使用してoutputConfig.cloudWatchConfig、オンライン評価結果が書き込まれる場所を選択します。設定しない場合、サービスは専用のロググループを使用します。

  • DEDICATED_LOG_GROUP (デフォルト) – 専用の結果ロググループに結果を書き込みます。を設定しない場合logGroupName、サービスは を使用します/aws/bedrock-agentcore/evaluations/results/<online-evaluation-config-id>。別の専用ロググループを使用するには、 を設定します logGroupName (「」を参照カスタム出力ロググループを使用する)。

  • SOURCE_LOG_GROUP – エージェントトレースを提供したのと同じロググループに結果を書き戻すため、評価はスコアリングしたトレースと一緒に表示されます。この値を使用するlogGroupNameときは、 を設定しないでください。

カスタム出力ロググループを使用する

resultDestination が の場合DEDICATED_LOG_GROUP、選択したロググループに結果を送信するlogGroupNameように を設定できます。ロググループが既に存在する場合、サービスはそれをそのまま使用します。存在しない場合、サービスはそれを作成するため、評価実行ロールはそのロググループlogs:CreateLogGroupを許可する必要があります。名前は、この設定独自のサービスマネージドデフォルトグループを除き、予約済み/aws/bedrock-agentcore/evaluations/プレフィックスを使用できません。

# Write results back to the trace source log group outputConfig={"cloudWatchConfig": {"resultDestination": "SOURCE_LOG_GROUP"}} # Write results to a custom dedicated log group outputConfig={"cloudWatchConfig": {"resultDestination": "DEDICATED_LOG_GROUP", "logGroupName": "/my/team/evaluation-results"}}

カスタム名前空間にメトリクスを発行する

評価スコアは CloudWatch メトリクスとしても公開されます。デフォルトでは、サービスは Bedrock-AgentCore/Evaluations名前空間を使用します。チームまたはテナントごとに結果を区切るなど、独自の名前空間でメトリクスを発行するには、 metricsNamespaceで を設定しますoutputConfig.cloudWatchConfig。値は で始めることはできませんAWS/。

outputConfig={"cloudWatchConfig": {"metricsNamespace": "MyTeam/Evaluations"}}

結果形式

評価結果は、GenAI 評価結果イベントの OpenTelemetry セマンティック規則に従います。可能な場合、各イベントは元のスパン ID に親付けられ、元のトレース ID とセッション ID が含まれます。

CloudWatch Logs Insights を使用して評価結果をクエリおよび分析し、CloudWatch Metrics を使用して評価傾向を経時的にモニタリングできます。

CloudWatch Observability Console での結果の表示

CloudWatch Observability Console を使用して、評価結果を表示および分析できます。コンソールには、エージェント評価の視覚化、メトリクス、詳細ログが表示されます。

評価結果を表示するには

  1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

  2. ナビゲーションペインで、GenAI Observability > Bedrock AgentCore を選択します。

  3. エージェントセクションで、評価設定に関連付けられたエージェントとエンドポイントを選択します。

  4. 詳細な結果については、評価タブに移動します。

詳細については、AWS CloudWatch セッショントレース評価ドキュメント」を参照してください。

CloudWatch メトリクスでの評価スコアの表示

評価スコアは CloudWatch メトリクスとして発行されます。デフォルトでは、Bedrock-AgentCore/Evaluations名前空間に表示されます。を設定する場合はmetricsNamespace、CloudWatch でメトリクスを参照するときに、代わりにそのカスタム名前空間を探します。

評価スコアを表示するには

  1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

  2. ナビゲーションペインで、メトリクス > すべてのメトリクスを選択します。

  3. 参照タブで、Bedrock-AgentCore/Evaluations または で設定したカスタム名前空間を選択します。 outputConfig.cloudWatchConfig.metricsNamespace

  4. ディメンションの組み合わせを選択して、必要に応じて評価者タイプまたは評価ラベルで結果を絞り込む

詳細については、AWS CloudWatch セッショントレース評価ドキュメント」を参照してください。