Configure prompt and response sharing for Gemini Cloud Assist

Note: Use of this preview offering of Gemini Cloud Assist is subject to the Google Cloud Agreement, including the Pre-GA Offering Terms of the Google Cloud Specific Service Terms, as supplemented by the terms for the Gemini for Google Cloud Trusted Tester Program.

This document describes how to configure Gemini Cloud Assist prompt and response sharing for a project by using the Google Cloud console or an API.

When enabled, Google processes the prompts and responses of all Gemini Cloud Assist users in the project for purposes of product improvement, which helps Google to improve Gemini Cloud Assist. Google stores anonymized prompts and responses submitted from the project for a maximum of two years. Your organization's prompts and responses are never used to train or fine tune any LLM model.

You can change this setting at any time.

Before you begin

In order to get the required permissions for configuring prompt and response sharing for Gemini Cloud Assist, ask your administrator to grant you the Gemini Cloud Assist Admin (roles/geminicloudassist.admin) Identity and Access Management (IAM) predefined role, which includes all required permissions needed to view and modify Gemini Cloud Assist administrator settings.

To see the exact permissions that are required, expand the Required permissions section:

Required permissions

• cloudaicompanion.dataSharingWithGoogleSettings.create
• cloudaicompanion.dataSharingWithGoogleSettings.update
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • If you are using direct API requests, this permission is required specifically for the TARGET_PROJECT.

The following are additional permissions that are required if you are using the Google Cloud console:

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

You might be able to get these permissions with other predefined roles or custom roles.

Enable prompt and response sharing for Gemini Cloud Assist

Select one of the following options:

Console

1. Open the Google Cloud console.

   Go to Google Cloud console

2. In any page of the Google Cloud console, click spark Open or close Gemini Cloud Assist chat.

   The Cloud Assist panel opens.

3. Click More actions (), and then click Cloud Assist Settings from the drop-down menu.

   The Manage Gemini Cloud Assist settings panel opens.

4. In the Data sharing for Gemini Cloud Assist section, ensure that Help Google improve Gemini Cloud Assist by sharing your prompts and response is selected.

5. Click Save.

API

To enable data sharing for Gemini Cloud Assist, create a setting with the dataSharingWithGoogleSettings.create method, and apply the setting using the associated settingBindings.create method.

1. Create the setting and a setting-specific value:

   1. Obtain an authentication token:

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

   2. Run the following command to create the setting:

      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"
      

      Replace the following:

      • CONTAINER_PROJECT_NAME: Enter the parent project ID.
      • SETTING_ID: Enter a unique setting name, such as dswg1 for Data Sharing with Google.

      If the command succeeds, it returns a response body that shows the enablePreviewDataSharing set to 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
      }
      

      For more information on authentication, see Authenticate for using REST.

2. Create the setting binding:

     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"
   

   Replace the following:

   • TARGET_PROJECT_NAME: Enter the target project to which the setting should be applied.
   • SETTING_ID: Use the same SETTING_ID when you created the setting, but append it with b1. For example, use dswg1b1 for Data Sharing with Google.

   If the command succeeds, it returns the operation metadata in the following format:

   {
     "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
   }
   

Disable prompt and response sharing for Gemini Cloud Assist

Select one of the following options:

Console

1. Open the Google Cloud console.

   Go to Google Cloud console

2. In any page of the Google Cloud console, click spark Open or close Gemini Cloud Assist chat.

   The Cloud Assist panel opens.

3. Click More actions (), and then click Cloud Assist Settings from the drop-down menu.

   The Manage Gemini Cloud Assist settings panel opens.

4. In the Data sharing for Gemini Cloud Assist section, ensure that Help Google improve Gemini Cloud Assist by sharing your prompts and response is not selected.

5. Click Save.

API

To disable prompt and response sharing for Gemini Cloud Assist, use the dataSharingWithGoogleSettings.patch method.

1. Obtain the token:

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

2. Run the following command to disable the setting:

   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"
   

   This PATCH command only succeeds if the setting resource already exists from when you enabled prompt and response sharing.

   Replace the following:

   • CONTAINER_PROJECT_NAME: Enter the parent project ID.
   • SETTING_ID: Enter the existing setting name, such as dswg1 for Data Sharing with Google.

   If the command succeeds, it returns a response body that shows the enablePreviewDataSharing set to 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
   }
   

What's next

• Explore Gemini Cloud Assist administrator settings

• Turn off Gemini Cloud Assist