Parallel Web Systems は、グラウンディング用に大規模言語 モデルで使用できるように最適化された、一般公開されているウェブデータに アクセスできる検索 API を提供しています。このページでは、Parallel を使用して Gemini のレスポンスをグラウンディングする方法について説明します。
Gemini Enterprise Agent Platform での Parallel によるグラウンディングは、Gemini モデルを Parallel Web Systems の検索 API が提供する公開 ウェブデータに接続する別のサービス（お客様の 契約 Google Cloud で定義されているとおり）です。 このサービスにより、Gemini は数十億のウェブページからライブ情報にアクセスし、より最新で事実に基づいたレスポンスを生成できます。
ユースケース
Parallel によるグラウンディングは、次のようなユースケースに適しています。
- 情報の補完や拡充を目的としたウェブデータの使用。
- より複雑な質問に対して、より深いウェブ検索を必要とするマルチホップ エージェント。
- ウェブ検索データを統合する API の構築。
- エンドユーザーが最新のウェブ情報を使用して質問し、複雑なレポートを作成できる従業員向けアシスタント。
- ユーザーが十分な情報に基づいて購入を決定できる、小売や旅行などの消費者向けアプリケーション。
- ニュース分析や KYC チェックなどの自動タスクを自律的に実行する自動エージェント。
- ウェブから最新のコンテキストを取得する垂直エージェント（営業エージェント、コーディング エージェント、財務エージェント）。
例
「2025 年のラスベガス F1 グランプリの優勝者は誰ですか？」
| グラウンディングを使用しない場合 | グラウンディングを使用する場合 |
|---|---|
| 2025 年のラスベガス グランプリはまだ開催されていません。レースは 2025 年 11 月 20 ～ 22 日の週末に開催される予定です。 そのため、優勝者は不明です。 | 2025 年のラスベガス F1 グランプリの優勝者は、 レッドブル レーシングのマックス フェルスタッペンでした。レースは 2025 年 11 月 22 日に開催されました。 出典: domain1.com、domain2.com、... |
サポートされているモデル
Parallel ウェブ検索によるグラウンディングは、次のモデルでサポートされています。
- 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 ウェブ検索によるグラウンディングを使用するには、アクセスを設定する必要があります。次の 2 つの方法があります。
Google Cloud Marketplace で Parallel ウェブ検索によるグラウンディングを直接購入して、既存のクラウド環境に統合します。機密性の高いワークロードには、ゼロデータ 保持サービスもご利用いただけます。ZDR を使用するには、ZDR サービスを購入し、API リクエストで対応する
enable_zero_data_retentionフラグを設定する必要があります。既存の Parallel API キーを使用します。
Google Cloud Marketplace で購入する（推奨）
Google Cloud Marketplace を介して統合すると、 で Parallel ウェブ検索によるグラウンディング サービスを直接管理できます。 Google Cloudまず、Google Cloud Marketplace で Parallel ウェブ検索によるグラウンディング サービスを購入し、利用規約に同意して、料金を確認します。
独自の API キーを使用する
Parallel の請求と API アクセスを個別に管理する場合は、独自の API キーを指定できます。この方法を使用するには、 Parallel デベロッパー プラットフォームから API キーを取得する必要があります。この API キーは、Gemini への REST API リクエストで直接使用されます。
Parallel を使用して Gemini のレスポンスをグラウンディングする
コンソール、 Google Cloud Google Gen AI SDK、または REST API で Agent Studio を使用して、Gemini からグラウンディングされたレスポンスをリクエストします。最適なパフォーマンスを得るには、デフォルト値以外の値を厳密に必要とする場合を除き、省略可能なパラメータにはデフォルト設定を使用することをおすすめします。
Google Cloud Marketplace で Parallel ウェブ検索によるグラウンディングを購入した場合は、購入に使用した請求先アカウントが Google Cloud プロジェクトで有効になっていることを確認します。
サンプルを実行する前に、前提条件（Google Cloud Marketplace での購入や Parallel API キーの指定など）を満たしてください。
コンソール
Gemini Enterprise Agent Platform で Agent Studio を使用して、Parallel ウェブ検索で Gemini のレスポンスをグラウンディングするには、次の操作を行います。
Google Cloud コンソールで、[Agent Studio] ページに移動します。
サイドパネルの [モデル設定] で、[グラウンディング] セクションの [パートナー] 切り替えボタン（[グラウンディング パートナーからの検索結果]）をオンにします。
グラウンディング パートナーとして [Parallel ウェブ検索] を選択し、[適用] をクリックします。Parallel ウェブ検索を使用するには、まず Google Cloud Marketplace で購入する必要があります。
テキスト ボックスにプロンプトを入力して送信します。
プロンプト レスポンスで Parallel ウェブ検索によるグラウンディングが使用されるようになりました。
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 ウェブ検索の 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. 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 ウェブ検索の 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. 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 ウェブ検索の 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. 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 ウェブ検索の 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 ウェブ検索のZDR バージョンに切り替えて、機密性の高いワークロードでゼロデータ保持を有効にします。リクエストに ZDR サービスを使用するには、
trueに設定します。これらのリクエストを成功させるには、ZDR 固有のサービスを購入する必要があります。 指定しない場合、デフォルトで標準バージョンになります。ZDR バージョンは Google Cloud Marketplace でのみ利用できます。
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 レスポンスが返されます。
Quota
デフォルトの割り当ては、1 分あたり 200 プロンプトです。レート上限の引き上げをリクエストするには、ユースケースと要件を適切な担当者にお知らせください。
Google Cloud Marketplace で Parallel ウェブ検索によるグラウンディングを購入した場合: Google アカウント チームにお問い合わせください。
独自の API キーを指定する場合: Contactsupport@parallel.ai と Google アカウント チームにお問い合わせください。
課金
Parallel ウェブ検索によるグラウンディングを使用すると、次の料金が発生します。
Gemini トークンの消費: 次の料金が発生する可能性があります。
- プロンプト トークン
- 思考トークン
- 出力トークン
詳細は、 料金をご覧ください。
Gemini の独自のデータによるグラウンディング: 詳しくは、 料金をご覧ください。
Parallel ウェブ検索 API の使用料金:
Google Cloud Marketplace で Parallel ウェブ検索によるグラウンディングを購入した場合は、 Google Cloud Marketplace の Parallel の料金 セクションをご覧ください。
独自の API キーを指定する場合は、 Parallel のウェブサイトをご覧ください。