パラレルウェブ検索によるグラウンディング

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、...

サポートされているモデル

このセクションでは、パラレルウェブ検索によるグラウンディングをサポートするモデルを示します。

クリックしてサポートされているモデルを開く

始める前に

パラレルウェブ検索によるグラウンディングを使用するには、アクセスを設定する必要があります。次の 2 つのオプションがあります。

  • Google Cloud Marketplace でパラレルウェブ検索によるグラウンディングに直接登録すると、既存のクラウド環境にシームレスに統合できます。機密性の高いワークロード向けに、データ保持ゼロのサービスも用意されています。ZDR を使用するには、ZDR サービスに登録し、API リクエストで対応する enable_zero_data_retention フラグを設定する必要があります。

  • 既存の Parallel API キーを使用します。

Google Cloud Marketplace で登録する（推奨）

Google Cloud Marketplace を介して統合すると、 Google Cloud内で直接、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 で並列ウェブ検索を使用したグラウンディングに登録した場合は、サブスクリプションに使用されている請求先アカウントがGoogle Cloud プロジェクトで有効になっていることを確認します。

サンプルを実行する前に、Google Cloud Marketplace でのサブスクリプションや Parallel API キーの提供など、前提条件を完了してください。

コンソール

Gemini Enterprise Agent Platform の Agent Studio を使用して、Parallel Web Search で Gemini の回答をグラウンディングする手順は次のとおりです。

  1. Google Cloud コンソールで、[Agent Studio] ページに移動します。

    Agent Studio に移動

  2. サイドパネルの [モデル設定] の [グラウンディング] セクションで、[パートナー] 切り替えボタン（グラウンディング パートナーからの検索結果）をオンにします。

  3. グラウンディング パートナーとして [Parallel Web Search] を選択し、[適用] をクリックします。Parallel Web Search を使用するには、まず Google Cloud Marketplace でサブスクライブする必要があります。

  4. テキスト ボックスにプロンプトを入力して送信します。

プロンプトのレスポンスで、パラレルウェブ検索によるグラウンディングが使用されるようになりました。

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 バージョンに切り替えて、機密性の高いワークロードでゼロデータ保持を有効にします。リクエストに 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 レスポンスが返されます。

割り当て

デフォルトの割り当ては、1 分あたり 200 件のプロンプトです。レート制限の引き上げをリクエストするには、ユースケースと要件を適切な連絡先に提供してください。

  • Google Cloud Marketplace で Google 検索を使用したグラウンディングに登録している場合: Google アカウント チームにお問い合わせください。

  • 独自の API キーを提供する場合: support@parallel.ai と Google アカウント チームにお問い合わせください。

課金

パラレルウェブ検索によるグラウンディングを使用すると、次の料金が発生します。

  • Gemini トークンの消費量: 次の料金が請求される場合があります。

    • プロンプト トークン
    • 思考トークン
    • 出力トークン

    詳細は、料金をご覧ください。

  • Gemini の独自のデータによるグラウンディング: 詳細については、料金をご覧ください。

  • Parallel Web Search API の使用料金:

    • Google Cloud Marketplace で Google 検索を使用したグラウンディング（並列ウェブ検索）に登録している場合は、Google Cloud Marketplace の並列料金セクションをご覧ください。

    • 独自の API キーを指定する場合は、Parallel のウェブサイトをご覧ください。