Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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 を介して統合すると、 Parallel ウェブ検索によるグラウンディングサービスを直接 Google Cloud管理できます。まず、Google Cloud Marketplace で Parallel ウェブ検索によるグラウンディングサービスに登録し、利用規約に同意して、料金を確認します。

独自の API キーを使用する

Parallel の課金と API アクセスを個別に管理する場合は、独自の API キーを指定できます。この方法を使用するには、 Parallel デベロッパープラットフォームから API キーを取得する必要があります。この API キーは、Gemini への REST API リクエストで直接使用されます。

Parallel を使用して Gemini のレスポンスをグラウンディングする

REST API を使用して、Gemini からグラウンディングされたレスポンスをリクエストします。最適なパフォーマンスを得るには、デフォルト以外の値を厳密に必要とする場合を除き、省略可能なパラメータにデフォルト設定を使用することをおすすめします。

Google Cloud Marketplace （プレビュー）で Parallel ウェブ検索によるグラウンディングに登録した場合は、登録に使用した請求先アカウントがプロジェクトで有効になっていることを確認します。Google Cloud

REST

リクエストのデータを使用する前に、次のように置き換えます。

LOCATION: リクエストを処理するリージョン。グローバルエンドポイントを使用するには、エンドポイント名からロケーションを除外し、リソースのロケーションを `global` に構成します。
PROJECT_ID: 実際の Google Cloud プロジェクト ID。
MODEL_ID: 使用するモデルの ID。
TEXT: モデルに送信するテキストプロンプト。
API_KEY: Parallel ウェブ検索の API キー。API キーを指定し、Google Cloud Marketplace（プレビュー）で Parallel ウェブ検索によるグラウンディングに登録している場合、API キーが優先されます。
ENABLE_ZERO_DATA_RETENTION：省略可。Parallel ウェブ検索の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"
}

リクエストを送信するには、次のいずれかのオプションを展開します。

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"
}

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 のウェブサイトをご覧ください。