Gemini API 的网址上下文工具现已正式推出

2025年8月18日

Alisa Fortin Product Manager

从今天开始，网址上下文工具现已准备好投入大规模生产使用，并且新增了许多功能。该工具使开发者能够以网址的形式为模型提供额外的上下文，而不是手动上传内容，从而开发出更强大且具有上下文感知功能的生成式 AI 应用。

默认情况下，Gemini 模型具有静态知识库，并且无法直接访问互联网。Grounding with Google Search 将模型连接到网络，以实现广泛的实时发现。对于更深入的分析，网址上下文工具不再局限于搜索片段，而是能够让模型提取特定网页的全部内容并进行推理。这种强大的组合（使用搜索功能发现信息，再借助网址上下文工具进行分析）是处理复杂多步骤任务的基础。

通过扩展内容支持提高多功能性

此次发布的网址上下文工具极大地扩展了可作为提示词依据的内容类型，使其在更广泛的应用中具有更高的多功能性。现在的支持包括：

PDF 支持：您现在可以提供 PDF 的直接链接，使 Gemini 不仅可以提取文本，还可以理解表格及其中的整体结构，从而使报告、论文和手册等资料能够完全被利用起来作为参考依据。

图像支持：该工具现在可以处理和分析图像，包括 PNG、JPEG、BMP 和 WebP 格式的图像。它还利用 Gemini 的多模态功能来理解视觉信息，从而为分析图表、图等内容提供了便利。

Web 和数据文件：继续为标准网页 (HTML)、结构化数据（JSON、XML、CSV）和文本文件（纯文本、RTF、CSS、JavaScript）提供强大的支持。

为适应生产规模做好准备

为了确保您可以在应用中使用这些扩展功能，网址上下文工具现已准备好用于大规模生产环境，并且更新了限制和定价。速率限制现在基于您选择的特定 Gemini 模型，使得规模能够得到大幅扩展。您需要按照模型的标准费率为上下文中新增的输入令牌付费。这样一来，您的费用就会变得清晰且可预测。

解锁全新用例

网址上下文工具为开发者提供了众多的代理工作流选项。以下仅是您现在能够构建的一些用例：

个性化客户互动：让 AI 聊天代理以客户的网页为基础，使其能够为查询提供准确且相关的答案。

比较文档：分析多份报告、文章或 PDF，以识别差异并跟踪趋势。

合成和创建内容：组合来自多个源网址的信息，以生成准确的摘要、博文或报告。

分析代码和文档：指向 GitHub 存储库或技术文档，以解释代码、生成设置说明或回答技术问题。

网址上下文工具的实际应用

我们已经看到开发者使用网址上下文工具构建了令人惊叹的内容。以下是一些真实世界的示例：

Gemini CLI：Gemini CLI 是一种开源 AI 代理，让用户可以直接在终端中访问 Gemini，使用网址上下文工具来获取 web-fetch 命令，使开发者能够快速轻松地与 Web 内容进行交互，适用于总结网页内容、提取关键信息，甚至是将网页内容翻译成另一种语言等用例。

Gemini CLI 中的 Web 内容提取工具

Gladly.ai：客户服务平台 Gladly 使用网址上下文工具创建高度个性化的客户体验。通过提供客户网站的链接，基于 Gladly 的 AI 平台构建的代理可以访问和理解最新的产品信息、促销和支持文章，并能够为客户查询提供更准确、更相关的答案。

立即开始体验吧

准备好使用网址上下文工具开始构建了吗？以下是一个入门示例：

from google import genai
from google.genai.types import Tool, GenerateContentConfig
client = genai.Client()
 
model_id = "gemini-2.5-flash"
tools = [
     {"url_context": {}},
 ]
 
 
response = client.models.generate_content(
    model=model_id,
    contents="根据 https://ai.google.dev/gemini-api/docs/changelog，Gemini API 最近的三大公告内容是什么",
    config=GenerateContentConfig(
        tools=tools,
    )
)
for each in response.candidates[0].content.parts:
   print(each.text)

Python

转到网址上下文文档以了解更多信息并查看代码示例。通过我们的迷你演示应用查看具体操作，或在 Google AI Studio 中的“工具”下找到网址上下文的切换开关以亲自体验。

我们热切期待看到您的杰作！

发布于：

下一步