Gemini Cloud Assist のグラウンディングを構成する

このドキュメントでは、 Google Cloud コンソールまたは API を使用して、Gemini Cloud Assist の グラウンディングを構成する方法について説明します。グラウンディングは Vertex AI によって提供されます。

使用可能なグラウンディング タイプ:

  • Google 検索によるグラウンディング（推奨）: Gemini Cloud Assist に Google 検索を使用して、最も 包括的で最新の回答を提供するよう指示します。このオプションでは、データ所在地、アクセスの透明性、カスタマー マネージド暗号鍵（CMEK）などの一部のサービスはサポートされていません。

  • エンタープライズ向けウェブ グラウンディング: ウェブ コンテンツの制限されたサブセットを活用します。Google 検索によるグラウンディングと比較して回答の質が低下する可能性がありますが、金融、医療、公共部門など、厳格なデータ所在地コンプライアンスが求められる規制の厳しい業界では、このオプションが推奨されます。

デフォルトでは、Gemini Cloud Assist は Google 検索によるグラウンディングを使用して、プロンプトに対する回答の質を向上させます。Google 検索によるグラウンディングの使用には、サービス 規約に Google Cloud 記載されているように、プロンプトと回答の特別なデータ処理が含まれます。

始める前に

  1. Google Cloud プロジェクトが請求先アカウントに紐づいていることを確認します。

  2. プロジェクトに Gemini Cloud Assist が設定されていることを確認します Google Cloud 。

  3. Gemini Cloud Assist のグラウンディングを構成するために必要な権限を取得するには、プロジェクトに対する **Gemini for Google Cloud 設定管理者** （roles/cloudaicompanion.settingsAdmin）の Identity and Access Management（IAM）ロールを付与するよう管理者に依頼してください。この事前定義ロールには、Gemini Cloud Assist 管理者設定の管理に必要な権限が含まれています。

    必要とされる正確な権限については、「必要な権限 」セクションを開いてご確認ください。

    必要な権限

    • cloudaicompanion.geminiGcpEnablementSettings.create
    • cloudaicompanion.geminiGcpEnablementSettings.update
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
      • 直接 API リクエストを使用している場合、この権限は TARGET_PROJECT にのみ必要です。

    コンソール Google Cloud を使用している場合は、次の追加の権限が必要です。

    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUpdate

これらの権限は、他の 事前定義ロールや カスタムロールを使用して取得することもできます。

Gemini Cloud Assist のグラウンディングを構成する

次のオプションのいずれかを選択します。

コンソール

  1. コンソールを Google Cloud 開きます。

    コンソールに移動 Google Cloud

  2. コンソールの任意のページで Google Cloud 、 spark [**Gemini Cloud Assist チャットを開始または終了します**]をクリックします。

    [Cloud Assist] パネルが開きます。

  3. [**その他の操作**]（）をクリックし、 プルダウン メニューから [**Cloud Assist の設定**] をクリックします。

    [Gemini Cloud Assist の管理] 設定パネルが開きます。

  4. 使用するグラウンディング オプションを選択します。

  5. [保存] をクリックします。

API

API を使用して Gemini Cloud Assist のグラウンディングを構成するには、 グラウンディング タイプを定義する geminiGcpEnablementSettings リソースを geminiGcpEnablementSettings.create メソッドを使用して作成します。次に、関連する settingBindings.create メソッドを使用して設定を適用し、設定をプロジェクトにバインドします。

  1. 設定と設定固有の値を作成します。

    1. 認証トークンを取得します。

      TOKEN=$(gcloud auth print-access-token)

      認証の詳細については、 REST を使用して認証するをご覧ください。

    2. 次のコマンドを実行して、設定を作成します。

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "webGroundingType": "GROUNDING_TYPE"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"

      次のように置き換えます。

      • CONTAINER_PROJECT: 設定データを保存するプロジェクトのプロジェクト ID。
      • GROUNDING_TYPE: グラウンディング タイプ（GROUNDING_WITH_GOOGLE_SEARCH または WEB_GROUNDING_FOR_ENTERPRISE）。
      • GROUNDING_SETTING_ID: この特定の設定データを識別する一意の名前（gt1 など）。

      コマンドが成功すると、選択した webGroundingType を示すレスポンス本文が返されます。

      {
  "name": "projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "webGroundingType": "GROUNDING_TYPE"
}

  2. 設定バインディングを作成します。

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "target": "projects/TARGET_PROJECT",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"

    次のように置き換えます。

    • TARGET_PROJECT: 設定を適用するプロジェクトのプロジェクト ID。通常、ターゲット プロジェクトとコンテナ プロジェクトは同じです。
    • CONTAINER_PROJECT: 設定データを保存するプロジェクトのプロジェクト ID。
    • GROUNDING_SETTING_ID: 設定の作成時に指定した GROUNDING_SETTING_ID。
    • GROUNDING_BINDING_ID: この特定の設定バインディング リソースを識別する一意の ID（b1 など）。

    コマンドが成功すると、オペレーション メタデータが次の形式で返されます。

    {
  "name": "projects/CONTAINER_PROJECT/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/TARGET_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings/GROUNDING_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

次のステップ