依托 Parallel Web Search 进行接地

预览

此功能受服务专用条款的“通用服务条款”部分中的“非正式版产品条款”的约束。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

Parallel Web Systems 提供了一个搜索 API，可用于访问公开提供的网络数据，这些数据经过优化，可供大语言模型用于接地。本页介绍了如何使用 Parallel 来提供接地回答。

Gemini Enterprise Agent Platform 上的 Parallel 接地是一项单独的服务（如您的 Google Cloud 协议中所述），可将 Gemini 模型连接到 Parallel Web Systems 的搜索 API 提供的公开网络数据。这项服务可让 Gemini 访问数十亿个网页中的实时信息，从而确保回答更贴近事实且更及时。

注意： 对于网络发布商，在 Gemini Enterprise Agent Platform 上使用 Parallel 进行接地时，不会使用已禁止 ShapBot 的网页进行接地。网站发布商可以使用 robots.txt 文件管理其选择停用的内容。

使用场景

使用 Parallel 进行依据建立适用于以下用例：

• 使用网络数据来完成或扩充信息。
• 需要更深入的网页搜索来回答更复杂问题的多跳代理。
• 构建可集成网络搜索数据的 API。
• 面向员工的助理，可让最终用户使用最新的网络信息提出问题并创建复杂的报告。
• 面向消费者的应用，例如零售和旅游应用，可让用户做出明智的购买决策。
• 自主运行的自动化代理，用于执行新闻分析和 KYC 检查等自动化任务。
• 垂直领域的智能体（销售智能体、编码智能体、财务智能体）从网络获取最新的最新背景信息。

示例

谁赢得了 2025 年拉斯维加斯 F1 大奖赛？

无标准答案关联	带接地
2025 年拉斯维加斯大奖赛尚未举行。该赛事计划于 2025 年 11 月 20 日至 22 日的周末举行。 因此，获胜者未知。	2025 年拉斯维加斯 F1 大奖赛的获胜者是红牛车队的马克斯·维斯塔潘。比赛于 2025 年 11 月 22 日举行。 来源：domain1.com、domain2.com 等

支持的模型

以下模型支持依托 Parallel Web Search 进行接地：

• 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)

准备工作

如需使用“依托 Parallel Web Search 进行接地”，您必须设置访问权限。您有以下两种选择：

• 直接在 Google Cloud Marketplace 上订阅“基于并行网页搜索的 Grounding”（预览版），以便在现有云环境中实现简化的集成。对于敏感工作负载，我们还提供零数据保留方案。如需使用 ZDR，您必须订阅 ZDR 产品 并在 API 请求中设置相应的 enable_zero_data_retention 标志。

• 使用现有的 Parallel API 密钥。

在 Google Cloud Marketplace 上订阅（推荐）

预览

此功能受服务专用条款的“通用服务条款”部分中的“非正式版产品条款”的约束。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

通过 Google Cloud Marketplace 进行集成后，您可以在 Google Cloud中直接管理 Grounding with Parallel Web Search 服务。如需开始使用，请在 Google Cloud Marketplace 上订阅“基于并行网络搜索的接地”服务，接受服务条款，并查看价格。

注意： 当您在 Google Cloud Marketplace 上订阅“基于并行网络搜索的接地”功能时， Google Cloud 需要将某些数据（例如从原始用户提示中派生和重写的查询）发送到并行网络搜索进行处理。您对 Parallel Web Search 服务的使用受 Google Cloud Marketplace 上适用于 Parallel Web Search 的使用条款的约束。

自带 API 密钥

如果您希望单独管理 Parallel 结算和 API 访问权限，可以提供自己的 API 密钥。如需使用此方法，您需要从 Parallel 开发者平台获取 API 密钥。此 API 密钥直接用于向 Gemini 发送的 REST API 请求。

注意： 当您自带 API 密钥时，需要 Google Cloud 才能将某些数据（例如从原始用户提示中派生和重写的查询）发送到 Parallel Web Search 进行处理。使用 Parallel Web Search 服务时，您必须遵守 Parallel 使用条款和使用限制政策。

使用 Parallel 将 Gemini 回答接地

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

如果您在 Google Cloud Marketplace 上订阅了“Grounding with Parallel Web Search”（预览版），请验证用于订阅的结算账号在您的Google Cloud 项目中是否处于有效状态。

REST

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

• LOCATION：处理请求的区域。如需使用全球端点，请清除端点名称中的相应位置，并将资源位置配置为“global”。
• PROJECT_ID：您的 Google Cloud 项目 ID。
• MODEL_ID：要使用模型的 ID。
• TEXT：要发送给模型的文本提示。
• API_KEY：Parallel Web Search 的 API 密钥。如果您指定了 API 密钥，并且还订阅了 Google Cloud Marketplace 上的“通过并行网络搜索进行 Grounding”（预览版），则 API 密钥优先。
• ENABLE_ZERO_DATA_RETENTION：可选：切换到并行网页搜索的 ZDR 版本，以在敏感工作负载上启用零数据保留。设置为 true 可为您的请求使用 ZDR 产品。您必须订阅 ZDR 专用产品，这些请求才能成功。如果未指定，则默认为标准版本。ZDR 版本只能通过 Google Cloud Marketplace 获得。
• EXCLUDE_DOMAINS：可选：要从接地源中排除的网域列表。如果指定，则排除来自这些网域的来源。 可接受的值为域名 (www.example.com) 或以英文句点开头的域名扩展名（.gov、.edu、.co.uk）。您最多可以指定 200 个网域。
• INCLUDE_DOMAINS：可选：要纳入接地源的网域列表。如果指定，则会包含来自这些网域的来源。 可接受的值为域名 (www.example.com) 或以英文句点开头的域名扩展名（.gov、.edu、.co.uk）。您最多可以指定 200 个网域。
• MAX_CHARS_PER_RESULT：可选：每个搜索结果摘要中包含的最大字符数。如果未指定，则默认为 30000。允许的范围为 [1000, 100000]。
• MAX_CHARS_TOTAL：可选：所有搜索结果摘录的总字符数上限。如果未指定，则默认为 100000。 允许的范围为 [1000, 1000000]。
• MAX_RESULTS：可选：用于接地的搜索结果数量上限。如果未指定，则默认为 10。允许的范围为 [1, 20]。
• MODE：可选：用于请求的模式，可以是 basic 或 advanced。默认值为 basic。 如果您希望获得更全面的搜索结果，但愿意接受更高的延迟，请考虑使用 advanced 模式。
• SEARCH_LOCATION：可选：用于指定地理位置定位搜索结果的 ISO 3166-1 alpha-2 国家/地区代码。示例："us"。

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": [{
    "parallelAiSearch": {
        "api_key": "API_KEY",
        "enable_zero_data_retention": ENABLE_ZERO_DATA_RETENTION,
        "customConfigs": {
            "mode": "MODE",
            "location": "SEARCH_LOCATION",
            "max_results": MAX_RESULTS,
            "source_policy": {
                "exclude_domains": ["EXCLUDE_DOMAINS"],
                "include_domains": ["INCLUDE_DOMAINS"]
            },
            "excerpts": {
                "max_chars_per_result": MAX_CHARS_PER_RESULT,
                "max_chars_total": MAX_CHARS_TOTAL
            }
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

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

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

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

响应

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025. The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 77,
              "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          },
          {
            "segment": {
              "startIndex": 78,
              "endIndex": 198,
              "text": "The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 33,
    "candidatesTokenCount": 106,
    "totalTokenCount": 284,
    "billablePromptUsage": {
      "textCount": 142
    },
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 33
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 106
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 39
      }
    ],
    "toolUsePromptTokenCount": 39,
    "thoughtsTokenCount": 106
  },
  "modelVersion": "MODEL_VERSION",
  "createTime": "CREATE_TIME",
  "responseId": "RESPONSE_ID"
}

配额

默认配额为每分钟 200 个提示。如需申请提高速率限制，请向相应联系人提供您的使用情形和要求：

• 如果您在 Google Cloud Marketplace 上订阅了“基于并行网页搜索的 Grounding”功能（预览版）：请与您的 Google 客户支持团队联系。

• 如果您提供自己的 API 密钥：请联系 [e-mail] 和您的 Google 客户支持团队。

结算

使用“依托 Parallel Web Search 进行接地”功能会产生以下费用：

• Gemini token 消耗量：您可能会因以下情况而被收取费用：

  • 提示 token 数
  • 思考 token
  • 输出令牌

  如需了解详情，请参阅价格。

• Gemini 的数据接地功能：如需了解详情，请参阅价格。

• 使用 Parallel Web Search API 的价格：

  • 如果您在 Google Cloud Marketplace 上订阅了“使用 Parallel Web Search 进行知识库检索”功能（预览版），请参阅 Google Cloud Marketplace 上的并行定价部分，了解详情。

  • 如果您提供自己的 API 密钥，请参阅并行网站了解详情。