New 一對一 AI 實戰課,不設班期,直接預約 →

最新 AI 貼士 · AI News

Google 推出 Gemini API Tool Retrieval:於 Interactions API 預覽中按需載入工具參數結構

Google 於 2026 年 11 月 19 日公布 Gemini API Tool Retrieval,現於 Interactions API 以預覽形式提供。加入 tool_search 並設定 defer_loading:true 後,參數結構只在需要時載入。沒有單獨收費,按標準 token 計費,適用於 Gemini 3.6 及之後包括所有 Gemini 4 模型。

AI News 封面插圖:Google 與 Gemini

Gemini 新聞來源摘要

本文目錄:這則更新發生了甚麼及何時公布 | 已確認事實與尚未確認事項 | 這則更新會影響誰、影響甚麼決定 | 現在可以採取的核對步驟 | 文章參考資料

這則更新發生了甚麼及何時公布

Google 於 2026 年 11 月 19 日在官方網誌發布 Introducing Tool Retrieval in the Gemini API。文章由 Gemini API 產品經理 Lucia Loher,以及 Google DeepMind 研究科學家 Nora Kassner 署名,說明公司推出 Tool Retrieval,並寫明該功能現於 Gemini Interactions API 以預覽(preview)形式提供。

這不是另一次只談模型分數的研究摘要,而是一項面向代理(agent)開發的應用程式介面功能。官方要處理的問題很具體:當一個代理連接數十甚至數百個工具時,若每次請求都把全部工具的完整參數結構送出,輸入 token 會快速增加,延遲也會上升,工具選擇的準確度更可能隨著候選名單變長而下降。Tool Retrieval 的做法,是讓代理把完整工具庫先放在備用狀態,只在當前任務需要時才載入參數結構。

網誌同時指向完整設定說明,本站於 2026 年 11 月 20 日查閱的文件頁為 Tool retrieval(網誌「Read the documentation」亦連至 Google AI Studio 的同一主題文件)。讀者應把網誌與開發者文件一併閱讀,不要只看轉述。本篇只整理 11 月 19 日這次公布的已確認範圍,不代替文件中的程式細節,也不把預覽功能寫成已經結束測試的正式版。

若你較關心 Gemini 既有的個別工具用法,而不是這次按需載入工具結構的機制,可另讀本站已上線的 URL context 教學、程式碼執行說明,以及 Grounding with Google Search 教學。那些文章處理的是特定工具的操作,不能用來推論 Tool Retrieval 今天是否已出現在你的專案中。本站亦已另文整理 Gemini 4 Neon;網誌示例使用的模型是 gemini-4-hydrogen,兩者不要混為同一則公布。

已確認事實與尚未確認事項

就啟用方式,官方網誌寫得很直接:在請求中加入一個 tool_search 工具,並在你希望暫緩載入的工具上設定 defer_loading: true。模型仍然看得到每個被暫緩工具的名稱與描述,因此知道有哪些工具可供選擇,但參數結構先不會進入上下文。當模型需要某個工具時,會按名稱提出;API 載入完整結構後,模型再發出函式呼叫。官方寫明這三個步驟都在同一請求內完成,並會出現在 interaction.steps 之中,方便除錯時查看模型考慮過哪些工具名稱或描述。

網誌示例使用 model="gemini-4-hydrogen",並以一個設定了 defer_loading: true 的 issue_refund 函式作為示範。同一呼叫內,步驟會先出現 tool_search_call 與 tool_search_result,然後才是 function_call。之後的流程仍是一般函式呼叫:由你的程式執行該操作,再回傳 function_result。官方也說明,常用工具可以維持預先載入,長尾工具才設定暫緩,並不是要求把所有工具一律延後。

官方特別強調:開發者不必自行建立或託管索引。搜尋由 Gemini 在伺服器端執行,程式只要新增上述工具與旗標。Tool Retrieval 也可與 prefix caching 一併使用:被暫緩的參數結構不會放在提示開頭,模型稍後載入的結構會加在對話較後的位置,因此快取前綴在各輪對話中可以保持不變。它亦可與 Gemini API 的遠端 MCP 伺服器一併使用:只要在 mcp_server 工具上設定 defer_loading: true,該伺服器公開的所有工具都會按需載入,不必逐一列出。

若你自行維護工具登錄、嵌入索引,或要按用戶權限過濾可用工具,官方另提供客戶端檢索:把 tool_search 宣告為 "execution": "client",並自行定義搜尋參數。這種做法每次搜尋會多一趟往返,因為查找由你的應用程式執行。官方亦寫明,在客戶端模式下,工具不必事先全部宣告,因此用戶在對話中途接上新的整合時,也可以加入新工具。開發者文件把三種做法做了對照:把全部結構每次都送出的靜態載入,較適合大約少於 20 個穩定工具的情況;伺服器端檢索較適合大型但固定的工具庫,工具須事先宣告,可與 MCP 一併使用,搜尋不會額外增加往返;客戶端檢索則較適合自有登錄或按用戶而異的工具集,但不適用於 MCP。文件並建議:若應用對延遲敏感,應使用伺服器端檢索。

計費方面,官方網誌寫明 Tool Retrieval 沒有單獨收費,輸入與輸出 token 按你所呼叫模型的標準費率計算。開啟 tool_search 會增加一小段固定的輸入 token;模型載入的每份參數結構,在之後的對話中會按輸入 token 計費,與一開始就宣告的工具相同。官方的判斷是:當「從未載入的結構」多於「實際載入的結構」時,通常可以節省 token,但必須以自己的流量衡量。開發者文件補充:被暫緩的工具在載入前,只以延遲工具清單中的單行項目計入輸入 token;每次伺服器端搜尋也會產生自身的 token 成本。以上都是官方以 token 與標準費率說明的計費方式,本文不改寫成港幣,也不編造單價。

支援模型方面,官方寫明:在 Interactions API 中,Tool Retrieval 適用於 Gemini 3.6 及之後的模型,包括所有 Gemini 4 模型。這是已確認的模型範圍,但不等於所有產品入口、所有方案層級都已經提供該預覽。以下事項尚未由官方按地區、帳戶類型或預覽時程逐項說明,本文不能當成已確認:這項預覽何時結束或轉為正式版;免費層或特定帳單帳戶是否一定看得到;香港或其他單一市場是否有不同的供應安排;以及以港幣計算的費用。任何「已經在香港全面開放」或「本地一定無法使用」的說法,都不屬於已核實事實。

這則更新會影響誰、影響甚麼決定

如果你正在把大量自訂函式、內部系統或遠端 MCP 伺服器接到 Gemini 代理,這則更新首先影響的是請求設計與成本估算。官方要解決的是「每次都把完整參數結構送出」所帶來的 token、延遲與選擇準確度問題。決定是否改用 Tool Retrieval 時,應同時核對自己屬哪一種情況:工具數量是否已經遠超文件所稱大約 20 個穩定工具的靜態載入情境、常用工具與長尾工具如何劃分,以及是否需要 prefix caching 或遠端 MCP 的按需載入。

負責權限控制或按用戶提供不同工具集的團隊,還要額外核對是否應改用客戶端檢索。官方清楚寫出這種模式會多一趟往返,而且不適用於 MCP;文件也提醒,對延遲敏感的應用應優先考慮伺服器端檢索。換言之,不能把「已經支援 Tool Retrieval」理解成只開一個旗標就適合所有架構。示例中的模型是 gemini-4-hydrogen,實際選型仍應以你自己的任務、官方模型頁與 Interactions API 當時支援名單為準。

對主要在免費層試用 Gemini,或只在應用程式介面使用一般對話功能的個人用戶,這則更新不應被讀成日常聊天已經自動換成新工具機制。它處理的是開發者在 Interactions API 中管理大型工具庫的方式。若你需要比較學院的學習路徑,可查看 香港 AI 課程總覽,課程安排以該頁當時公布為準,本文不另行改寫。

現在可以採取的核對步驟

  1. 打開 Google 官方網誌 Introducing Tool Retrieval in the Gemini API,核對公布日期為 2026 年 11 月 19 日,並確認官方寫的是 Interactions API 的預覽,而不是把它理解成所有 Gemini 產品已經預設開啟。
  2. 打開開發者文件 Tool retrieval,核對 tool_search、defer_loading: true、伺服器端與客戶端檢索的差異,以及「沒有單獨收費、按標準 token 費率計算」是否仍與查閱當日一致。
  3. 盤點自己的工具庫:哪些工具應保持預先載入,哪些屬長尾而適合暫緩;若使用遠端 MCP,核對是否可在 mcp_server 上設定 defer_loading: true。若工具集按用戶而異,再評估客戶端檢索是否值得增加一趟往返。
  4. 在實際流量上比較開啟 Tool Retrieval 前後的輸入 token、快取命中與延遲,不要只根據官方「通常可節省」的表述做結論;涉及計費與模型可用性,一律以官方文件及你帳戶當日顯示為準。

文章參考資料

Google,Lucia Loher、Nora Kassner,Introducing Tool Retrieval in the Gemini API:https://blog.google/innovation-and-ai/technology/developers-tools/gemini-api-tool-retrieval/。公布日期:2026 年 11 月 19 日。查閱日期:2026 年 11 月 20 日。

Google AI for Developers,Tool retrieval:https://ai.google.dev/gemini-api/docs/tool-retrieval。網誌亦指向 https://aistudio.google.com/docs/tool-retrieval。查閱日期:2026 年 11 月 20 日。

本頁僅供一般資訊與學習用途,不構成法律、醫療、臨床、投資、採購或專業意見。

學習 AI,保護你的未來。

分享本文

返回最新 AI 貼士與 AI News

AI.Academy

想把這則更新用在工作上?

先核對原文,再用一個真實任務試做。需要導師在課堂帶著完成時,可報讀 AI Academy HK 實戰課。

  • 易上手
  • 一對一實戰
  • 帶走作品

不確定應該從哪一堂開始?

MISA:We're here to help