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

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

Antes de comenzar

  • Verifica que tu Google Cloud proyecto esté asociado a una cuenta de facturación.

(Opcional) Otorga permisos de IAM

Para configurar el uso compartido de instrucciones y respuestas para Gemini Cloud Assist, debes tener permisos específicos de Identity and Access Management (IAM), que se detallan en las siguientes secciones. Verifica que estos permisos se agreguen a los roles personalizados de IAM.

Como alternativa, puedes otorgar el rol predefinido de IAM de Administrador de la configuración de Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin), que incluye todos los permisos necesarios para todos los parámetros de configuración del administrador de Gemini para Google Cloud .

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

En las siguientes secciones, se proporcionan los pasos necesarios para configurar Gemini Cloud Assist de modo que comparta las instrucciones y respuestas de tu organización con Google para mejorar el producto. Este parámetro de configuración le indica a Google que procese 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.

De forma predeterminada, Google no examina las instrucciones que tus usuarios escriben y envían a Gemini Cloud Assist ni las respuestas que se envían. Esto limita la capacidad de Google para mejorar Gemini Cloud Assist, ya que no puede comprender mejor qué temas son importantes para tu organización ni qué tan buenas son nuestras respuestas. Si habilitas el uso compartido de instrucciones y respuestas para un proyecto, Google almacenará 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.

Si habilitas el uso compartido de instrucciones y respuestas con Google, puedes inhabilitarlo en cualquier momento. Para ello, visita la página Administrador de Gemini en la consola de Google Cloud .

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

Selecciona una de las siguientes opciones:

Console

  1. Verifica que tengas los siguientes permisos de Identity and Access Management (IAM) en el proyecto propietario de la suscripción:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. En la consola de Google Cloud , ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

  3. Haz clic en Configuración en el menú de navegación de la izquierda.

    Se carga la página Configuración.

  4. Haz clic en Activar el uso compartido de datos para compartir las instrucciones y las respuestas con Google de todos los usuarios de Gemini Cloud Assist en el proyecto.

API

Para habilitar el uso compartido de datos para Gemini Cloud Assist, usa el método CreateDataSharingWithGoogleSetting.

  1. Verifica que tengas los siguientes permisos de Identity and Access Management (IAM) en el proyecto propietario de la suscripción:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. 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.

  3. 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
}

Cómo inhabilitar el uso compartido de instrucciones y respuestas para Gemini Cloud Assist

Selecciona una de las siguientes opciones:

Console

  1. Verifica que tengas los siguientes permisos de Identity and Access Management (IAM) en el proyecto en el que deseas modificar la configuración:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. En la consola de Google Cloud , ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

  3. Haz clic en Configuración en el menú de navegación de la izquierda.

    Se carga la página Configuración.

  4. Haz clic en Desactivar el uso compartido de datos para dejar de compartir instrucciones y respuestas con Google para todos los usuarios de Gemini Cloud Assist en el proyecto.

API

Para inhabilitar el uso compartido de datos para Gemini Cloud Assist, usa el método DeleteDataSharingWithGoogleSetting.

  1. Verifica que tengas los siguientes permisos de Identity and Access Management (IAM) en el proyecto en el que deseas modificar la configuración:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Inhabilita el uso compartido de instrucciones y respuestas para el parámetro de configuración especificado:

    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?