Google 於 2026 年 11 月 19 日公布 Gemini API 的 Tool Retrieval(工具檢索)預覽功能,讓模型先看工具名稱與描述,真正需要時再載入參數結構。對接上大量企業工具的助理,這有機會減少一開始塞進 context 的內容,但不是免費功能,也不保證總費用下降。
台灣開發者最該先確認的是:它目前只適用於 Interactions API,需使用 v1beta;既有 generateContent 流程不能只加一個旗標就沿用。本文依 Google 發布公告與專用技術文件整理,沒有執行模型 API 或宣稱實測效益。
改變的是工具結構載入時機,不是不用傳工具清單
在預設的伺服器端檢索模式下,指定工具可延後載入參數 schema;模型透過 tool_search 尋找適合的工具後,才取得完整參數。名稱與描述仍在初始 context,每次請求仍須提供完整 tools 清單,即使使用 previous_interaction_id 續接對話也是如此。客戶端模式則由應用程式搜尋工具目錄,不必預先宣告整個工具庫。
已載入的工具結構會留在該段對話,不能在同一對話中卸載。因此它比較像降低「還沒用到的工具」的前置負擔,不是讓所有工具成本消失。Google 所稱的效率與準確度優勢屬官方說明,本站未以繁中工作流程驗證。
伺服器端與客戶端檢索有何差別?
| 模式 | 運作方式 | 主要限制 |
|---|---|---|
| 伺服器端 | 把適用的自訂函式或遠端 MCP 工具設為 defer_loading: true,由模型在同一次 API 請求內搜尋 |
搜尋仍會增加內部模型呼叫;自訂函式的實際執行仍由應用程式負責 |
| 客戶端 | 由應用程式搜尋自己的工具目錄,再把選到的定義交回模型 | 增加往返步驟,但可自行處理目錄與使用者權限篩選 |
同一次請求不能混用兩種檢索模式;每次請求只允許一個 tool_search。延後載入也不是權限控制,模型選中工具,不代表使用者有權執行。應用程式仍須驗證權限,重要動作保留必要核准。本文不提供正式環境試跑或自動執行敏感動作的範例。
沒有獨立功能費,為什麼可能更貴?
官方表示 Tool Retrieval 沒有另外一筆功能費,但模型 tokens 仍按所用模型費率收費。容易忽略的是,伺服器端搜尋會在同一次請求中觸發後續模型呼叫:完整 context 與當時已載入的工具結構會再次送入模型,這些輸入計入 total_tool_use_tokens,而不只是最初的 total_input_tokens。
因此,大工具庫且只用少數工具時,延後載入可能划算;工具很少、對話很長或反覆搜尋時,額外呼叫可能抵銷甚至超過節省量。快取命中的部分依快取費率計算,但不能假設每次都會命中。輸出與思考 tokens,以及外部服務本身的費用,也不能從總成本中忽略。
官方文件的成本表是示意算例,不是本站或通用效能測試。實際比較應對照同一批任務的成功率、總時間、初始輸入、後續工具使用輸入、快取與輸出,而非只看第一輪 prompt 變短多少。各模型單價以官方定價為準,本文不把不同模型、促銷或服務層級混為單一價格。
支援哪些模型?公告與文件目前有落差
截至 2026 年 11 月 20 日(台灣時間)查核,專用文件明列 gemini-4-hydrogen、gemini-4-argon、gemini-3.8-flash、gemini-3.6-flash。不過發布公告的描述較廣,稱支援 Gemini 3.6 以後、包括全部 Gemini 4 模型,兩處資訊尚未完全一致。
這不等於證明其他模型不支援,但也不足以認定 Neon 或 Carbon 已可使用。本文不把兩者列為已核實支援;實作前應核對最新專用文件與自己的模型權限。文件另提醒,在不支援的模型使用延後載入會返回 400 錯誤。
台灣可用性、登入與預覽限制
AI Studio/Gemini API 一般地區清單包含台灣;AI Studio 有 Google 帳戶、年齡與地區等存取條件。但一般地區列名不能證明特定台灣帳戶已取得 Tool Retrieval 或某個模型的權限,本站沒有登入帳戶或進行 API 測試。
API 的專案、憑證、模型權限及計費條件,與消費者 Gemini App 訂閱是不同路徑,不能把 Pro/Ultra 訂閱當成任意 API 用量已包含。Tool Retrieval 本身仍為 Preview,介面可能在正式推出前改變;這不表示整個 Interactions API都仍在預覽。
本站判斷:先看工具規模,不必為新功能重寫穩定流程
若助理只接少數工具,現有方式未必需要改。若工具庫持續擴大,名稱相近、參數繁多,Tool Retrieval 才值得列入隔離評估。它的價值是把工具載入與選擇變成可管理的流程,不是承諾零成本、自動判斷所有權限,或保證每次都選對工具。
已使用 Gemini 4 Hydrogen或Gemini 4 Argon的團隊,可先確認現有 API 路徑與完整費用紀錄,再決定是否評估遷移。查核日期:2026 年 11 月 20 日(Asia/Taipei);官方公告日期為 11 月 19 日。本文為文件分析,非台灣帳戶實測。
封面來源:Google 官方 Tool Retrieval 發布公告。
