Gemini Decisions API 怎麼用？confidence 門檻與 Agent 路由驗收

2026-11-12

AI

/

Gemini

/

API

/

JavaScript

本文目錄

想讓 agent 先判斷問題該走文件查詢還是測試工作流，可以使用 Gemini Decisions API。但收到高 confidence 的答案後，程式仍要先查適用範圍與動作權限，才決定是否採用路由。

Google 於 2026-11-11 推出 Gemini Decision 1。它對固定候選做評分，回傳機率與 confidence，沒有生成文字答案；官方提供 Gemini API／AI Studio 存取，Google Cloud 支援仍列 coming soon。

一次請求要問哪些問題？#

Decisions API 文件提供三種題型：

題型	用在什麼判斷	讀取的主要結果
`noul`	輸入是否符合一個條件	yes 的機率與 `confidence`
`choice`	從固定候選中選一項	`choice`、各選項 `probabilities` 與 `confidence`
`score`	依有順序的 rubric 評分	加權 `score`、各級機率與 `confidence`

針對 coding 工作流，可以拆成「是否屬於這個 repository 的開發問題」與「應查文件或交給測試流程」兩題。所有問題都讀取共用 input，彼此看不到對方的答案；先後條件要在你的程式裡組合。

以下為請求內容示意，尚未呼叫 API。SDK 文件要求 3.2 以上，Python、JavaScript 與 REST 的完整呼叫形式請依官方 quickstart：

1
{
2
  "model": "gemini-decision-1",
3
  "input": "The project tests fail after changing a date formatter.",
4
  "questions": {
5
    "in_scope": {
6
      "type": "noul",
7
      "instructions": "Is this a software development question about the current repository?"
8
    },
9
    "route": {
10
      "type": "choice",
11
      "instructions": "Choose the next workflow for this repository question.",
12
      "criteria": {
13
        "read_docs": "Explain documented behavior without running commands.",
14
        "test_workflow": "A code behavior needs reproduction in an approved test environment.",
15
        "other": "The question requires another workflow."
16
      }
17
    }
18
  }
19
}

題目 key 是你用來對應答案的識別字，模型不會看到它；要把真正問題寫進 instructions。test_workflow 只代表送到後續流程，實際可跑的指令仍由該流程的權限與規則決定。

confidence 很高，也可能是在肯定「不符合」#

yes/no 題的 noul 是 yes 機率，confidence 則是 max(noul, 1 - noul)。例如 noul: 0.03、confidence: 0.97，表示模型很確定答案為 no。只判斷 confidence >= 0.9 就放行，會把確定不適用的輸入一起送進工作流。

另外，choice 一定要在候選裡選。若沒有合適選項，高分也無法替你補出正確的新工作流。因此先做 scope check，再檢查候選白名單及門檻。下面是可獨立執行的政策測試，只使用人工 fixture，沒有呼叫模型：

1
import assert from 'node:assert/strict';
2

3
const allowed = new Set(['read_docs', 'test_workflow']);
4
const unit = (x) => Number.isFinite(x) && x >= 0 && x <= 1;
5

6
function chooseWorkflow(answers) {
7
  const scope = answers?.in_scope;
8
  const route = answers?.route;
9
  if (scope?.type !== 'noul' || route?.type !== 'choice') return 'human';
10
  if (!unit(scope.noul) || !unit(scope.confidence) || !unit(route.confidence)) {
11
    return 'human';
12
  }
13
  if (scope.noul < 0.9 || scope.confidence < 0.9) return 'human';
14
  if (route.confidence < 0.85 || !allowed.has(route.choice)) return 'human';
15
  return route.choice;
16
}
17

18
const fixture = (noul, confidence, choice = 'read_docs') => ({
19
  in_scope: { type: 'noul', noul, confidence: Math.max(noul, 1 - noul) },
20
  route: { type: 'choice', choice, confidence },
21
});
22
assert.equal(chooseWorkflow(fixture(0.97, 0.94)), 'read_docs');
23
assert.equal(chooseWorkflow(fixture(0.97, 0.94, 'test_workflow')), 'test_workflow');
24
assert.equal(chooseWorkflow(fixture(0.03, 0.97)), 'human');
25
assert.equal(chooseWorkflow(fixture(0.97, 0.5)), 'human');
26
assert.equal(chooseWorkflow(fixture(0.97, 0.99, 'delete_repo')), 'human');
27
assert.equal(chooseWorkflow(fixture(0.97, NaN)), 'human');
28
assert.equal(chooseWorkflow({}), 'human');
29
console.log('路由政策 fixture 通過');