Configurar el uso compartido de indicaciones y respuestas para Gemini Cloud Assist

Este documento describe cómo configurar el uso compartido de indicaciones y respuestas de Gemini Cloud Assist para un proyecto mediante el uso de Google Cloud consola o una API.

Antes de empezar

  • Asegúrese de que su Google Cloud El proyecto está asociado a una cuenta de facturación.

(Opcional) Otorgar permisos de IAM

Para configurar el uso compartido de mensajes y respuestas para Gemini Cloud Assist, debe tener permisos específicos de Administración de Identidad y Acceso (IAM), que se detallan en las siguientes secciones. Asegúrese de que estos permisos se agreguen a los roles de IAM personalizados .

Como alternativa, puede otorgar al administrador de configuración de Gemini para Google Cloud ( roles/cloudaicompanion.settingsAdmin ) el rol predefinido de IAM, que incluye todos los permisos necesarios para Gemini para Google Cloud configuración del administrador.

(Opcional) Vincular permisos a configuraciones y objetivos

Si está configurando Gemini para Google Cloudconfiguración del administrador en el Google Cloud consola, entonces puedes omitir esta sección.

Para configurar Gemini para Google Cloud Para configurar el administrador con la API de Gemini para Google Cloud , primero debe crear configuraciones y luego crear enlaces para "vincular" esas configuraciones y objetivos (como instancia, tema o proyectos) para productos específicos (como Gemini Cloud Assist o Gemini Code Assist).

Todos los permisos para crear y actualizar configuraciones están a nivel de proyecto.

Configurar el uso compartido de indicaciones y respuestas de Gemini Cloud Assist

Las siguientes secciones detallan los pasos necesarios para configurar Gemini Cloud Assist para que comparta las indicaciones y respuestas de su organización con Google para mejorar el producto. Esta configuración indica a Google que procese las indicaciones y respuestas de todos los usuarios de Gemini Cloud Assist del proyecto para mejorar el producto, lo que ayuda a Google a optimizar Gemini Cloud Assist.

De forma predeterminada, Google no tiene acceso para registrar ni examinar las indicaciones que sus usuarios escriben y envían a Gemini Cloud Assist, ni las respuestas que reciben. Esto limita la capacidad de Google para mejorar Gemini Cloud Assist, ya que comprende mejor qué temas son importantes para su organización y la calidad de nuestras respuestas. Si habilita el uso compartido de indicaciones y respuestas para un proyecto, Google almacena las indicaciones y respuestas anónimas enviadas desde el proyecto durante un máximo de 180 días. Las indicaciones y respuestas de su organización nunca se utilizan para entrenar ni perfeccionar ningún modelo LLM.

Si habilita compartir mensajes y respuestas con Google , puede deshabilitarlo en cualquier momento visitando la página Administrador de Gemini en Google Cloud consola.

Habilitar el uso compartido de mensajes y respuestas para Gemini Cloud Assist

Seleccione una de las siguientes opciones:

Consola

  1. Asegúrese de tener los siguientes permisos de administración de identidad y acceso (IAM) en el proyecto propietario de la suscripción:

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

  2. En el Google Cloud consola, vaya a la página Admin de Gemini .

    Vaya a Géminis para Google Cloud

    Se carga la página de Gemini para Google Cloud .

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

    Se carga la página de Configuración .

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

El uso de estos datos por parte de Google se rige por las Google Cloud Acuerdo, incluidos los Términos de Oferta Pre-GA del Google Cloud Términos de servicio específicos , complementados por los términos de Gemini para Google Cloud Programa de probadores de confianza .

API

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

  1. Asegúrese de tener los siguientes permisos de administración de identidad y acceso (IAM) en el proyecto propietario de la suscripción:

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

  2. Cree la configuración y un valor específico de la configuración:

    1. Obtener un token de autenticación :

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

    2. Ejecute el siguiente comando para crear la configuración:

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

      Reemplace lo siguiente:

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

      Si el comando tiene éxito, devuelve un cuerpo de respuesta que muestra 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, consulte Autenticar para usar REST .

  3. Crear el enlace 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?setting_binding_id=BINDING_ID"

    Reemplace lo siguiente:

    • TARGET_PROJECT_NAME : Ingrese el proyecto de destino al que se debe aplicar la configuración.
    • SETTING_ID : Use el mismo SETTING_ID que creó la configuración, pero añádale b1 . Por ejemplo, use dswg1b1 para Data Sharing with Google .

    Si el comando tiene éxito, devuelve 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
}

El uso de estos datos por parte de Google se rige por las Google Cloud Acuerdo, incluidos los Términos de Oferta Pre-GA del Google Cloud Términos de servicio específicos , complementados por los términos de Gemini para Google Cloud Programa de probadores de confianza .

Deshabilitar el uso compartido de mensajes y respuestas para Gemini Cloud Assist

Seleccione una de las siguientes opciones:

Consola

  1. Asegúrese de tener los siguientes permisos de Administración de identidad y acceso (IAM) en el proyecto en el que desea modificar la configuración:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. En el Google Cloud consola, vaya a la página Admin de Gemini .

    Vaya a Géminis para Google Cloud

    Se carga la página de Gemini para Google Cloud .

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

    Se carga la página de Configuración .

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

API

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

  1. Asegúrese de tener los siguientes permisos de Administración de identidad y acceso (IAM) en el proyecto en el que desea modificar la configuración:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Deshabilitar el uso compartido de mensajes y respuestas para la configuración especificada:

    1. Obtener el token:

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

    2. Ejecute el siguiente comando para deshabilitar la configuración:

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

      Este comando PATCH solo tiene éxito si el recurso de configuración ya existía cuando habilitó el uso compartido de solicitudes y respuestas .

      Reemplace lo siguiente:

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

      Si el comando tiene éxito, devuelve un cuerpo de respuesta que muestra 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?