Gemini Cloud Assist のプロンプトと回答の共有を構成する

このドキュメントでは、 Google Cloud コンソールまたは API を使用して、プロジェクトの Gemini Cloud Assist プロンプトと回答の共有を構成する方法について説明します。

有効にすると、プロダクトの改善を目的として、プロジェクト内のすべての Gemini Cloud Assist ユーザーのプロンプトと回答が Google によって処理されます。これにより、Google は Gemini Cloud Assist を改善できます。プロジェクトから送信された匿名のプロンプトと回答は、最大 2 年間保存されます。組織のプロンプトと回答は、LLM モデルのトレーニングやファインチューニングに使用されることはありません。

この設定はいつでも変更できます。

始める前に

Gemini Cloud Assist のプロンプトと回答の共有を構成するために必要な権限を取得するには、Gemini Cloud Assist 管理者（roles/geminicloudassist.admin）の Identity and Access Management（IAM）事前定義ロールを付与するよう管理者に依頼します。このロールには、Gemini Cloud Assist の管理者設定の表示と変更に必要なすべての権限が含まれています。

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

必要な権限

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

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

  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUpdate
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsDelete

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

Gemini Cloud Assist でプロンプトと回答の共有を有効にする

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

コンソール

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

    Google Cloud コンソールに移動

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

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

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

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

  4. [Gemini Cloud Assist のデータ共有] セクションで、[プロンプトと回答を共有して Google による Gemini Cloud Assist の改善にご協力ください] が選択されていることを確認します。

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

API

Gemini Cloud Assist でのデータ共有を有効にするには、dataSharingWithGoogleSettings.create メソッドで設定を作成し、関連する settingBindings.create メソッドを使用して設定を適用します。

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

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

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

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

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enablePreviewDataSharing": true
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

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

      • CONTAINER_PROJECT: 親プロジェクト ID を入力します。
      • SETTING_ID: 一意の設定名を入力します（Data Sharing with Google の場合は dswg1 など）。

      コマンドが成功すると、enablePreviewDataSharing が true に設定されていることを示すレスポンス本文が返されます。

      {
  "name": "projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": true
}

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

  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/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"

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

    • TARGET_PROJECT: 設定を適用するターゲット プロジェクトを入力します。
    • SETTING_ID: 設定を作成したときと同じ SETTING_ID を使用しますが、b1 を追加します。たとえば、Data Sharing with Google では dswg1b1 を使用します。

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

    {
  "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/dataSharingWithGoogleSettings/SETTING_ID/settingBindings/BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Gemini Cloud Assist のプロンプトと回答の共有を無効にする

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

コンソール

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

    Google Cloud コンソールに移動

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

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

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

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

  4. [Gemini Cloud Assist のデータ共有] セクションで、[プロンプトと回答を共有して Google による Gemini Cloud Assist の改善にご協力ください] が選択されていないことを確認します。

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

API

Gemini Cloud Assist のプロンプトと回答の共有を無効にするには、dataSharingWithGoogleSettings.patch メソッドを使用します。

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

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

  2. 次のコマンドを実行して、設定を無効にします。

    curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enablePreviewDataSharing": false
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

    この PATCH コマンドが成功するのは、プロンプトとレスポンスの共有を有効にしたときに設定リソースがすでに存在する場合のみです。

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

    • CONTAINER_PROJECT: 親プロジェクト ID を入力します。
    • SETTING_ID: 既存の設定名を入力します（Data Sharing with Google の場合は dswg1 など）。

    コマンドが成功すると、enablePreviewDataSharing が false に設定されていることを示すレスポンス本文が返されます。

    {
  "name": "projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": false
}

次のステップ