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

En este documento se describe cómo configurar la opción para compartir las peticiones y las respuestas de Gemini Cloud Assist en un proyecto mediante la consola o una API. Google Cloud

Antes de empezar

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

Verificar permisos de gestión de identidades y accesos

Para configurar el uso compartido de peticiones y respuestas de Gemini Cloud Assist, puedes conceder el rol predefinido de gestión de identidades y accesos (IAM) Administrador de la configuración de Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin), que incluye todos los permisos necesarios para la configuración de administrador de Gemini para Google Cloud .

También puedes actualizar cualquier rol de gestión de identidades y accesos personalizado con permisos de gestión de identidades y accesos específicos, que se detallan en las siguientes secciones.

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

En las siguientes secciones se indican los pasos necesarios para configurar Gemini Cloud Assist de forma que se compartan las peticiones y las respuestas de tu organización con Google para mejorar el producto. Este ajuste indica a Google que procese las peticiones y las respuestas de todos los usuarios de Gemini Cloud Assist del proyecto con fines de mejora del producto, lo que ayuda a Google a mejorar Gemini Cloud Assist.

De forma predeterminada, Google no examina las peticiones que escriben y envían tus usuarios a Gemini Cloud Assist ni las respuestas que se les 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 la calidad de nuestras respuestas. Si habilitas la opción de compartir peticiones y respuestas de un proyecto, Google almacenará las peticiones y respuestas anonimizadas enviadas desde el proyecto durante un máximo de dos años. Las peticiones y las respuestas de tu organización nunca se usan para entrenar ni ajustar ningún modelo LLM.

Si habilitas la opción de compartir las peticiones y las respuestas con Google, puedes inhabilitarla en cualquier momento. Para ello, visita la página Administrador de Gemini en la consola de Google Cloud .

Habilitar la opción de compartir peticiones y respuestas de Gemini Cloud Assist

Selecciona una de las opciones siguientes:

Consola

  1. Comprueba que tienes los siguientes permisos de gestión de identidades y accesos (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 Google Cloud consola, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

  3. En el menú de navegación de la izquierda, haz clic en Configuración.

    Se carga la página Configuración.

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

API

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

  1. Comprueba que tienes los siguientes permisos de gestión de identidades y accesos (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 ajuste y un valor específico para el ajuste:

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

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

    2. Ejecuta el siguiente comando para crear el ajuste:

      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"

      Haz los cambios siguientes:

      • CONTAINER_PROJECT_NAME: introduce el ID del proyecto principal.
      • SETTING_ID: introduce un nombre único para el ajuste, como dswg1 para Data Sharing with Google.

      Si el comando se ejecuta correctamente, devuelve un cuerpo de respuesta que muestra el valor enablePreviewDataSharing definido como 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 Autenticación para usar REST.

  3. Crea 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?settingBindingId=BINDING_ID"

    Haz los cambios siguientes:

    • TARGET_PROJECT_NAME: introduce el proyecto de destino al que se debe aplicar el ajuste.
    • SETTING_ID: Usa el mismo SETTING_ID que cuando creaste el ajuste, pero añade b1. Por ejemplo, usa dswg1b1 para Data Sharing with Google.

    Si el comando se ejecuta correctamente, 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
}

Inhabilitar el uso compartido de peticiones y respuestas de Gemini Cloud Assist

Selecciona una de las opciones siguientes:

Consola

  1. Verifica que tienes los siguientes permisos de gestión de identidades y accesos (IAM) en el proyecto en el que quieres modificar la configuración:

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

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

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

  3. En el menú de navegación de la izquierda, haz clic en Configuración.

    Se carga la página Configuración.

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

API

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

  1. Verifica que tienes los siguientes permisos de gestión de identidades y accesos (IAM) en el proyecto en el que quieres modificar la configuración:

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

  2. Inhabilita la opción de compartir peticiones y respuestas del ajuste especificado:

    1. Obtén el token:

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

    2. Ejecuta el siguiente comando para inhabilitar el ajuste:

      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 la opción de compartir peticiones y respuestas.

      Haz los cambios siguientes:

      • CONTAINER_PROJECT_NAME: introduce el ID del proyecto principal.
      • SETTING_ID: introduce el nombre del ajuste, como dswg1 para Data Sharing with Google.

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

Siguientes pasos