依托 Exa Web Search 进行接地

Exa 提供了一个搜索 API,可让您访问公开的网络数据,这些数据经过优化,可用于将大型语言模型回答接地。本页介绍了如何使用 Exa 将 Gemini 回答接地。

在 Gemini Enterprise Agent Platform 上使用 Exa 网络搜索进行接地是一项单独的产品(如您的 Google Cloud 协议中所定义),它将 Gemini 模型连接到 Exa 的搜索 API 提供的公开网络数据。

使用场景

通过让模型访问最新的相关网络数据,使用 Exa 进行接地可以提高准确性并减少幻觉。常见用例包括:

  • 通用智能体和聊天机器人:检索最新信息,生成更可靠的回答。
  • 研究智能体:跨多个来源进行深入的深网研究。
  • 编码智能体:提取最新的代码段、文档和技术参考资料。
  • 语音智能体:网络检索,支持实时、低延迟的语音交互。
  • 垂直领域专用智能体:提取针对特定行业或知识垂直领域量身定制的最新领域专用信息。
  • 数据扩充:使用当前网络上下文和元数据扩充内部数据集。
  • 自动化工作流:定期收集新闻、人物、公司或其他经常更新的数据,用于内部或生产工作流。

示例

谁赢得了 2026 年超级碗?

不接地 接地
我无法告诉您谁赢得了 2026 年超级碗,因为该赛事尚未举行。 西雅图海鹰队在 2026 年 2 月 8 日举行的第 60 届超级碗中以 29 比 13 的比分击败新英格兰爱国者队。 来源 :domain1.com、domain2.com,...

支持的模型

以下模型支持使用 Exa 进行接地:

  • Gemini 2.5 Flash (gemini-2.5-flash)
  • Gemini 2.5 Flash-Lite (gemini-2.5-flash-lite)
  • Gemini 2.5 Pro (gemini-2.5-pro)
  • Gemini 3.1 Pro (gemini-3.1-pro-preview)
  • Gemini 3.1 Flash Lite (gemini-3.1-flash-lite)
  • Gemini 3.5 Flash (gemini-3.5-flash)

准备工作

如需使用 Exa 进行接地,您需要从 Exa 的网站获取 API 密钥。此 API 密钥将在您向 Gemini 发出的请求中使用。

使用 Exa 将 Gemini 回答接地

如需从 Gemini 请求接地回答,请按如下所示使用 REST API。为了获得最佳性能,我们建议您对可选参数使用默认设置,除非您严格要求使用非默认值。

REST

在使用任何请求数据之前,请先进行以下替换:

  • LOCATION:处理请求的区域。如需使用 全球端点,请清除端点名称中的相应位置,并将资源位置配置为 `global`。
  • PROJECT_ID:您的 Google Cloud 项目 ID。
  • MODEL_ID:要使用模型的 ID。
  • TEXT:要发送给模型的文本提示。
  • API_KEY:您的 Exa 网络搜索 API 密钥。
  • SEARCH_TYPE:可选:要运行的 Exa 搜索类型。有效值为 auto(默认值)和 fastfast 以较低的延迟运行,但搜索结果不够全面。
  • EXCLUDE_DOMAINS:可选:要从搜索结果中排除的网域列表。如果指定了此项,则不会返回来自这些网域的结果。 您最多可以指定 1200 个网域。
  • INCLUDE_DOMAINS:可选:要包含在搜索中的网域列表。如果指定了此项,则结果将仅来自这些网域。 您最多可以指定 1200 个网域。
  • MAX_CHARACTERS:可选:要为突出显示内容返回的最大字符数 。控制每个网址返回的突出显示文本的总长度。
  • NUM_RESULTS:可选:用于接地的最大搜索结果数。如果未指定,则默认为 5

HTTP 方法和网址:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

请求 JSON 正文:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "exaAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "type": "SEARCH_TYPE",
            "excludeDomains": ["EXCLUDE_DOMAINS"],
            "includeDomains": ["INCLUDE_DOMAINS"],
            "contents": {
                "highlights": {
                    "maxCharacters": MAX_CHARACTERS
                }
            },
            "numResults": NUM_RESULTS
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

如需发送您的请求,请展开以下选项之一:

您应该收到类似以下内容的 JSON 响应。

Quota

默认配额是每分钟 200 个提示。如果您需要提高速率限制,请将您的使用场景和要求发送至 support@exa.ai 并抄送给您的 Google 客户支持团队。

结算

使用 Exa 进行接地会产生以下费用:

  • Gemini token 消耗:提示 token、思考 token、输出 token。如需了解详情,请参阅价格
  • Gemini 的“利用数据进行接地”:如需了解详情,请参阅价格
  • 使用 Exa 搜索 API 的价格:如需了解详情,请参阅Exa 的价格页面