今天我們宣布 Gemini API 中 Managed Agents 的新功能，包括 免費層級可用性、預算控制護欄 和 排程觸發器。基於我們 先前推出的背景任務和遠端 MCP 伺服器整合，這些更新直接回應了開發者的反饋，讓您能部署可靠、成本可控且自動化的 Agent。
透過 Gemini API 中的 Gemini Interactions API 使用 Managed Agents，您只需呼叫一個端點，Gemini 就會在隔離的雲端沙箱中處理推理、程式碼執行、套件安裝、檔案管理和網路資訊。
如果您是 AI 程式碼 Agent，請讓您的使用者安裝 Interactions API 技能：npx skills add google-gemini/gemini-skills --skill gemini-interactions-api
以下是使用 @google/genai TypeScript/JavaScript SDK 的範例。如需 Python 或 cURL 版本，請參閱 Antigravity Agent 文件。
1npm install @google/genai
打造成本可控、自動化的 Agent
Gemini API 免費層級可用性
我們正在將 Managed Agents 的預覽版可用性擴展到 Gemini API 的 免費層級專案。
要使用免費層級，只需使用連結到免費專案的 API 金鑰（即未啟用付費功能的專案）來發送請求即可。使用免費層級 API 金鑰時，您的互動將不會被收費，而是依照我們的免費速率限制和使用配額來運行。
預算控制護欄
由於 Antigravity Agent 會在多輪互動中執行自動化的推理、工具執行和程式碼運行循環，單次互動可能會累積大量 Token。為了確保您不會因為失控的任務或意外的高 Token 使用量而無止盡地花費，我們推出了預算控制作為財務護欄。
在 agent_config 中傳遞 max_total_tokens 參數，以控制單次互動可消耗的總 Token 數（輸入 + 輸出 + 思考）。當 Agent 達到限制時，互動會安全地停止並回傳 status: "incomplete"。您的 Agent 的工作成果和環境檔案系統狀態會被保留下來，讓您可以透過 SSE 串流監控執行情況，並透過傳遞 previous_interaction_id 和 environment 以及新的預算，從中斷處繼續未完成的互動。
1import { GoogleGenAI } from "@google/genai";23const client = new GoogleGenAI({});45// 1. 開始一個多步驟稽核，並設定嚴格的預算控制，上限為 10,000 個 Token6const interaction = await client.interactions.create({7 agent: "antigravity-preview-05-2026",8 input: "Clone https://github.com/google/guava, audit all modules in guava/src for deprecated classes and internal utilities, and generate a comprehensive migration audit report with code examples in /workspace/migration_audit.md.",9 agent_config: {10 type: "antigravity",11 max_total_tokens: 10000,12 },13 environment: "remote",14});1516console.log(`Status: ${interaction.status}`);17console.log(`Tokens used: ${interaction.usage?.total_tokens}`);1819// 2. 發送 "continue" 即可繼續20if (interaction.status === "incomplete") {21 const continuation = await client.interactions.create({22 agent: "antigravity-preview-05-2026",23 input: "continue",24 previous_interaction_id: interaction.id,25 environment: interaction.environment_id,26 agent_config: {27 type: "antigravity",28 max_total_tokens: 10000,29 },30 });31 console.log(`Continuation status: ${continuation.status}`);32}
使用觸發器進行排程執行
您現在可以透過排程觸發器自動化週期性的 Agent 任務，無需再運行外部腳本或為 Cron 任務維護專用基礎設施。
觸發器將 Agent、環境、提示詞和 Cron 排程綁定為一個持久化的資源，能夠自動觸發執行，無需手動介入。每次排程執行都會重複使用相同的底層沙箱環境，因此一次運行中建立或複製的檔案會保留下來，並可在下一次執行時立即存取，這使得觸發器非常適合用於每日問題分類、夜間回歸報告，或是在已配置的網路允許清單上進行排程的倉庫維護。
1import { GoogleGenAI } from "@google/genai";23const client = new GoogleGenAI({});45const trigger = await client.triggers.create({6 schedule: "0 9 * * *", // 每天早上 9:007 time_zone: "America/Los_Angeles",8 display_name: "daily-issue-solver",9 interaction: {10 agent: "antigravity-preview-05-2026",11 input: [12 {13 type: "text",14 text: "Review open PRs in our repo for new comments and address feedback. Check for new issues labeled 'accepted', skip any tracked in /workspace/solved-issues/, fix the rest, and open PRs. Save reports to /workspace/solved-issues/.",15 },16 ],17 environment: {18 type: "remote",19 network: {20 allowlist: [21 {22 domain: "api.github.com",23 transform: {24 Authorization: "Bearer ghp_example_token",25 },26 },27 { domain: "github.com" },28 ],29 },30 },31 },32});3334console.log(`Trigger created: ${trigger.id}`);35console.log(`Next scheduled run: ${trigger.next_run_time}`);3637const executions = await client.triggers.listExecutions(trigger.id);38for (const ex of executions.trigger_executions) {39 console.log(`${ex.id}: ${ex.status} (${ex.start_time} - ${ex.end_time})`);40}
開始使用 Managed Agents
這些更新將 Managed Agents 轉變為成本可控、可排程的工作者，它們能自主地在真實開發環境中運行，而不會超出您的預算，也無需外部協調。
請查看 Gemini Interactions API 概覽 和 Managed Agents 快速入門，以探索自訂 Agent 定義、環境配置、網路規則和進階串流模式。
