跳轉到

代理總覽

Gemini API 上的受管代理提供可設定的代理框架。只要一次 API 呼叫,就能佈建 Linux 沙箱,讓代理在其中自主推理、執行程式碼、管理檔案並瀏覽網頁。

快速入門

完成第一次代理呼叫、串流回應,並建構自訂代理。

Antigravity Agent

介紹預設代理的功能、工具、多模態輸入與定價。

AI Studio 中的代理

無需撰寫程式碼即可試作代理的視覺化 Playground。

可用的受管代理

  • Antigravity agent:以 Gemini 4 Hydrogen 建構的通用受管代理。能在 Google 代管的安全 Linux 沙箱中執行程式碼、管理檔案並搜尋網頁。你可以加上自己的指令、技能與資料來延伸它,建構自訂代理。

  • Deep Research:自主研究代理,能規劃、執行並彙整多步驟研究任務,適用於市場分析、盡職調查與文獻回顧等情境。

安全性與最佳做法

注意:受管代理目前為 Public Preview。在敏感工作流程中依賴之前,請先檢視代理的動作與輸出。

每個代理都在沙箱環境中執行,並在作業系統層級隔離。沙箱預設具有不受限制的對外網路存取權,你可以使用允許清單來限制或停用網路存取。

網路存取

環境預設具有不受限制的對外網路存取權。使用 network 允許清單,可將對外流量限制在特定網域或萬用字元模式。如需設定細節,請參閱 Network Allow List(AI Studio)或 Network rules(API)。

外部工具與 API

你可以連接外部工具與 API 來擴充代理。請只使用來自可信來源的工具,並將權限範圍縮小到必要的最小限度。將機密儲存為受管憑證,並以 ID 參照它們,如此 egress proxy 就能在要求發出時注入,機密也不會暴露在沙箱內。代理可能會使用它能存取的任何憑證,因此只應提供你願意授予完整權限範圍的憑證。

  • 使用最小權限的服務帳號或 API 金鑰。
  • 優先使用短期權杖,而非長期金鑰。
  • 只提供你願意授予完整權限範圍的憑證。
  • 定期輪替憑證。

如需憑證類型與管理操作,請參閱 Credentials。你也可以直接在允許清單規則上設定標頭,請參閱 Network configuration。

人工監督

部署前務必驗證輸出內容(產生的程式碼、資料轉換、設定變更),尤其是會修改資料或與外部系統互動的任務。

定價

受管代理採用 按量付費模式,依 Gemini 模型權杖與工具使用量計費。單次互動可能觸發多輪推理循環,通常會消耗 100k 到 3M 個權杖。預覽期間,環境運算不計費。如需各任務的費用明細,請參閱預估成本。

限制

限制 說明
Environment Lifetime 環境在閒置 7 天後會永久刪除。
VM Spin-down VM 會在短暫閒置後關機以節省資源。下一次要求會還原狀態(需冷啟動)。
Pre-installed Software 以 Ubuntu 為基礎的環境,搭載 Python 3.12 與 Node.js 22。如需環境基礎映像的詳細資訊,請參閱 Pre-installed software。
Max agents 最多可擁有 1,000 個受管代理。

代理框架

你也可以使用以下框架與 SDK,搭配 Gemini 建構代理:

  • LangChain / LangGraph:使用圖形結構建構有狀態的複雜應用流程與多代理系統。

  • LlamaIndex:將 Gemini 代理連接到你的私有資料,打造 RAG 強化的工作流程。

  • CrewAI:協調具協作性、角色扮演式的自主 AI 代理。

  • Vercel AI SDK:以 JavaScript/TypeScript 建構 AI 驅動的使用者介面與代理。

  • Google ADK:用於建構與協調可互通 AI 代理的開放原始碼框架。

  • Genkit:以 TypeScript、Go、Python 與 Dart 建構全端 AI 應用與代理。

  • Antigravity SDK:使用驅動 Google Antigravity 的相同工具、代理循環與上下文管理功能,建構自主 AI 代理,可用 Python 撰寫。