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

Google Cloud

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

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

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

始める前に

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

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

必要な権限

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

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

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

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

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

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

コンソール

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

    コンソールに移動 Google Cloud

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

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

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

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

  4. [Gemini Cloud Assist のデータ共有] セクションで、[プロンプトと回答を共有することで Google 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_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

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

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

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

      {
  "name": "projects/CONTAINER_PROJECT_NAME/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_NAME",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"

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

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

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

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</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_NAME</var>/locations/global/dataSharingWithGoogleSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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

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

コンソール

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

    コンソールに移動 Google Cloud

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

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

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

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

  4. [Gemini Cloud Assist のデータ共有] セクションで、[プロンプトと回答を共有することで Google 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_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

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

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

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

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

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

次のステップ