Configura Gemini para la configuración del administrador de Google Cloud

En este documento, se describe cómo acceder a la configuración del administrador de Gemini para Google Cloud y usarla para configurar cambios para todos los usuarios de un proyecto. Puedes administrar la configuración de administrador de un proyecto con la consola de Google Cloud o una API.

Antes de comenzar

  • Asegúrate de que tu proyecto de Google Cloud esté vinculado a una cuenta de facturación.

Configura la configuración de los proyectos en una carpeta

Cuando habilitas Gemini Cloud Assist para todas las APIs de la carpeta, todos los parámetros de configuración de Gemini Cloud Assist están desactivados de forma predeterminada. Debes modificar la configuración de cada proyecto de la carpeta.

(Opcional) Vincula permisos a la configuración y los objetivos

Si estás configurando Gemini para la Google Cloud configuración del administrador en la consola de Google Cloud, puedes omitir esta sección.

Para configurar la Google Cloud configuración del administrador de Gemini con la API de Gemini para Google Cloud, primero debes crear la configuración y, luego, crear vinculaciones para "vincular" esa configuración y los objetivos (como instancias, temas o proyectos) para productos específicos (como Gemini Cloud Assist o Gemini Code Assist).

Todos los permisos para crear y actualizar la configuración se encuentran a nivel del proyecto.

Configura Gemini Cloud Assist para compartir instrucciones y respuestas con Google

En las siguientes secciones, se proporcionan los pasos necesarios para configurar Gemini Cloud Assist para compartir las instrucciones y respuestas de tu organización con Google y 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 fin de mejorar el producto, lo que ayuda a Google a mejorar Gemini Cloud Assist.

De forma predeterminada, Google no tiene acceso para registrar ni examinar las instrucciones que tus usuarios escriben y envían a Gemini Cloud Assist, ni las respuestas que se devuelven. Esto limita la capacidad de Google para mejorar Gemini Cloud Assist, ya que no comprendemos bien qué temas son importantes para tu organización y 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 que se envíen desde el proyecto durante un máximo de 180 días. Las instrucciones y respuestas de tu organización nunca se usan para entrenar ni 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. Asegúrate de tener los siguientes permisos de Identity and Access Management (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 la consola de Google Cloud, ve a la página Administrador de Gemini.

    Ve 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 instrucciones y respuestas con Google para todos los usuarios de Gemini Cloud Assist en el proyecto.

El uso que Google hace de estos datos se rige por el Google Cloud Acuerdo, lo que incluye 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 .

API

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

  1. Asegúrate de tener los siguientes permisos de Identity and Access Management (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. Crea el parámetro de configuración y un valor específico para él:

    1. Obtén el token:

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

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

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

      Reemplaza lo siguiente:

      • CONTAINER_PROJECT_NAME: Ingresa el ID del proyecto superior.
      • SETTING_ID: Ingresa un nombre 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_NAME
/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": true
}

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

      curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CLOUD_ASSIST"
    }' \
  -X POST \ "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?setting_binding_id=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 cuando creaste el parámetro de configuración, pero adjúntalo con b1. Por ejemplo, usa dswg1b1 para Data Sharing with Google.

    Si el comando se realiza correctamente, muestra 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 que Google hace de estos datos se rige por el Google Cloud Acuerdo, lo que incluye 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 .

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

Selecciona una de las siguientes opciones:

Console

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

    • 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. Asegúrate de tener los siguientes permisos de Identity and Access Management (IAM) en el proyecto en el que deseas modificar la configuración:

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

  2. Inhabilita el uso compartido de instrucciones y respuestas para la configuración especificada:

    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 -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
    "enable_customer_data_sharing": false,
  } ' -X PATCH "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"

      Este comando PATCH solo se realiza 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 superior.
      • SETTING_ID: Ingresa el nombre 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_NAME
/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": false
}

¿Qué sigue?