Google 會運用 AI 技術將內容翻譯成你偏好的語言,但可能會出錯。
代管評量表指標的詳細資料
本頁提供 Gen AI Evaluation Service 提供的完整受管理評分量表指標清單,您可以在 Agent Platform SDK 的生成式 AI 用戶端中使用這些指標。
如要進一步瞭解以測試為導向的評估方式,請參閱「定義評估指標」。
總覽
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 用戶端不支援成對指標,但請參閱「執行評估」一文,瞭解如何比較同一評估中的兩個模型。
from vertexai import types
# Access metrics represented by metric prompt template examples
coherence = types.RubricMetric.COHERENCE
fluency = types.RubricMetric.FLUENCY
受管理指標詳細資料
本節列出代管指標,並提供詳細資料,例如指標類型、必要輸入內容和預期輸出內容:
一般品質
| 最新版本 |
general_quality_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項全方位的自動調整評分量表指標會評估模型回覆內容的整體品質,這項功能會根據提示內容,自動生成並評估多種條件。這是大多數評估作業的建議起點。 |
| 如何在 SDK 中存取 |
types.RubricMetric.GENERAL_QUALITY |
| 輸入內容 |
prompt
response
- (選用)
rubric_groups
如果已生成評量表,可以直接提供評估。
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
6 次呼叫 Gemini 3.5 Flash |
| 舊版 |
general_quality_v1:6 次呼叫 Gemini 2.5 Flash |
內容品質
| 最新版本 |
text_quality_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項適用於特定目標的自動調整評分量表指標會評估回覆內容的語言品質,評估流暢度、連貫性和文法等。 |
| 如何在 SDK 中存取 |
types.RubricMetric.TEXT_QUALITY |
| 輸入內容 |
prompt
response
- (選用)
rubric_groups
如果已生成評量表,可以直接提供評估。
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
6 次呼叫 Gemini 3.5 Flash |
| 舊版 |
text_quality_v1:6 次呼叫 Gemini 2.5 Flash |
指令遵循情形
| 最新版本 |
instruction_following_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項適用於特定目標的自動調整評分量表指標會評估回覆內容是否符合提示詞中指定的限制和指令。 |
| 如何在 SDK 中存取 |
types.RubricMetric.INSTRUCTION_FOLLOWING |
| 輸入內容 |
prompt
response
- (選用)
rubric_groups
如果已產生評量表,可以直接提供給評估作業。
|
| 輸出內容 |
score (及格率)
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
6 次呼叫 Gemini 3.5 Flash |
| 舊版 |
instruction_following_v1:6 次呼叫 Gemini 2.5 Flash |
建立基準
| 最新版本 |
grounding_v2 |
| 類型 |
靜態評分量表 |
| 說明 |
這項分數型指標會檢查內容是否符合事實且一致,確認模型回覆是否奠基於脈絡資料。 |
| 如何在 SDK 中存取 |
types.RubricMetric.GROUNDING |
| 輸入內容 |
|
| 輸出內容 |
分數範圍為 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 呼叫次數 |
1 次呼叫 Gemini 3.5 Flash |
| 舊版 |
grounding_v1:1 次呼叫 Gemini 2.5 Flash |
安全性
| 最新版本 |
safety_v3 |
| 類型 |
靜態評分量表 |
| 說明 |
這項指標會根據分數評估模型回覆是否違反一或多項安全政策。
safety_v3 會檢查下列政策:
- 仇恨言論與騷擾行為 (
hate_harassment)
- 色情內容 (
sexual_content)
- 暴力血腥內容 (
violence_gore)
- 醫療建議 (
medical_advice)
- 危險內容 (
dangerous_content)
- 兒少性虐待及剝削 (
csae)
safety_v1 會檢查下列政策:
- 個人識別資訊和受眾特徵資料
- 仇恨言論
- 危險內容
- 騷擾
- 情色露骨內容
|
| 如何在 SDK 中存取 |
types.RubricMetric.SAFETY |
| 輸入內容 |
|
| 輸出內容 |
各版本的評分意義相反:
safety_v3:1 表示至少違反一項政策,0 則表示未違反任何政策。
safety_v1:0 不安全,1 安全。
說明欄位會列出違反的政策。
|
| LLM 呼叫次數 |
31 次呼叫 Gemini 3.5 Flash |
| 舊版 |
safety_v1:10 次呼叫 Gemini 2.5 Flash |
多輪對話一般品質
| 最新版本 |
multi_turn_general_quality_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項自動調整評分量表指標會評估模型在多輪對話中回覆內容的整體品質, |
| 如何在 SDK 中存取 |
types.RubricMetric.MULTI_TURN_GENERAL_QUALITY |
| 輸入內容 |
prompt 進行多輪對話
response
- (選用)
rubric_groups
如果已生成評量表,可以直接提供評估。
|
| 輸出內容 |
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
6 次呼叫 Gemini 3.5 Flash |
| 舊版 |
multi_turn_general_quality_v1:6 次呼叫 Gemini 2.5 Flash |
多輪對話文字品質
| 最新版本 |
multi_turn_text_quality_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項自動調整評分量表指標會評估模型在多輪對話情境中回覆的文字品質。 |
| 如何在 SDK 中存取 |
types.RubricMetric.TEXT_QUALITY |
| 輸入內容 |
prompt 進行多輪對話
response
- (選用)
rubric_groups
如果已生成評量表,可以直接提供評估。
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
6 次呼叫 Gemini 3.5 Flash |
| 舊版 |
multi_turn_text_quality_v1:6 次呼叫 Gemini 2.5 Flash |
代理最終回覆相符
| 最新版本 |
final_response_match_v3 |
| 類型 |
靜態評分量表 |
| 說明 |
這項指標會將 AI 代理的最終答案與提供的參考答案 (基準真相) 進行比較,藉此評估最終答案的品質。 |
| 如何在 SDK 中存取 |
types.RubricMetric.FINAL_RESPONSE_MATCH |
| 輸入內容 |
prompt
response
reference
|
| 輸出內容 |
分數
- 1:與參考資料相符的有效回應。
- 0:無效的回覆,與參考資料不符。
說明
|
| LLM 呼叫次數 |
5 次呼叫 Gemini 3.5 Flash |
| 舊版 |
final_response_match_v2:5 次呼叫 Gemini 2.5 Flash |
代理最終回覆不含參考資料
| 最新版本 |
final_response_reference_free_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項自動調整評分量表指標會評估 AI 代理最終答案的品質,不需要參考答案。
這項指標不支援自動生成的評量表,因此您必須提供評量表。 |
| 如何在 SDK 中存取 |
types.RubricMetric.FINAL_RESPONSE_REFERENCE_FREE |
| 輸入內容 |
prompt
response
rubric_groups
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
5 次呼叫 Gemini 3.5 Flash |
| 舊版 |
final_response_reference_free_v1:5 次呼叫 Gemini 2.5 Flash |
代理最終回覆品質
| 最新版本 |
final_response_quality_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項全方位的自動調整評分量表指標會評估代理回覆內容的整體品質,做法是依據代理設定 (開發人員指令,以及有關代理可用工具的宣告) 和使用者提示詞,自動產生多種條件,然後按照中繼事件和代理最終回覆中的工具使用情況,評估產生的條件。 |
| 如何在 SDK 中存取 |
types.RubricMetric.FINAL_RESPONSE_QUALITY |
| 輸入內容 |
prompt
response
developer_instruction
tool_declarations (可以是空白清單)
intermediate_events (包含函式呼叫和回應,可以是空白清單)
- (選用)
rubric_groups (如果已產生評分量表,可以直接提供評估)
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
5 次呼叫 Gemini 3.5 Flash,1 次呼叫 Gemini 3.1 Pro |
| 舊版 |
final_response_quality_v1:5 次呼叫 Gemini 2.5 Flash,1 次呼叫 Gemini 2.5 Pro |
代理幻覺
| 最新版本 |
hallucination_v2 |
| 類型 |
靜態評分量表 |
| 說明 |
這項分數型指標會檢查文字回覆內容是否符合事實且一致,做法是將回覆內容拆分為多個不可分割的部分,然後依據中繼事件中的工具使用情況,驗證各部分是否有憑有據。
您也可以將 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 項目都包含每個分段句子的物件,以及下列欄位:
sentence:在句子區隔步驟中擷取的確切句子。
label:句子分類,可以是下列其中一種:
supported:情境中包含該句子。
unsupported:句子與情境無關。
contradictory:句子遭情境資訊扭曲。
disputed:內容包含支持和反對的資訊。
no_rad:這類句子不需要註明出處 (例如意見、問候語、問題或免責事項)。
rationale:簡要說明標籤指派作業。
supporting_excerpt (適用於 supported 和 disputed 標籤):情境中與句子相關的摘錄內容。
contradicting_excerpt (適用於 contradictory 和 disputed 標籤):與句子內容相矛盾的相關摘錄。
|
| LLM 呼叫次數 |
2 次呼叫 Gemini 3.5 Flash |
| 舊版 |
hallucination_v1:2 次呼叫 Gemini 2.5 Flash |
| 最新版本 |
tool_use_quality_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項適用於特定目標的自動調整評分量表指標會評估所選工具是否適當、參數使用方式是否正確,以及是否符合指定的作業順序。 |
| 如何在 SDK 中存取 |
types.RubricMetric.TOOL_USE_QUALITY |
| 輸入內容 |
prompt
developer_instruction
tool_declarations (可以是空白清單)
intermediate_events (包含函式呼叫和回應,可以是空白清單)
- (選用)
rubric_groups (如果已產生評分量表,可以直接提供評估)
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
5 次呼叫 Gemini 3.5 Flash,1 次呼叫 Gemini 3.1 Pro |
| 舊版 |
tool_use_quality_v1:5 次呼叫 Gemini 2.5 Flash,1 次呼叫 Gemini 2.5 Pro |
代理多輪對話工作成效
| 最新版本 |
multi_turn_task_success_v1 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項自動調整評分量表指標會評估代理是否在整個多輪對話中,順利達成使用者目標。這項評估著重於代理程式回覆中可觀察到的結果和確認內容,而非特定工具呼叫或推理步驟等中間程序。
這項指標的運作方式分為三個步驟:
- 意圖擷取:從對話中找出使用者目標和意圖。
- 生成評分量表:根據擷取的意圖、代理指令和工具定義建立評量標準。
- 評分量表驗證:根據生成的評分量表,驗證代理的整體回覆內容。
|
| 如何在 SDK 中存取 |
types.RubricMetric.MULTI_TURN_TASK_SUCCESS |
| 輸入內容 |
agent_eval_data (多輪對話追蹤記錄,包括模型輸入內容、回覆和工具呼叫)
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
2 次呼叫 Gemini 3.1 Pro,以及 5 次呼叫 Gemini 3 Flash |
| 最新版本 |
multi_turn_tool_use_quality_v1 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項自動調整評分量表指標會評估代理在整個多輪對話中,工具呼叫的技術和語意正確性。這項指標會驗證代理是否選取正確工具、正確填入引數,以及是否遵守各使用者目標的工具結構定義。
這項指標的運作方式分為三個步驟:
- 意圖擷取:從對話中找出使用者目標和意圖。
- 生成評分量表:將每個意圖對應至預期的工具選取、引數正確性和結構定義相容性準則。
- 評量表驗證:根據生成的評量表,驗證代理實際呼叫的工具。
|
| 如何在 SDK 中存取 |
types.RubricMetric.MULTI_TURN_TOOL_USE_QUALITY |
| 輸入內容 |
agent_eval_data (多輪對話追蹤記錄,包括模型輸入內容、回覆和工具呼叫)
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
2 次呼叫 Gemini 3.1 Pro,以及 5 次呼叫 Gemini 3 Flash |
代理多輪對話軌跡品質
| 最新版本 |
multi_turn_trajectory_quality_v1 |
| 類型 |
自動調整式評分量表 |
| 說明 |
這項自動調整評分量表指標會評估代理在整個多輪對話中,逐步執行軌跡的品質,這項功能著重於代理路徑的邏輯結構和技術有效性,而不只是最終回覆。
這項指標的運作方式分為三個步驟:
- 意圖擷取:從對話中找出使用者目標和意圖。
- 評量表生成:從三個層面生成評量標準:因果效力 (工具路徑、狀態追蹤和資料傳遞的正確順序)、效率 (盡量減少不必要的步驟) 和適應性穩健度 (處理極端情況和錯誤)。
- 評量表驗證:根據生成的評量表,驗證代理的實際執行路徑。
|
| 如何在 SDK 中存取 |
types.RubricMetric.MULTI_TURN_TRAJECTORY_QUALITY |
| 輸入內容 |
agent_eval_data (多輪對話追蹤記錄,包括模型輸入內容、回覆和工具呼叫)
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
2 次呼叫 Gemini 3.1 Pro,以及 5 次呼叫 Gemini 3 Flash |
Gecko 文字轉圖像品質
| 最新版本 |
gecko_text2image_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
Gecko 文字轉圖像指標是一種自動調整的評分量表方法,可根據相應的文字提示詞評估生成圖像的品質。這項功能會先根據提示生成一組問題,做為詳細的提示專屬評分標準。接著,模型會根據生成的圖片回答這些問題。 |
| 如何在 SDK 中存取 |
types.RubricMetric.GECKO_TEXT2IMAGE |
| 輸入內容 |
prompt
response - 應為圖片 MIME 類型的檔案資料
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
2 次呼叫 Gemini 3.5 Flash |
| 舊版 |
gecko_text2image_v1:2 次呼叫 Gemini 2.5 Flash |
Gecko 文字轉影片品質
| 最新版本 |
gecko_text2video_v2 |
| 類型 |
自動調整式評分量表 |
| 說明 |
Gecko 文字轉影片指標是一種自動調整的評分量表方法,可評估生成影片的品質是否符合相應的文字提示詞。這項功能會先根據提示生成一組問題,做為詳細的提示專屬評分標準。接著,模型會根據生成的影片回答這些問題。 |
| 如何在 SDK 中存取 |
types.RubricMetric.GECKO_TEXT2VIDEO |
| 輸入內容 |
prompt
response - 應為影片 MIME 類型的檔案資料
|
| 輸出內容 |
score
rubrics 和對應的 verdicts
分數代表根據評分標準計算出的回覆通過率。
|
| LLM 呼叫次數 |
2 次呼叫 Gemini 3.5 Flash |
| 舊版 |
gecko_text2video_v1:2 次呼叫 Gemini 2.5 Flash |
後續步驟
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2026-10-19 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2026-10-19 (世界標準時間)。"],[],[]]