Parallel Web Systems 提供搜尋 API，可存取公開網路資料，並經過最佳化處理，方便大型語言模型做為基準。本頁說明如何使用 Parallel，根據特定資料來源生成 Gemini 回覆。
在 Gemini Enterprise Agent Platform 上使用 Parallel 建立基準是獨立的服務 (如 Google Cloud 合約中所定義)，可將 Gemini 模型連結至 Parallel Web Systems 的搜尋 API 提供的公開網路資料。這項服務可讓 Gemini 存取數十億個網頁的即時資訊，確保回覆內容更符合事實且貼近現況。
用途
使用 Parallel 建立基準適用於下列用途：
- 使用網路資料完成或豐富資訊。
- 需要進行更深入的網路搜尋，才能回答較複雜問題的多跳代理程式。
- 建構整合網頁搜尋資料的 API。
- 員工專用助理，可讓使用者提問及使用最新網路資訊建立複雜報表。
- 面向消費者的應用程式，例如零售和旅遊，可讓使用者做出明智的購買決策。
- 自動代理會自主執行自動化工作，例如新聞分析和 KYC 檢查。
- 垂直領域的代理程式 (銷售代理、程式設計代理、財務代理) 從網路上取得最新資訊。
範例
2025 年拉斯維加斯 F1 大獎賽的冠軍是誰？
| 沒有連結 | 含接地線 |
|---|---|
| 2025 年的拉斯維加斯大獎賽尚未舉行，這場賽事預計於 2025 年 11 月 20 日至 22 日的週末舉行。因此我們無法得知得主。 | 2025 年拉斯維加斯 F1 大獎賽的冠軍是 Red Bull Racing 的 Max Verstappen。賽事於 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 with Parallel Web Search，在現有雲端環境中簡化整合程序。您也可以為機密工作負載選擇零資料保留方案。如要使用 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 訂閱「利用平行網頁搜尋建立基準」服務、接受服務條款，並查看定價。
自備 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 訂閱 Grounding with Parallel Web Search，請確認訂閱使用的帳單帳戶在Google Cloud 專案中處於有效狀態。
執行範例前，請先完成先決條件，包括在 Google Cloud Marketplace 訂閱或提供 Parallel API 金鑰。
每個 SDK 範例都會從分頁中顯示的環境變數讀取專案和位置。在程式碼範例中，請將 MODEL_ID 替換為支援的模型 ID，例如 gemini-2.5-flash。
控制台
如要使用 Gemini Enterprise Agent Platform 的 Agent Studio，透過平行網頁搜尋功能建立 Gemini 回覆的基準，請按照下列步驟操作：
前往 Google Cloud 控制台的「Agent Studio」頁面。
在側邊面板的「模型設定」下方，開啟「基準建立」部分的「合作夥伴」切換鈕 (「基準建立合作夥伴的搜尋結果」)。
選取「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
from google import genai
from google.genai import types
client = genai.Client()
response = client.models.generate_content(
model="MODEL_ID",
contents="Who won the 2025 Las Vegas F1 Grand Prix?",
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. Otherwise,
# provide your Parallel API key.
# api_key="API_KEY",
# Optional. Customize the search. See the REST tab for the
# full list of supported parameters. Keys inside custom_configs
# are Parallel.ai Search API params (snake_case).
custom_configs={
"mode": "basic",
"max_results": 10,
"source_policy": {"include_domains": ["wikipedia.org"]},
},
)
)
],
),
)
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)
如要自訂搜尋，請設定 ToolParallelAiSearch 的 custom_configs 欄位。這個欄位接受 REST 分頁中說明的相同選用參數，例如 source_policy、excerpts、max_results 和 mode。
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
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(
// Omit apiKey if you subscribed to Grounding with Parallel Web
// Search on Google Cloud Marketplace. Otherwise, set apiKey to
// your Parallel API key.
Tool.builder()
.parallelAiSearch(
ToolParallelAiSearch.builder()
// Optional. Customize the search. See the REST tab
// for the full list of supported parameters. Keys
// inside customConfigs are Parallel.ai Search API
// params (snake_case).
.customConfigs(
Map.of(
"mode", "basic",
"max_results", 10,
"source_policy",
Map.of(
"include_domains",
List.of("wikipedia.org"))))
.build())
.build())
.build();
GenerateContentResponse response =
client.models.generateContent(
"MODEL_ID", "Who won the 2025 Las Vegas F1 Grand Prix?", config);
System.out.println(response.text());
}
}
}
如要自訂搜尋，請設定 ToolParallelAiSearch 的 customConfigs 欄位。這個欄位接受 REST 分頁中說明的相同選用參數，例如 source_policy、excerpts、max_results 和 mode。
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
import {GoogleGenAI} from '@google/genai';
const ai = new GoogleGenAI({});
const response = await ai.models.generateContent({
model: 'MODEL_ID',
contents: 'Who won the 2025 Las Vegas F1 Grand Prix?',
config: {
tools: [
// Omit apiKey if you subscribed to Grounding with Parallel Web Search on
// Google Cloud Marketplace. Otherwise, set apiKey to your Parallel API key.
{
parallelAiSearch: {
// Optional. Customize the search. See the REST tab for the full
// list of supported parameters. Keys inside customConfigs are
// Parallel.ai Search API params (snake_case).
customConfigs: {
mode: 'basic',
max_results: 10,
source_policy: {include_domains: ['wikipedia.org']},
},
},
},
],
},
});
console.log(response.text);
如要自訂搜尋，請設定 parallelAiSearch 工具的 customConfigs 欄位。這個欄位接受 REST 分頁中說明的相同選用參數，例如 source_policy、excerpts、max_results 和 mode。
REST
使用任何要求資料之前，請先修改下列項目的值：
- LOCATION：處理要求的區域。如要使用全域端點，請從端點名稱中排除位置，並將資源位置設為「global」。
- PROJECT_ID： Google Cloud 專案 ID。
- MODEL_ID：要使用的模型 ID。
- TEXT：要傳送至模型的文字提示詞。
- API_KEY：平行網頁搜尋的 API 金鑰。如果您指定 API 金鑰，且已在 Google Cloud Marketplace 訂閱「Grounding with Parallel Web Search」，系統會優先使用 API 金鑰。
- ENABLE_ZERO_DATA_RETENTION：選用：切換至 Parallel Web Search 的 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"
}
請展開以下其中一個選項，以傳送要求：
您應該會收到類似如下的 JSON 回應。
配額
預設配額為每分鐘 200 個提示。如要申請調高速率限制，請向適當的聯絡人提供用途和需求：
如果您是透過 Google Cloud Marketplace 訂閱「以平行網頁搜尋為基礎」功能：請與 Google 帳戶團隊聯絡。
如果您提供自己的 API 金鑰：請與 support@parallel.ai 和 Google 帳戶團隊聯絡。
帳單
使用「以 Parallel Web Search 建立基準」功能時，會產生下列費用：
Gemini 權杖用量：系統可能會針對下列項目向您收費：
- 提示詞詞元
- 思考詞元
- 輸出內容詞元
詳情請參閱這篇文章，瞭解定價相關資訊。
Gemini 根據您的資料進行基礎訓練：詳情請參閱定價。
使用 Parallel Web Search API 的定價：
如果您是透過 Google Cloud Marketplace 訂閱 Grounding with Parallel Web Search，請參閱 Google Cloud Marketplace 的「Parallel 定價」部分，瞭解詳情。
如果您提供自己的 API 金鑰，請參閱平行網站瞭解詳情。