Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

依托 Parallel Web Search 进行接地

Parallel Web Systems 提供了一个搜索 API，可用于访问公开提供的 Web 数据，这些数据已经过优化，可供大语言模型用于建立依据。本页面介绍了如何使用 Parallel 为 Gemini 回答提供依据。

Gemini Enterprise Agent Platform 上的 Grounding with Parallel 是一项单独的产品/服务（如 Google Cloud 协议中所定义），可将 Gemini 模型连接到 Parallel Web Systems 的搜索 API 提供的公开网络数据。此服务让 Gemini 能够访问数十亿个网页中的实时信息，从而确保回答更具时效性且更符合事实。

使用场景

并行接地适用于以下应用场景：

将网页数据用于信息补全或丰富目的。
需要进行更深入的网页搜索以回答更复杂问题的多跃点智能体。
构建一个集成网页搜索数据的 API。
面向员工的助理，可让最终用户使用最新的网络信息提出问题并创建复杂的报告。
面向消费者的应用（例如零售和旅游应用），可让用户做出明智的购买决策。
自主运行以执行自动化任务（例如新闻分析和 KYC 检查）的自动化智能体。
垂直领域智能体（销售智能体、编程智能体、金融智能体）从网络获取最新上下文。

示例

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

无依据	带接地
2025 年拉斯维加斯大奖赛尚未举行。比赛定于 2025 年 11 月 20 日至 22 日的周末举行。因此，胜出者未知。	2025 年拉斯维加斯 F1 大奖赛的冠军是红牛车队的马克斯·维斯塔潘。比赛于 2025 年 11 月 22 日举行。来源：domain1.com、domain2.com、…

支持的模型

本部分列出了支持“依托 Parallel 网页搜索进行接地”的模型。

点击即可展开支持的模型

准备工作

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

直接在 Google Cloud Marketplace 上订阅 Grounding with Parallel Web Search，以便在现有云环境中实现简化集成。此外，我们还针对敏感工作负载提供零数据保留服务。如需使用 ZDR，您必须订阅 ZDR 产品，并在 API 请求中设置相应的 enable_zero_data_retention 标志。
使用现有的 Parallel API 密钥。

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

自带 API 密钥

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

使用 Parallel 将 Gemini 回答接地

在 Google Cloud 控制台中使用 Agent Studio、Google Gen AI SDK 或 REST API，向 Gemini 请求接地回答。为获得最佳性能，我们建议您对可选参数使用默认设置，除非您严格要求使用非默认值。

如果您在 Google Cloud Marketplace 上订阅了“使用并行网页搜索进行接地”，请验证用于订阅的结算账号在您的Google Cloud 项目中处于活跃状态。

在运行示例之前，请先完成前提条件，包括在 Google Cloud Marketplace 上订阅或提供 Parallel API 密钥。

控制台

如需使用 Gemini Enterprise Agent Platform 上的 Agent Studio 通过并行网页搜索为 Gemini 回答建立依据，请按照以下步骤操作：

在 Google Cloud 控制台中，前往 Agent Studio 页面。

前往 Agent Studio
在侧边栏中的模型设置下，在接地部分中，开启合作伙伴切换开关（来自接地合作伙伴的搜索结果）。
选择并行网页搜索作为接地合作伙伴，然后点击应用。如需使用 Parallel Web Search，您必须先在 Google Cloud Marketplace 上订阅该服务。
在文本框中输入提示，然后提交。

您的提示回答现在会使用“依托 Parallel Web Search 进行接地”功能。

Python

安装

pip install --upgrade google-genai

如需了解详情，请参阅 SDK 参考文档。

设置环境变量以将 Google Gen AI SDK 与 Vertex AI 搭配使用：

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

在运行示例之前，请先进行以下替换：

MODEL_ID：要使用的受支持模型的 ID，例如 gemini-2.5-flash。
TEXT：要发送给模型的文本提示词。
API_KEY：您的 Parallel Web Search API 密钥。如果您已在 Google Cloud Marketplace 上订阅，请省略此参数；如果同时提供了这两个参数，则 API 密钥优先。
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"。

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="TEXT",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                parallel_ai_search=types.ToolParallelAiSearch(
                    # Optional. Omit api_key if you subscribed to Grounding with
                    # Parallel Web Search on Google Cloud Marketplace.
                    api_key="API_KEY",
                    # Optional. Set to True to use Zero Data Retention (ZDR) for
                    # sensitive workloads. Requires a separate ZDR Marketplace
                    # subscription; defaults to the standard subscription.
                    enable_zero_data_retention=True,
                    # Optional. Customize the search. Click a placeholder to
                    # enter a value, or remove the line to accept the default.
                    custom_configs={
                        "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,
                        },
                    },
                )
            )
        ],
    ),
)

print(response.text)
# Example response:
# Max Verstappen won the 2025 Las Vegas F1 Grand Prix ...

# The grounding metadata contains the web sources used to ground the response.
print(response.candidates[0].grounding_metadata.grounding_chunks)

Java

了解如何安装或更新 Java。

如需了解详情，请参阅 SDK 参考文档。

设置环境变量以将 Google Gen AI SDK 与 Vertex AI 搭配使用：

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

在运行示例之前，请先进行以下替换：

MODEL_ID：要使用的受支持模型的 ID，例如 gemini-2.5-flash。
TEXT：要发送给模型的文本提示词。
API_KEY：您的 Parallel Web Search API 密钥。如果您已在 Google Cloud Marketplace 上订阅，请省略此参数；如果同时提供了这两个参数，则 API 密钥优先。
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"。

import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.Tool;
import com.google.genai.types.ToolParallelAiSearch;
import java.util.List;
import java.util.Map;

public class ParallelGroundingSample {
  public static void main(String[] args) {
    try (Client client = Client.builder().build()) {

      GenerateContentConfig config =
          GenerateContentConfig.builder()
              .tools(
                  Tool.builder()
                      .parallelAiSearch(
                          ToolParallelAiSearch.builder()
                              // Optional. Omit apiKey if you subscribed to
                              // Grounding with Parallel Web Search on Google
                              // Cloud Marketplace.
                              .apiKey("API_KEY")
                              // Optional. Set to true to use Zero Data
                              // Retention (ZDR) for sensitive workloads.
                              // Requires a separate ZDR Marketplace
                              // subscription; defaults to the standard
                              // subscription.
                              .enableZeroDataRetention(true)
                              // Optional. Customize the search. Click a
                              // placeholder to enter a value, or remove the
                              // entry to accept the default.
                              .customConfigs(
                                  Map.of(
                                      "mode", "MODE",
                                      "location", "SEARCH_LOCATION",
                                      "max_results", MAX_RESULTS,
                                      "source_policy",
                                      Map.of(
                                          "exclude_domains",
                                          List.of("EXCLUDE_DOMAINS"),
                                          "include_domains",
                                          List.of("INCLUDE_DOMAINS")),
                                      "excerpts",
                                      Map.of(
                                          "max_chars_per_result",
                                          MAX_CHARS_PER_RESULT,
                                          "max_chars_total",
                                          MAX_CHARS_TOTAL)))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "TEXT", config);

      System.out.println(response.text());
    }
  }
}

Node.js

安装

npm install @google/genai

如需了解详情，请参阅 SDK 参考文档。

设置环境变量以将 Google Gen AI SDK 与 Vertex AI 搭配使用：

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

在运行示例之前，请先进行以下替换：

MODEL_ID：要使用的受支持模型的 ID，例如 gemini-2.5-flash。
TEXT：要发送给模型的文本提示词。
API_KEY：您的 Parallel Web Search API 密钥。如果您已在 Google Cloud Marketplace 上订阅，请省略此参数；如果同时提供了这两个参数，则 API 密钥优先。
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"。

import {GoogleGenAI} from '@google/genai';

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'TEXT',
  config: {
    tools: [
      {
        parallelAiSearch: {
          // Optional. Omit apiKey if you subscribed to Grounding with Parallel
          // Web Search on Google Cloud Marketplace.
          apiKey: 'API_KEY',
          // Optional. Set to true to use Zero Data Retention (ZDR) for
          // sensitive workloads. Requires a separate ZDR Marketplace
          // subscription; defaults to the standard subscription.
          enableZeroDataRetention: true,
          // Optional. Customize the search. Click a placeholder to enter a
          // value, or remove the line to accept the default.
          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,
            },
          },
        },
      },
    ],
  },
});

console.log(response.text);

REST

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

LOCATION：处理请求的区域。如需使用全球端点，请清除端点名称中的相应位置，并将资源位置配置为 `global`。
PROJECT_ID：您的 Google Cloud 项目 ID。
MODEL_ID：要使用的受支持模型的 ID，例如 gemini-2.5-flash。
TEXT：要发送给模型的文本提示词。
API_KEY：您的 Parallel Web Search API 密钥。如果您已在 Google Cloud Marketplace 上订阅，请省略此参数；如果同时提供了这两个参数，则 API 密钥优先。
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"。
ENABLE_ZERO_DATA_RETENTION：可选：切换到并行网页搜索的 ZDR 版本，以便在敏感工作负载上启用零数据保留。设置为 true，以便在请求中使用 ZDR 产品。您必须订阅 ZDR 专用产品，这些请求才能成功。如果未指定，则默认为标准版本。ZDR 版本只能通过 Google Cloud Marketplace 获取。

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 上订阅了“使用并行网页搜索进行接地”功能：请与您的 Google 客户支持团队联系。
如果您提供自己的 API 密钥：请联系 support@parallel.ai 和您的 Google 客户支持团队。

结算

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

Gemini token 消耗量：您可能需要为以下内容付费：
- 提示 token 数
- 思考 Token
- 输出 token 数
如需了解详情，请参阅价格。
Gemini 的“利用数据进行接地”功能：如需了解详情，请参阅价格。
使用 Parallel Web Search API 的价格：
- 如果您在 Google Cloud Marketplace 上订阅了“使用 Parallel Web Search 进行接地”，请参阅 Google Cloud Marketplace 上的并行价格部分，了解更多信息。
- 如果您提供自己的 API 密钥，请参阅并行网站了解详情。

依托 Parallel Web Search 进行接地 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

使用场景

支持的模型

点击即可展开支持的模型

准备工作

在 Google Cloud Marketplace 上订阅（推荐）

自带 API 密钥

使用 Parallel 将 Gemini 回答接地

控制台

Python

安装

Java

Node.js

安装

REST

curl（Linux、macOS 或 Cloud Shell）

PowerShell (Windows)

响应

配额

结算

依托 Parallel Web Search 进行接地