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