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 グランプリの優勝者は、レッドブル レーシングのマックス フェルスタッペンでした。レースは 2025 年 11 月 22 日に開催されました。ソース: domain1.com、domain2.com、... |
サポートされているモデル
パラレルウェブ検索によるグラウンディングは、次のモデルでサポートされています。
- 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）
始める前に
パラレルウェブ検索によるグラウンディングを使用するには、アクセス権を設定する必要があります。次の 2 つのオプションがあります。
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 で Grounding with Parallel Web Search サービスに登録し、利用規約に同意して、料金を確認します。
独自の 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 は gemini-2.5-flash などのサポートされているモデル ID に置き換えます。
コンソール
Gemini Enterprise Agent Platform の Agent Studio を使用して、並列ウェブ検索で Gemini のレスポンスをグラウンディングする手順は次のとおりです。
Google Cloud コンソールで、[Agent Studio] ページに移動します。
サイドパネルの [モデル設定] の [グラウンディング] セクションで、[パートナー] 切り替えボタン（グラウンディング パートナーからの検索結果）をオンにします。
グラウンディング パートナーとして [Parallel Web Search] を選択し、[適用] をクリックします。Parallel Web Search を使用するには、まず Google Cloud Marketplace でサブスクライブする必要があります。
テキスト ボックスにプロンプトを入力して送信します。
プロンプトのレスポンスで、パラレルウェブ検索によるグラウンディングが使用されるようになりました。
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 バージョンに切り替えて、機密性の高いワークロードでゼロ データ保持を有効にします。リクエストに ZDR オファリングを使用する場合は、
trueに設定します。これらのリクエストを成功させるには、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 メソッドと URL:
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 レスポンスが返されます。
割り当て
デフォルトの割り当ては 1 分あたり 200 件のプロンプトです。レート上限の引き上げをリクエストするには、ユースケースと要件を適切な連絡先にお知らせください。
Google Cloud Marketplace で Grounding with Parallel Web Search を定期購入している場合: Google アカウント チームにお問い合わせください。
独自の API キーを提供する場合: support@parallel.ai と Google アカウント チームにお問い合わせください。
課金
パラレルウェブ検索によるグラウンディングを使用すると、次の料金が発生します。
Gemini トークンの使用量: 次の料金が発生する可能性があります。
- プロンプト トークン
- 思考トークン
- 出力トークン
詳細は、料金をご覧ください。
Gemini の独自のデータによるグラウンディング: 詳細については、料金をご覧ください。
Parallel Web Search API の使用料金: