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

コンソール

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

   [設定] に移動

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

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

API

API を使用して Gemini Cloud Assist のグラウンディングを構成するには、geminiGcpEnablementSettings.create メソッドを使用して、グラウンディング タイプを定義する geminiGcpEnablementSettings リソースを作成します。次に、関連付けられた 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/<var>CONTAINER_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>TARGET_PROJECT</var>/locations/global/geminiGcpEnablementSettings/<var>GROUNDING_SETTING_ID</var>/settingBindings/<var>GROUNDING_BINDING_ID</var>",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }