Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

以 Parallel Web Search 建立基準

Parallel Web Systems 提供搜尋 API，可存取公開網路資料，並針對大型語言模型的基準化作業進行最佳化。本頁說明如何使用 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 大獎賽的冠軍是 Red Bull Racing 車隊的 Max Verstappen。這場比賽於 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 回覆基準

如要取得 Gemini 建立基準的回覆，請使用 Google Cloud 控制台中的 Agent Studio、Google Gen AI SDK 或 REST API。為獲得最佳效能，建議您對選用參數使用預設設定，除非您確實需要非預設值。

如果您是透過 Google Cloud Marketplace 訂閱「Grounding with Parallel Web Search」，請確認訂閱時使用的帳單帳戶在Google Cloud 專案中處於有效狀態。

執行範例前，請先完成必要條件，包括在 Google Cloud Marketplace 訂閱或提供 Parallel API 金鑰。

控制台

如要在 Gemini Enterprise Agent Platform 使用 Agent Studio，透過平行網頁搜尋建立 Gemini 回覆的基準，請按照下列步驟操作：

前往 Google Cloud 控制台的「Agent Studio」頁面。

前往 Agent Studio
在側邊面板的「模型設定」下方，開啟「基準」部分的「合作夥伴」切換鈕 (「基準建立合作夥伴的搜尋結果」)。
選取「Parallel Web Search」做為建立基準合作夥伴，然後按一下「Apply」(套用)。如要使用 Parallel Web Search，請先在 Google Cloud Marketplace 訂閱。
在文字方塊中輸入提示詞並提交。

提示回覆現在會使用 Parallel Web Search 建立基準。

Python

安裝

pip install --upgrade google-genai

詳情請參閱 SDK 參考文件。

設定環境變數，透過 Vertex AI 使用 Google Gen AI SDK：

# 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 參考文件。

設定環境變數，以便透過 Vertex AI 使用 Google Gen AI SDK：

# 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 參考文件。

設定環境變數，以便透過 Vertex AI 使用 Google Gen AI SDK：

# 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：選用：切換至 Parallel Web Search 的 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 訂閱了 Grounding with Parallel Web Search：請與 Google 帳戶團隊聯絡。
如果您提供自己的 API 金鑰：請與 support@parallel.ai 和 Google 帳戶團隊聯絡。

帳單

使用「以 Parallel Web Search 建立基準」功能時，會產生下列費用：

Gemini 詞元用量：您可能需要支付以下費用：
- 提示詞詞元
- 思考詞元
- 輸出內容詞元
詳情請參閱這篇文章，瞭解定價相關資訊。
Gemini 建立基準時使用的資料：詳情請參閱定價。
使用 Parallel Web Search API 的定價：
- 如果您是透過 Google Cloud Marketplace 訂閱「以 Parallel Web Search 建立基準」功能，請參閱 Google Cloud Marketplace 上的「Parallel 定價」部分，瞭解詳情。
- 如果您提供自己的 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 建立基準