Configura el uso compartido de instrucciones y respuestas para Gemini Cloud Assist

Nota: El uso de esta oferta previa a la DG de Gemini Cloud Assist está sujeto al Acuerdo de Google Cloud , incluidas las Condiciones de la Oferta de Fase Previa a la DG de las Google Cloud Condiciones Específicas del Servicio, que se complementan con las condiciones del Programa de Verificadores de confianza de Gemini para Google Cloud .

En este documento, se describe cómo configurar el uso compartido de las instrucciones y respuestas de Gemini Cloud Assist para un proyecto con la consola de Google Cloud o una API.

Cuando se habilita, Google procesa las instrucciones y respuestas de todos los usuarios de Gemini Cloud Assist en el proyecto con el objetivo de mejorar el producto, lo que ayuda a Google a mejorar Gemini Cloud Assist. Google almacena las instrucciones y respuestas anonimizadas enviadas desde el proyecto durante un máximo de dos años. Las instrucciones y respuestas de tu organización nunca se usan para entrenar o ajustar ningún modelo de LLM.

Puedes cambiar este parámetro de configuración en cualquier momento.

Antes de comenzar

Para obtener los permisos necesarios para configurar el uso compartido de instrucciones y respuestas de Gemini Cloud Assist, pídele a tu administrador que te otorgue el rol predefinido de Identity and Access Management (IAM) Administrador de Gemini Cloud Assist (roles/geminicloudassist.admin), que incluye todos los permisos necesarios para ver y modificar la configuración del administrador de Gemini Cloud Assist.

Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:

Permisos necesarios

• cloudaicompanion.dataSharingWithGoogleSettings.create
• cloudaicompanion.dataSharingWithGoogleSettings.update
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Si usas solicitudes directas a la API, este permiso es necesario específicamente para TARGET_PROJECT.

Los siguientes son permisos adicionales que se requieren si usas la consola de Google Cloud :

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

Puedes obtener estos permisos con otros roles predefinidos o roles personalizados.

Habilita el uso compartido de instrucciones y respuestas para Gemini Cloud Assist

Selecciona una de las siguientes opciones:

Console

1. Abre la consola de Google Cloud .

   Ir a la consola de Google Cloud

2. En cualquier página de la consola de Google Cloud , haz clic en spark Abrir o cerrar el chat de Gemini Cloud Assist.

   Se abrirá el panel de Cloud Assist.

3. Haz clic en Más acciones () y, luego, en Configuración de Cloud Assist en el menú desplegable.

   Se abrirá el panel de configuración Administrar Gemini Cloud Assist.

4. En la sección Uso compartido de datos para Gemini Cloud Assist, asegúrate de que esté seleccionada la opción Comparte tus instrucciones y respuestas para ayudar a Google a mejorar Gemini Cloud Assist.

5. Haz clic en Guardar.

API

Para habilitar el uso compartido de datos para Gemini Cloud Assist, crea un parámetro de configuración con el método dataSharingWithGoogleSettings.create y aplícalo con el método settingBindings.create asociado.

1. Crea el parámetro de configuración y un valor específico para el parámetro de configuración:

   1. Obtén un token de autenticación:

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

   2. Ejecuta el siguiente comando para crear el parámetro de configuración:

      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"
      

      Reemplaza lo siguiente:

      • CONTAINER_PROJECT_NAME: Ingresa el ID del proyecto principal.
      • SETTING_ID: Ingresa un nombre de configuración único, como dswg1 para Data Sharing with Google.

      Si el comando se ejecuta correctamente, devuelve un cuerpo de respuesta que muestra el valor de enablePreviewDataSharing establecido en 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
      }
      

      Para obtener más información sobre la autenticación, consulta Autentica para usar REST.

2. Crea la vinculación de configuración:

     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"
   

   Reemplaza lo siguiente:

   • TARGET_PROJECT_NAME: Ingresa el proyecto de destino al que se debe aplicar el parámetro de configuración.
   • SETTING_ID: Usa el mismo SETTING_ID que usaste cuando creaste el parámetro de configuración, pero agrégale b1. Por ejemplo, usa dswg1b1 para Data Sharing with Google.

   Si el comando se ejecuta correctamente, se muestran los metadatos de la operación en el siguiente formato:

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

Inhabilita el uso compartido de instrucciones y respuestas para Gemini Cloud Assist

Selecciona una de las siguientes opciones:

Console

1. Abre la consola de Google Cloud .

   Ir a la consola de Google Cloud

2. En cualquier página de la consola de Google Cloud , haz clic en spark Abrir o cerrar el chat de Gemini Cloud Assist.

   Se abrirá el panel de Cloud Assist.

3. Haz clic en Más acciones () y, luego, en Configuración de Cloud Assist en el menú desplegable.

   Se abrirá el panel de configuración Administrar Gemini Cloud Assist.

4. En la sección Uso compartido de datos para Gemini Cloud Assist, asegúrate de que no esté seleccionada la opción Comparte tus instrucciones y respuestas para ayudar a Google a mejorar Gemini Cloud Assist.

5. Haz clic en Guardar.

API

Para inhabilitar el uso compartido de instrucciones y respuestas para Gemini Cloud Assist, usa el método dataSharingWithGoogleSettings.patch.

1. Obtén el token:

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

2. Ejecuta el siguiente comando para inhabilitar el parámetro de configuración:

   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"
   

   Este comando PATCH solo se ejecuta correctamente si el recurso de configuración ya existe desde que habilitaste el uso compartido de instrucciones y respuestas.

   Reemplaza lo siguiente:

   • CONTAINER_PROJECT_NAME: Ingresa el ID del proyecto principal.
   • SETTING_ID: Ingresa el nombre del parámetro de configuración existente, como dswg1 para Data Sharing with Google.

   Si el comando se ejecuta correctamente, devuelve un cuerpo de respuesta que muestra el valor de enablePreviewDataSharing establecido en 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
   }
   

¿Qué sigue?

• Explora la configuración de administrador de Gemini Cloud Assist

• Cómo desactivar Gemini Cloud Assist