代理概览

Gemini API 中的托管式智能体为您提供可配置的智能体框架。只需一次 API 调用,即可预配 Linux 沙盒,智能体可在其中自主推理、执行代码、管理文件和浏览网页。

可用的托管式智能体

安全性和最佳实践

每个智能体都在操作系统级隔离的沙盒环境中运行。 默认情况下,沙盒具有不受限制的出站网络访问权限。您可以使用许可名单限制或停用网络访问权限。

网络访问

默认情况下,环境具有不受限制的出站网络访问权限。使用 network 许可名单将出站流量限制为特定网域或通配符模式。如需了解配置详情,请参阅 网络许可名单 (AI Studio) 或 网络规则 (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:Build 在 JavaScript/TypeScript 中构建 AI 驱动型界面和智能体。
  • Google ADK:一个 用于构建和编排可互操作 AI 智能体的开源框架。
  • Antigravity SDK:使用与 Google Antigravity 相同的工具、智能体循环和上下文 管理来构建自主 AI 智能体,并使用 Python 进行编程。