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

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

使用できるグラウンディング タイプは次のとおりです。

  • Google 検索によるグラウンディング（推奨）: Gemini Cloud Assist に、最も 包括的で最新の回答を得るために Google 検索を使用するよう指示します。このオプションでは、データ所在地、アクセスの透明性、顧客管理の暗号鍵（CMEK）などの一部のサービスはサポートされていません。詳細については、 Google 検索によるグラウンディングをご覧ください。

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

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

始める前に

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

IAM 権限を確認する

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

または、カスタム IAM ロールを更新して、次のセクションで説明する特定の Identity and Access Management（IAM）権限を追加することもできます。

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

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

コンソール

  1. サブスクリプションを所有するプロジェクトに対して、次の Identity and Access Management（IAM）権限があることを確認します。

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • geminiGcpEnablementSettings.create
    • geminiGcpEnablementSettings.get
    • geminiGcpEnablementSettings.update
    • settingBindings.geminiGcpEnablementSettingsGet
    • settingBindings.geminiGcpEnablementSettingsUpdate
    • settingBindings.geminiGcpEnablementSettingsCreate
    • settingBindings.geminiGcpEnablementSettingsUse

  2. コンソールで、 [Gemini Cloud Assist] に移動し、[設定] をクリックします。 Google Cloud

    [設定] に移動

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

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

API

API を使用して Gemini Cloud Assist のグラウンディングを構成するには、まず geminiGcpEnablementSettings リソースを作成してグラウンディング タイプを定義します。次に、作成した設定の子である settingBindings リソースを作成して、設定をプロジェクトにバインドします。

  1. 次の Identity and Access Management（IAM）権限があることを確認します。

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • geminiGcpEnablementSettings.create
    • geminiGcpEnablementSettings.get
    • geminiGcpEnablementSettings.update
    • settingBindings.geminiGcpEnablementSettingsGet
    • settingBindings.geminiGcpEnablementSettingsUpdate
    • settingBindings.geminiGcpEnablementSettingsCreate
    • settingBindings.geminiGcpEnablementSettingsUse

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

    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/PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"

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

      • PROJECT: プロジェクト ID。
      • GROUNDING_TYPE: グラウンディング タイプ（GROUNDING_WITH_GOOGLE_SEARCH または WEB_GROUNDING_FOR_ENTERPRISE）。
      • GROUNDING_SETTING_ID: 一意の設定名（Grounding type の場合は gt1 など）。

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

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

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

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

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

    • PROJECT: 設定を適用するプロジェクト ID。
    • GROUNDING_SETTING_ID: 設定の作成時に指定した GROUNDING_SETTING_ID。
    • GROUNDING_BINDING_ID: 設定バインディング リソースの一意の ID（b1 など）。

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

    {
  "name": "projects/<var>PROJECT</var>/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/<var>PROJECT</var>/locations/global/geminiGcpEnablementSettings/<var>GROUNDING_SETTING_ID</var>/settingBindings/<var>GROUNDING_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

次のステップ