Gemini API託管代理:3.6 Flash、鈎子等新功能
Gemini API的託管代理現在默認使用Gemini 3.6 Flash,並引入了環境鈎子、預算控制、定時觸發器和免費層級訪問,幫助開發者構建可靠的生產級代理。
Gemini API的託管代理(Managed Agents)功能迎來重大更新,現在默認使用Gemini 3.6 Flash模型,並引入了環境鈎子(Environment Hooks)、預算控制、定時觸發器和免費層級訪問。這些新能力建立在之前發佈的背景任務和遠程MCP服務器集成基礎之上,旨在幫助開發者構建更可靠、更可控的生產級代理。
託管代理通過Gemini Interactions API,只需一次API調用即可在隔離的雲沙盒中協調推理、代碼執行、包安裝、文件管理和網絡檢索等操作。對於使用AI編碼助手的開發者,可以通過命令npx skills add google-gemini/gemini-skills --skill gemini-interactions-api快速啓用Interactions API技能。
Gemini 3.6 Flash成為默認模型
從antigravity-preview-05-2026代理開始,託管代理默認運行Gemini 3.6 Flash模型,無需任何代碼更改即可自動升級。開發者也可以通過傳遞agent_config.model參數顯式選擇其他模型,例如使用Gemini 3.5 Flash-Lite以降低成本和延遲。支持的模型包括:
- Gemini 3.6 Flash(默認):推理、編碼和工具使用的平衡模型。
- Gemini 3.5 Flash:前代模型,適用於通用代理工作流。
- Gemini 3.5 Flash-Lite:Gemini 3.5系列中延遲和成本最低的模型。
環境鈎子:在沙盒內攔截工具調用
環境鈎子允許開發者在代理每次調用工具之前或之後運行自定義腳本。通過在環境中添加.agents/hooks.json配置文件,可以定義pre_tool_execution和post_tool_execution事件的處理程序。鈎子支持正則表達式匹配工具名稱,例如:
- 在
code_execution或write_file調用前運行安全審查腳本,如果返回拒絕決策則跳過該工具調用。 - 在所有工具調用後運行自動格式化腳本,以確保代碼風格一致。
鈎子還支持HTTP類型,可直接向外部端點發送POST請求。AI原生投資銀行Offdeal已利用post_tool_execution鈎子在遠程沙盒中實現自動圖像驗證,確保公司標識符合質量和格式要求。
成本控制與自動化功能
託管代理現已在免費層級項目中可用,開發者無需綁定支付方式即可體驗代理工作流。為避免多輪自主循環消耗過多令牌,可以通過max_total_tokens參數設置預算上限。當達到限制時,執行會安全暫停並返回狀態"incomplete",環境狀態保留,開發者可以通過傳遞previous_interaction_id和新的預算繼續執行。
此外,定時觸發器(Scheduled Triggers)支持將代理、環境、提示和cron計劃綁定為持久資源,自動執行重複任務。每次運行復用同一沙盒,文件可在執行間持久化。
新的環境API(Environments API)允許開發者通過代碼列出、檢查和刪除沙盒會話,例如在斷線後恢復環境ID,或在工作流完成後清理沙盒,無需等待7天的TTL。
這些更新將託管代理轉變為成本可控、可調度的自主工作者,能夠在真實開發環境中獨立運行,無需外部編排。開發者可以查閲Gemini Interactions API概覽和託管代理快速入門指南,探索自定義代理定義、環境配置、網絡規則和高級流式模式。