Gemini API 中的托管式智能体可为您提供可配置的智能体框架。通过一次 API 调用，即可预配一个 Linux 沙盒，让智能体在其中自主进行推理、执行代码、管理文件和浏览网页。
快速入门
发出首次代理调用、流式传输响应并构建自定义代理。
Antigravity 智能体
默认代理的功能、工具、多模态输入和定价。
AI Studio 中的智能体
无需编写代码即可开发代理原型的可视化园地。
可用的托管式智能体
- Antigravity 智能体：由 Gemini 3.7 Flash 提供支持的通用托管式智能体。在 Google 托管的安全 Linux 沙盒中运行代码、管理文件和搜索网络。您可以使用
agent_config配置底层模型（例如 Gemini 3.7 Flash、Gemini 3.6 Flash 或 Gemini 3.5 Flash），并通过自己的指令、技能和数据对其进行扩展，从而构建自定义代理。 - Deep Research：自主研究智能体，可规划、执行和合成多步骤研究任务，适用于市场分析、尽职调查和文献综述等用例。
安全性和最佳实践
每个代理都在操作系统级隔离的沙盒环境中运行。默认情况下，沙盒具有不受限制的出站网络访问权限。您可以使用许可名单限制或停用网络访问权限。
网络访问
默认情况下，环境具有不受限制的出站网络访问权限。使用 network 许可名单将出站流量限制为特定网域或通配符模式。如需了解配置详情，请参阅网络许可名单 (AI Studio) 或网络规则 (API)。
外部工具和 API
您可以连接外部工具和 API 来扩展智能体。仅使用来自可信来源的工具，并将权限范围限定为所需的最低限度。凭据可以通过出口代理标头转换安全地注入，并且绝不会在沙盒内公开。代理可以使用其有权访问的任何凭据，因此请仅提供您愿意授予完整范围的凭据。
- 使用最小权限的服务账号或 API 密钥。
- 首选短期有效令牌，而不是长期有效密钥。
- 仅提供您愿意授予完整权限的凭据。
- 定期轮替凭据。
如需详细了解如何配置标头转换，请参阅凭据。
人工监督
在部署输出（生成的代码、数据转换、配置更改）之前，请务必先进行验证，尤其是对于会修改数据或与外部系统交互的任务。
价格
受管理的代理使用随用随付模式，费用取决于 Gemini 模型 token 和工具使用情况。单次互动可以触发多个推理循环，通常会消耗 10 万到 300 万个 token。在预览版期间，环境计算资源不计费。如需查看每项任务的费用明细，请参阅估算费用。免费层级还提供受管代理，并附带免费速率限制和使用配额。
限制
| 限制 | 说明 |
|---|---|
| 环境生命周期 | 如果环境处于不活跃状态的时间超过 7 天，系统会将其永久删除。 |
| 虚拟机关闭 | 虚拟机会在闲置一小会儿后关机，以节省资源。下一个请求会恢复状态（通过冷启动）。 |
| 预安装的软件 | 基于 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 相同的工具、智能体循环和上下文管理来构建自主 AI 智能体，并使用 Python 进行编程。