Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Exa ウェブ検索によるグラウンディング

Exa は、大規模言語モデルのレスポンスのグラウンディング用に最適化された一般公開されているウェブデータにアクセスできる検索 API を提供します。このページでは、Exa を使用して Gemini のレスポンスをグラウンディングする方法について説明します。

Gemini Enterprise Agent Platform の Exa ウェブ検索によるグラウンディングは、Gemini モデルを Exa の検索 API によって提供される一般公開のウェブデータに接続する別のサービス（ Google Cloud 契約で定義）です。

ユースケース

Exa を使用したグラウンディングにより、モデルが最新の関連性の高いウェブデータにアクセスできるようになり、精度が向上し、ハルシネーションが減少します。一般的なユースケースには次のものがあります。

一般的なエージェントと chatbot: 最新の情報を取得して、より信頼性の高い回答を生成します。
調査エージェント: 複数のソースにわたって詳細なディープウェブ調査を行います。
コーディングエージェント: 最新のコードスニペット、ドキュメント、技術リファレンスを取得します。
音声エージェント: リアルタイムの低レイテンシ音声インタラクションをサポートするウェブ検索。
業種固有のエージェント: 特定の業種や知識分野に合わせて調整された、最新の分野固有の情報を取得します。
データ拡充: 最新のウェブコンテキストとメタデータを使用して、内部データセットを拡充します。
自動化されたワークフロー: ニュース、人物、企業、その他の頻繁に更新されるデータを定期的に収集し、内部ワークフローまたは本番環境ワークフローで使用します。

例

スーパーボウル 2026 の優勝チームは？

グラウンディングなし	グラウンディングを使用する場合
2026 年のスーパーボウルの勝者はまだ決まっていないため、お答えすることはできません。	シアトルシーホークスは 2026 年 2 月 8 日にスーパーボウル LX で優勝し、ニューイングランドペイトリオッツを 29 対 13 で破りました。ソース: domain1.com、domain2.com、...

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

Exa を使用したグラウンディングは、次のモデルでサポートされています。

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）

始める前に

Exa でグラウンディングを使用するには、Exa のウェブサイトから API キーを取得する必要があります。この API キーは、Gemini へのリクエストで使用されます。

Exa を使用して Gemini の回答をグラウンディングする

次のように REST API を使用して、Gemini からグラウンディングされたレスポンスをリクエストします。最適なパフォーマンスを得るには、デフォルト以外の値を厳密に必要としない限り、オプションパラメータのデフォルト設定を使用することをおすすめします。

REST

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

LOCATION: リクエストを処理するリージョン。グローバルエンドポイントを使用するには、エンドポイント名からロケーションを除外し、リソースのロケーションを `global` に構成します。
PROJECT_ID: 実際の Google Cloud プロジェクト ID。
MODEL_ID: 使用するモデルの ID。
TEXT: モデルに送信するテキストプロンプト。
API_KEY: Exa ウェブ検索の API キー。
SEARCH_TYPE: 省略可。実行する Exa 検索のタイプ。有効な値は auto（デフォルト）と fast です。fast は、検索の網羅性を犠牲にして、レイテンシを短縮して実行します。
EXCLUDE_DOMAINS: 省略可。検索結果から除外するドメインのリスト。指定すると、これらのドメインから結果は返されません。最大 1,200 個のドメインを指定できます。
INCLUDE_DOMAINS: 省略可。検索に含めるドメインのリスト。指定した場合、結果はこれらのドメインからのみ取得されます。最大 1,200 個のドメインを指定できます。
MAX_CHARACTERS: 省略可。ハイライトで返す文字数の最大値。URL ごとに返されるハイライトテキストの合計長を制御します。
NUM_RESULTS: 省略可。グラウンディングに使用する検索結果の最大数。指定しない場合、デフォルトは 5 です。

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": [{
    "exaAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "type": "SEARCH_TYPE",
            "excludeDomains": ["EXCLUDE_DOMAINS"],
            "includeDomains": ["INCLUDE_DOMAINS"],
            "contents": {
                "highlights": {
                    "maxCharacters": MAX_CHARACTERS
                }
            },
            "numResults": NUM_RESULTS
        }
    }
}],
  "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 Seattle Seahawks won Super Bowl LX on February 8, 2026, defeating the New England Patriots with a final score of 29-13."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 125,
              "text": "The Seattle Seahawks won Super Bowl LX on February 8, 2026, defeating the New England Patriots with a final score of 29-13."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          }
        ]
      }
    }
  ],
  "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"
}

割り当て

デフォルトの割り当ては 1 分あたり 200 件のプロンプトです。レート上限を引き上げる必要がある場合は、ユースケースと要件を添えて support@exa.ai と Google アカウントチームにお問い合わせください。

課金

Exa でのグラウンディングの使用には、次の料金が発生します。

Gemini のトークン使用量: プロンプトトークン、思考トークン、出力トークン。詳細は、料金をご覧ください。
Gemini のデータによるグラウンディング: 詳細については、料金をご覧ください。
Exa の検索 API の使用料金: 詳しくは、Exa の料金ページをご覧ください。