Gemini API 中的受管理代理提供可設定的代理主機。只要呼叫單一 API，即可佈建 Linux 沙箱，讓代理自主推論、執行程式碼、管理檔案及瀏覽網頁。
快速入門導覽課程
進行第一次代理呼叫、串流回應，以及建構自訂代理。
Antigravity 代理程式
預設代理程式的功能、工具、多模態輸入和定價。
AI Studio 中的代理程式
視覺化測試區，可設計代理程式原型，完全不必編寫程式碼。
可用的 Managed Agents
- Antigravity 代理：由 Gemini 3.5 Flash 驅動的通用型受管理代理。在 Google 代管的安全 Linux 沙箱中執行程式碼、管理檔案及搜尋網路。您可以加入自己的指令、技能和資料來擴充功能，建構自訂代理。
- Deep Research：自主研究代理，可規劃、執行及綜合多步驟研究工作，適用於市場分析、盡職調查和文獻回顧等用途。
安全性與最佳做法
每個代理程式都會在沙箱環境中執行，並在 OS 層級隔離。根據預設，沙箱的傳出網路存取權不受限制。您可以使用許可清單限制或停用網路存取權。
網路存取
根據預設，環境具有不受限制的輸出網路存取權。使用network許可清單將輸出流量限制在特定網域或萬用字元模式。如需設定詳情，請參閱「網路允許清單」(AI Studio) 或「網路規則」(API)。
外部工具和 API
您可以連結外部工具和 API 來擴充代理。請只使用信任來源的工具，並將權限範圍設為最低必要權限。憑證可透過輸出 Proxy 標頭轉換安全地注入，且絕不會在沙箱中公開。代理程式可以使用有權存取的任何憑證，因此請只提供您願意授予完整範圍的憑證。
- 使用最低權限的服務帳戶或 API 金鑰。
- 建議使用短期有效權杖，而非長期有效金鑰。
- 請只提供您願意授予完整範圍的憑證。
- 定期輪替憑證。
如要進一步瞭解如何設定標頭轉換，請參閱「憑證」。
專人監督
部署前請務必驗證輸出內容 (生成的程式碼、資料轉換、設定變更)，尤其是會修改資料或與外部系統互動的工作。
定價
受管理代理會根據 Gemini 模型權杖和工具用量，採用即付即用模式。單一互動可能會觸發多個推理迴圈，通常會消耗 10 萬到 300 萬個權杖。預先發布版期間不會收取環境運算費用。如要查看各項工作的預估費用，請參閱這篇文章。免費方案也提供受管理代理程式，但有免費的速率限制和用量配額。
限制
| 限制 | 說明 |
|---|---|
| 環境生命週期 | 環境閒置 7 天後就會永久刪除。 |
| VM 關閉 | VM 閒置一段時間後會關機，以節省資源。下一個要求會還原狀態 (冷啟動)。 |
| 預先安裝的軟體 | 以 Ubuntu 為基礎的環境，搭載 Python 3.12 和 Node.js 22。如要進一步瞭解環境的基礎映像檔，請參閱「預先安裝的軟體」。 |
| 最多代理程式 | 最多可有 1,000 個受管理代理程式。 |
代理架構
您也可以使用下列架構和 SDK，透過 Gemini 建構代理：
- LangChain / LangGraph：使用圖表結構建構有狀態的複雜應用程式流程和多代理系統。
- LlamaIndex：將 Gemini 代理連結至私人資料，以利 RAG 增強型工作流程。
- CrewAI：自動調度管理角色扮演的自主式 AI 代理，進行協作。
- Vercel AI SDK：在 JavaScript/TypeScript 中建構 AI 輔助的使用者介面和代理程式。
- Google ADK：開放原始碼框架，用於建構及協調可互通的 AI 代理。
- Antigravity SDK：使用與 Google Antigravity 相同的工具、代理程式迴圈和環境管理功能，以 Python 建構自主式 AI 代理程式。