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

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

Cuando está habilitado, Google procesa las instrucciones y las 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 las respuestas anonimizadas enviadas desde el proyecto por un máximo de dos años. Las instrucciones y las respuestas de tu organización nunca se usan para entrenar ni 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 para Gemini Cloud Assist, pídele a tu administrador que te otorgue el rol predefinido de Identity and Access Management (IAM) (roles/geminicloudassist.admin) **Administrador de Gemini Cloud Assist**, que incluye todos los permisos necesarios para ver y modificar la configuración de 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 Google Cloud consola de:

  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUpdate
  • cloudaicompanion.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 Google Cloud consola de:

    Ir a la Google Cloud consola

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

    Se abrirá el panel 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 que Google mejore 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 dataSharingWithGoogleSettings.create método y aplica el parámetro de configuración con el settingBindings.create método asociado.

  1. Crea el parámetro de configuración y un valor específico del 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/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

      Reemplaza lo siguiente:

      • CONTAINER_PROJECT: Ingresa el ID del proyecto superior.
      • SETTING_ID: Ingresa un nombre de parámetro de configuración único, como dswg1 para Data Sharing with Google.

      Si el comando se ejecuta de forma correcta, muestra un cuerpo de respuesta que muestra el enablePreviewDataSharing establecido en true:

      {
  "name": "projects/CONTAINER_PROJECT/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 Autentícate 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",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"

    Reemplaza lo siguiente:

    • TARGET_PROJECT: Ingresa el proyecto de destino al que se debe aplicar el parámetro de configuración.
    • SETTING_ID: Usa el mismo SETTING_ID 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 de forma correcta, muestra los metadatos de la operación en el siguiente formato:

    {
  "name": "projects/CONTAINER_PROJECT/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/TARGET_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings/BINDING_ID",
    "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 Google Cloud consola de:

    Ir a la Google Cloud consola

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

    Se abrirá el panel 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 que Google mejore Gemini Cloud Assist.

  5. Haz clic en Guardar.

API

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

  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/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

    Este PATCH comando 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: Ingresa el ID del proyecto superior.
    • SETTING_ID: Ingresa el nombre del parámetro de configuración existente, como dswg1 para Data Sharing with Google.

    Si el comando se ejecuta de forma correcta, muestra un cuerpo de respuesta que muestra el enablePreviewDataSharing establecido en false:

    {
  "name": "projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": false
}

¿Qué sigue?