# 智能体概览

Gemini API 上的托管智能体为您提供可配置的智能体线束。单个 API 调用提供一个 Linux 沙箱，智能体在其中自主推理、执行代码、管理文件和浏览网页。

{% card-grid %}
{% card
   description="进行您的第一个智能体呼叫、流式传输响应并构建自定义智能体。"
   href="/docs/managed-agents-quickstart"
   icon="rocket_launch"
   title="快速入门" /%}

{% card
   description="功能、工具、多模态输入和定价默认智能体。"
   href="/docs/antigravity-agent"
   icon="smart_toy"
   title="Antigravity 智能体" /%}

{% card
   description="无需编写代码即可制作智能体原型的可视化游乐场。"
   href="/docs/aistudio-agents"
   icon="experiment"
   title="AI Studio中的智能体" /%}
{% /card-grid %}

## 可用托管智能体  {% #managed-agents %}

* **[Antigravity 智能体](/docs/antigravity-agent)**：用 Gemini 4 Hydrogen 构建的通用托管智能体。在 Google 托管的安全 Linux 沙箱中运行代码、管理文件和搜索网络。您可以用自己的指令、技能和数据对其进行扩展 [构建自定义智能体](/docs/custom-agents).

* **[Deep Research](/docs/deep-research)**：自主研究智能体，可为市场分析、尽职调查和文献综述等用例规划、执行和综合多步骤研究任务。

## 安全和最佳实践  {% #security-best-practices %}

{% callout type="note" %}
注意：托管智能体位于 **公开预览**。在敏感工作流程中依赖智能体的操作和输出之前，请先检查它们。
{% /callout %}

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

### 网络接入  {% #network-access %}

默认情况下，环境具有不受限制的出站网络访问。使用一个 `network` 白名单将出站流量限制到特定域或通配符模式。详细配置请参见 [网络允许列表](/docs/aistudio-agents#network-allow-list) （人工智能工作室）或 [网络规则](/docs/custom-agents#with-network-rules)
（API）。

### 外部工具和 API  {% #external-tools-and-apis %}

您可以连接外部工具和API来扩展智能体。仅使用来自受信任来源的工具并将权限范围限制在所需的最低限度。将机密存储为托管凭据并通过 ID 引用它们，因此出口代理在请求时注入它们，并且它们永远不会暴露在沙箱内。 智能体可以使用它有权访问的任何凭证，因此仅提供您愿意授予其完整范围的凭证。

* 使用最低权限服务帐户或 API 密钥。
* 与长寿命密钥相比，更喜欢短寿命 token。
* 仅提供您愿意授予其全部范围的凭据。
* 定期轮换凭证。

凭证类型及管理操作请参见 [凭证](/docs/agent-credentials)。您还可以在允许列表规则上内嵌设置标头，请参阅 [网络配置](/docs/agent-environment#network-configuration).

### 人为监督  {% #human-oversight %}

在部署输出（生成的代码、数据转换、配置更改）之前始终验证它们，特别是对于修改数据或与外部系统交互的任务。

## 价格  {% #pricing %}

托管智能体使用 [现收现付模式](/docs/pricing#pricing-for-agents) 基于Gemini模型token和工具使用。一次交互可以触发多个推理循环，通常消耗 100k 到 3M token。环境计算是 **未计费** 在预览期间。参见 [预计费用](/docs/antigravity-agent#availability-and-pricing) 对于每个任务的细分。

## 限制  {% #limits %}

| 限制        | 说明                                                                                                                   |
| --------- | -------------------------------------------------------------------------------------------------------------------- |
| **环境寿命**  | 在 7 天不活动后，环境将被永久删除。                                                                                                  |
| **虚拟机降速** | 虚拟机在短暂不活动后会关闭以节省资源。下一个请求恢复状态（冷启动）。                                                                                   |
| **预装软件**  | 基于 Ubuntu 的环境，使用 Python 3.12 和 Node.js 22. 有关环境基础映像的更多信息，请参阅 [预装软件](/docs/agent-environment#pre-installed-software). |
| **最大智能体** | 您最多可以拥有 1,000 托管智能体。                                                                                                 |

## 智能体框架  {% #agent-frameworks %}

您还可以使用以下框架和 SDK 来构建智能体和 Gemini：

* [**LangChain / LangGraph**](/docs/langgraph-example)：使用图结构构建有状态、复杂的应用程序流和多智能体系统。

* [**LlamaIndex**](/docs/llama-index)：将 Gemini 智能体连接到您的私人数据，以实现 RAG 增强的工作流程。

* [**CrewAI**](/docs/crewai-example)：协调协作、角色扮演的自主 AI 智能体。

* [**Vercel AI SDK**](/docs/vercel-ai-sdk-example)：使用 JavaScript/TypeScript 构建人工智能驱动的用户界面和智能体。

* [**谷歌ADK**](https://google.github.io/adk-docs/get-started/python/)：用于构建和编排可互操作的 AI 智能体的开源框架。

* [**元基特**](https://genkit.dev)：使用 TypeScript、Go、Python 和 Dart 构建全栈 AI 应用程序和智能体。

* [**Antigravity SDK**](https://antigravity.google/product/antigravity-sdk)：使用与 Google Antigravity 相同的工具、智能体循环和上下文管理来构建自主 AI 智能体，并可通过 Python 进行编程。
