マネージド ルーブリック ベースの指標の詳細

このページでは、Gen AI Evaluation Service が提供する管理対象のルーブリックベースの指標の完全なリストを示します。この指標は、Agent Platform SDK の GenAI クライアントで使用できます。

テスト駆動型の評価の詳細については、評価指標を定義するをご覧ください。

概要

Gen AI Evaluation Service には、テスト駆動型の評価フレームワーク用の管理されたルーブリックベースの指標のリストが用意されています。

  • 適応型ルーブリックを使用する指標のほとんどには、各プロンプトのルーブリック生成とルーブリック検証の両方のワークフローが含まれています。必要に応じて、個別に実行できます。詳細については、評価を実行するをご覧ください。

  • 静的ルーブリックを含む指標の場合、プロンプトごとのルーブリックは生成されません。目的とされる出力の詳細については、指標の詳細をご覧ください。

マネージド ルーブリック ベースの指標には、バージョン番号があります。指標ではデフォルトで最新バージョンが使用されますが、必要に応じて特定のバージョンに固定できます。

from vertexai import types

text_quality_metric = types.RubricMetric.TEXT_QUALITY
general_quality_v1 = types.RubricMetric.GENERAL_QUALITY(version='v1')

モデルのバージョンとリージョンの可用性

ほとんどのマネージド指標(general_quality_v2、instruction_following_v2、safety_v3、final_response_match_v3 など)の最新バージョンでは、Gemini 3.5 Flash が判定モデルとして使用されます。final_response_quality_v2 や tool_use_quality_v2 など、ルーブリックを生成するエージェント指標も、ルーブリックの生成に Gemini 3.1 Pro を使用します。以前のバージョンでは、Gemini 2.5 Flash と Gemini 2.5 Pro が使用されています。各指標の以前のバージョンとその LLM 呼び出しは、指標の詳細に一覧表示されます。

最新バージョンは、Gemini 3.5 Flash が利用可能な地域でのみ利用できます。Gemini 3.5 Flash が利用できないロケーションで評価を実行する場合は、前の例に示すように、指標を以前のバージョンに固定します。

下位互換性

指標プロンプト テンプレートとして提供される指標については、同じ方法で Agent Platform SDK の GenAI クライアントからポイントワイズ指標にアクセスできます。ペアワイズ指標は Agent Platform SDK の GenAI クライアントではサポートされていませんが、同じ評価で 2 つのモデルを比較するには、評価を実行するをご覧ください。

from vertexai import types

# Access metrics represented by metric prompt template examples
coherence = types.RubricMetric.COHERENCE
fluency = types.RubricMetric.FLUENCY

マネージド指標の詳細

このセクションでは、マネージド指標とそのタイプ、必要な入力、期待される出力などの詳細を示します。

全般的な品質

最新バージョン general_quality_v2
タイプ 適応型ルーブリック
Description モデルのレスポンスの全体的な品質を評価する包括的な適応型ルーブリック指標。プロンプトのコンテンツに基づいて、幅広い基準を自動的に生成して評価します。ほとんどの評価で、この方法をおすすめします。
SDK でアクセスする方法 types.RubricMetric.GENERAL_QUALITY
入力
  • prompt
  • response
  • (省略可)rubric_groups
ルーブリックがすでに生成されている場合は、評価用に直接提供できます。
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 6 回の呼び出し
以前のバージョン general_quality_v1: Gemini 2.5 Flash への 6 回の呼び出し

テキストの品質

最新バージョン text_quality_v2
タイプ 適応型ルーブリック
Description レスポンスの言語品質を具体的に評価する、対象を絞った適応型ルーブリック指標。流暢さ、一貫性、文法などの側面を評価します。
SDK でアクセスする方法 types.RubricMetric.TEXT_QUALITY
入力
  • prompt
  • response
  • (省略可)rubric_groups
ルーブリックがすでに生成されている場合は、評価用に直接提供できます。
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 6 回の呼び出し
以前のバージョン text_quality_v1: Gemini 2.5 Flash への 6 回の呼び出し

指示実行

最新バージョン instruction_following_v2
タイプ 適応型ルーブリック
Description プロンプトで指定された特定の制約と指示にレスポンスがどの程度準拠しているかを測定する、ターゲット設定された適応型ルーブリック指標。
SDK でアクセスする方法 types.RubricMetric.INSTRUCTION_FOLLOWING
入力
  • prompt
  • response
  • (省略可)rubric_groups
ルーブリックがすでに生成されている場合は、評価用に直接提供できます。
出力
  • score(合格率)
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 6 回の呼び出し
以前のバージョン instruction_following_v1: Gemini 2.5 Flash への 6 回の呼び出し

グラウンディング

最新バージョン grounding_v2
タイプ 静的ルーブリック
Description 事実性と整合性をチェックするスコアベースの指標。モデルのレスポンスがコンテキストに基づいてグラウンディングされていることを確認します。
SDK でアクセスする方法 types.RubricMetric.GROUNDING
入力
  • prompt
  • response
  • context
出力
  • score
  • explanation
スコアの範囲は 0-1 です。文に unsupported または contradictory のラベルが付いている場合、スコアは 0 になります。それ以外の場合、スコアは、supported または no_rad とラベル付けされた文の総文数に対する割合を表します。

explanation フィールドは、次のスキーマを持つ文ごとのオブジェクトのリストを含む JSON 文字列です。
[
  {
    "sentence": "string",
    "label": "supported | unsupported | contradictory | no_rad",
    "rationale": "string",
    "excerpt": "string or null"
  }
]
各オブジェクトには次のフィールドが含まれています。
  • sentence: レスポンスから分析される文。
  • label: 文の分類。次のいずれかです。
    • supported: 文は文脈によって含意されます。
    • unsupported: 文が文脈に含まれていません。
    • contradictory: 文脈によって文が偽造されています。
    • no_rad: 文に事実に基づく帰属表示は必要ありません(意見、挨拶、質問、免責事項など)。
  • rationale: ラベル割り当ての簡単な説明。
  • excerpt(supported ラベルと contradictory ラベルの場合に表示): 文を裏付けるか、文と矛盾するコンテキストからの関連する抜粋。
LLM 呼び出しの数 Gemini 3.5 Flash への 1 回の呼び出し
以前のバージョン grounding_v1: Gemini 2.5 Flash への 1 回の呼び出し

安全性

最新バージョン safety_v3
タイプ 静的ルーブリック
説明 モデルのレスポンスが 1 つ以上の安全ポリシーに違反しているかどうかを評価するスコアベースの指標。

safety_v3 は、次のポリシーを確認します。
  • ヘイトとハラスメント(hate_harassment)
  • 性的なコンテンツ(sexual_content)
  • 暴力的または残虐なコンテンツ(violence_gore)
  • 医学的なアドバイス(medical_advice)
  • 危険なコンテンツ(dangerous_content)
  • 児童の性的虐待と搾取(csae)
safety_v1 は次のポリシーを確認します。
  • PII とユーザー層データ
  • ヘイトスピーチ
  • 危険なコンテンツ
  • ハラスメント
  • 性的に露骨な表現
SDK でアクセスする方法 types.RubricMetric.SAFETY
入力
  • prompt
  • response
出力
  • score
  • explanation
スコアの意味は各バージョンで逆になります。
  • safety_v3: 1 は少なくとも 1 つのポリシーが違反したことを意味し、0 はポリシーが違反していないことを意味します。
  • safety_v1: 0 は安全ではなく、1 は安全です。
説明フィールドには、違反したポリシーが含まれます。
LLM 呼び出しの数 Gemini 3.5 Flash への 31 回の呼び出し
以前のバージョン safety_v1: Gemini 2.5 Flash への 10 回の呼び出し

マルチターンの全般的な品質

最新バージョン multi_turn_general_quality_v2
タイプ 適応型ルーブリック
Description マルチターンの会話のコンテキスト内でモデルのレスポンスの全体的な品質を評価する適応型ルーブリック指標。
SDK でアクセスする方法 types.RubricMetric.MULTI_TURN_GENERAL_QUALITY
入力
  • マルチターンの会話での prompt
  • response
  • (省略可)rubric_groups
ルーブリックがすでに生成されている場合は、評価用に直接提供できます。
出力
  • score
  • ルーブリックと対応する判定
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 6 回の呼び出し
以前のバージョン multi_turn_general_quality_v1: Gemini 2.5 Flash への 6 回の呼び出し

マルチターン テキストの品質

最新バージョン multi_turn_text_quality_v2
タイプ 適応型ルーブリック
Description マルチターンの会話のコンテキスト内でモデルのレスポンスのテキスト品質を評価する適応型ルーブリック指標。
SDK でアクセスする方法 types.RubricMetric.TEXT_QUALITY
入力
  • マルチターンの会話での prompt
  • response
  • (省略可)rubric_groups
ルーブリックがすでに生成されている場合は、評価用に直接提供できます。
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 6 回の呼び出し
以前のバージョン multi_turn_text_quality_v1: Gemini 2.5 Flash への 6 回の呼び出し

エージェントの最終レスポンスの一致

最新バージョン final_response_match_v3
タイプ 静的ルーブリック
Description 提供された参照レスポンス(グラウンド トゥルース)と比較して、AI エージェントの最終レスポンスの品質を評価する指標。
SDK でアクセスする方法 types.RubricMetric.FINAL_RESPONSE_MATCH
入力
  • prompt
  • response
  • reference
出力 スコア
  • 1: 参照と一致する有効なレスポンス。
  • 0: 参照と一致しない無効なレスポンス。
説明
LLM 呼び出しの数 Gemini 3.5 Flash への 5 回の呼び出し
以前のバージョン final_response_match_v2: Gemini 2.5 Flash への 5 回の呼び出し

エージェントの最終レスポンスの参照(無料)

最新バージョン final_response_reference_free_v2
タイプ 適応型ルーブリック
Description 参照レスポンスを必要とせずに、AI エージェントの最終レスポンスの品質を評価する適応型ルーブリック指標。
この指標では自動生成されたルーブリックはサポートされていないため、ルーブリックを指定する必要があります。
SDK でアクセスする方法 types.RubricMetric.FINAL_RESPONSE_REFERENCE_FREE
入力
  • prompt
  • response
  • rubric_groups
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 5 回の呼び出し
以前のバージョン final_response_reference_free_v1: Gemini 2.5 Flash への 5 回の呼び出し

エージェントの最終レスポンスの品質

最新バージョン final_response_quality_v2
タイプ 適応型ルーブリック
Description エージェントのレスポンスの全体的な品質を評価する包括的な適応型ルーブリック指標。エージェントの構成(エージェントが使用できるツールのデベロッパー向けの手順と宣言)とユーザーのプロンプトに基づいて、幅広い基準を自動的に生成し、中間イベントでのツールの使用状況とエージェントによる最終回答に基づいて、生成された基準を評価します。
SDK でアクセスする方法 types.RubricMetric.FINAL_RESPONSE_QUALITY
入力
  • prompt
  • response
  • developer_instruction
  • tool_declarations(空のリストでも可)
  • intermediate_events(関数呼び出しとレスポンスを含む。空のリストでも可)
  • (省略可)rubric_groups(ルーブリックがすでに生成されている場合は、評価用に直接提供できます)
出力
  • score
  • rubrics と対応する verdicts

スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 5 回の呼び出しと Gemini 3.1 Pro への 1 回の呼び出し
以前のバージョン final_response_quality_v1: Gemini 2.5 Flash への 5 回の呼び出しと Gemini 2.5 Pro への 1 回の呼び出し

エージェントのハルシネーション

最新バージョン hallucination_v2
タイプ 静的ルーブリック
Description レスポンスを原子単位の主張に分割して、テキスト レスポンスの事実性と整合性をチェックするスコアベースの指標。中間イベントでのツールの使用状況に基づいて、各クレームが根拠のあるものかどうかを確認します。また、フラグ evaluate_intermediate_nl_responses を true に設定することで、中間テキスト レスポンスを評価することもできます。
SDK でアクセスする方法 types.RubricMetric.HALLUCINATION
入力
  • response
  • developer_instruction
  • tool_declarations(空のリストでも可)
  • intermediate_events(関数呼び出しとレスポンスを含む。空のリストでも可)
  • evaluate_intermediate_nl_responses(デフォルトは false)
出力
  • score
  • explanation と対応する verdicts
スコアの範囲は 0-1 で、supported または no_rad としてラベル付けされた文の数と文の合計数の比率を表します。

explanation フィールドは、次のスキーマを持つイベントごとのオブジェクトのリストを含む JSON 文字列です。
[
  {
    "response": "string",
    "score": "double",
    "explanation": [
      {
        "sentence": "string",
        "label": "supported | unsupported | contradictory | disputed | no_rad",
        "rationale": "string",
        "supporting_excerpt": "string or null",
        "contradicting_excerpt": "string or null"
      }
    ]
  }
]
各 explanation エントリには、分割された文ごとに 1 つのオブジェクトが含まれます。オブジェクトには次のフィールドがあります。
  • sentence: 文のセグメンテーション ステップで抽出された正確な文。
  • label: 文の分類。次のいずれかです。
    • supported: 文は文脈によって含意されます。
    • unsupported: 文が文脈に含まれていません。
    • contradictory: 文脈によって文が偽造されています。
    • disputed: コンテキストには、裏付け情報と矛盾する情報の両方が含まれています。
    • no_rad: 文に事実に基づく帰属表示は必要ありません(意見、挨拶、質問、免責事項など)。
  • rationale: ラベル割り当ての簡単な説明。
  • supporting_excerpt(supported ラベルと disputed ラベルの場合): 文をサポートするコンテキストからの関連する抜粋。
  • contradicting_excerpt(contradictory ラベルと disputed ラベルの場合に存在): 文と矛盾するコンテキストからの関連する抜粋。
LLM 呼び出しの数 Gemini 3.5 Flash への 2 回の呼び出し
以前のバージョン hallucination_v1: Gemini 2.5 Flash への 2 回の呼び出し

エージェント ツールの使用品質

最新バージョン tool_use_quality_v2
タイプ 適応型ルーブリック
Description 適切なツールの選択、正しいパラメータの使用、指定された操作シーケンスの遵守を評価する、ターゲット設定された適応型ルーブリック指標。
SDK でアクセスする方法 types.RubricMetric.TOOL_USE_QUALITY
入力
  • prompt
  • developer_instruction
  • tool_declarations(空のリストでも可)
  • intermediate_events(関数呼び出しとレスポンスを含む。空のリストでも可)
  • (省略可)rubric_groups(ルーブリックがすでに生成されている場合は、評価用に直接提供できます)
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 5 回の呼び出しと Gemini 3.1 Pro への 1 回の呼び出し
以前のバージョン tool_use_quality_v1: Gemini 2.5 Flash への 5 回の呼び出しと Gemini 2.5 Pro への 1 回の呼び出し

エージェントのマルチターンのタスク成功率

最新バージョン multi_turn_task_success_v1
タイプ 適応型ルーブリック
説明 マルチターンの会話全体でエージェントがユーザーの目標を達成したかどうかを評価する適応型ルーブリック指標。この指標は、特定ツール呼び出しや推論ステップなどの中間プロセスではなく、エージェントのレスポンスで確認できる結果と確認に焦点を当てています。

この指標は次の 3 つのステップで動作します。
  1. インテントの抽出: 会話からユーザーの目標とインテントを特定します。
  2. ルーブリックの生成: 抽出されたインテント、エージェントの指示、ツール定義に基づいて基準を作成します。
  3. ルーブリックの検証: 生成されたルーブリックに対してエージェントの回答全体を検証します。
SDK でアクセスする方法 types.RubricMetric.MULTI_TURN_TASK_SUCCESS
入力
  • agent_eval_data(モデルの入力、レスポンス、ツール呼び出しを含むマルチターン会話トレース)
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.1 Pro への 2 回の呼び出しと Gemini 3 Flash への 5 回の呼び出し

エージェントのマルチターン ツール使用の品質

最新バージョン multi_turn_tool_use_quality_v1
タイプ 適応型ルーブリック
説明 マルチターンの会話全体にわたって、エージェントのツール呼び出しの技術的および意味的な正確性を評価する適応型ルーブリック指標。エージェントが適切なツールを選択し、引数を正しく入力し、各ユーザー目標のツール スキーマに準拠していることを検証します。

この指標は次の 3 つのステップで動作します。
  1. インテントの抽出: 会話からユーザーの目標とインテントを特定します。
  2. ルーブリックの生成: 各インテントを、想定されるツールの選択、引数の正しさ、スキーマ準拠の基準にマッピングします。
  3. ルーブリックの検証: エージェントの実際のツール呼び出しを生成されたルーブリックに対して検証します。
SDK でアクセスする方法 types.RubricMetric.MULTI_TURN_TOOL_USE_QUALITY
入力
  • agent_eval_data(モデルの入力、レスポンス、ツール呼び出しを含むマルチターン会話トレース)
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.1 Pro への 2 回の呼び出しと Gemini 3 Flash への 5 回の呼び出し

エージェントのマルチターン軌跡の品質

最新バージョン multi_turn_trajectory_quality_v1
タイプ 適応型ルーブリック
説明 マルチターンの会話全体にわたってエージェントの段階的な実行軌跡の品質を評価する適応型ルーブリック指標。最終的な回答だけでなく、エージェントのパスの論理構造と技術的な有効性に重点を置いています。

この指標は次の 3 つのステップで動作します。
  1. インテントの抽出: 会話からユーザーの目標とインテントを特定します。
  2. ルーブリックの生成: 3 つの側面(因果関係の妥当性(ツールのルーティング、状態の追跡、データの受け渡しの正しい順序)、効率性(不要なステップの最小化)、適応性のある堅牢性(エッジケースとエラーの処理))にわたる基準を生成します。
  3. ルーブリックの検証: 生成されたルーブリックと照らし合わせて、エージェントの実際の実行パスを検証します。
SDK でアクセスする方法 types.RubricMetric.MULTI_TURN_TRAJECTORY_QUALITY
入力
  • agent_eval_data(モデルの入力、レスポンス、ツール呼び出しを含むマルチターン会話トレース)
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.1 Pro への 2 回の呼び出しと Gemini 3 Flash への 5 回の呼び出し

Gecko テキスト画像変換の品質

最新バージョン gecko_text2image_v2
タイプ 適応型ルーブリック
Description Gecko テキスト画像変換指標は、生成された画像の品質を対応するテキスト プロンプトに対して評価するための、適応型のルーブリックに基づく手法です。この機能は、まずプロンプトから一連の質問を生成します。これらの質問は、プロンプト固有の詳細なルーブリックとして機能します。モデルは、生成された画像に基づいてこれらの質問に回答します。
SDK でアクセスする方法 types.RubricMetric.GECKO_TEXT2IMAGE
入力
  • prompt
  • response - 画像 MIME タイプのファイルデータである必要があります
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 2 回の呼び出し
以前のバージョン gecko_text2image_v1: Gemini 2.5 Flash への 2 回の呼び出し

Gecko テキスト動画変換の品質

最新バージョン gecko_text2video_v2
タイプ 適応型ルーブリック
Description Gecko テキスト動画変換指標は、生成された動画の品質を対応するテキスト プロンプトに対して評価するための、適応型のルーブリックに基づく手法です。この機能は、まずプロンプトから一連の質問を生成します。これらの質問は、プロンプト固有の詳細なルーブリックとして機能します。モデルは、生成された動画に基づいてこれらの質問に回答します。
SDK でアクセスする方法 types.RubricMetric.GECKO_TEXT2VIDEO
入力
  • prompt
  • response - 動画の MIME タイプのファイルデータである必要があります
出力
  • score
  • rubrics と対応する verdicts
スコアは、ルーブリックに基づくレスポンスの合格率を表します。
LLM 呼び出しの数 Gemini 3.5 Flash への 2 回の呼び出し
以前のバージョン gecko_text2video_v1: Gemini 2.5 Flash への 2 回の呼び出し

次のステップ