Configurar los canales de lanzamiento de Gemini Code Assist

En este documento se describe cómo configurar los canales de lanzamiento de Gemini Code Assist para un proyecto mediante la Google Cloud consola o una API.

Lanzamos las funciones de Gemini Code Assist en diferentes canales. Puedes asignar cada proyecto a un solo canal de lanzamiento en función del equilibrio que elijas entre la disponibilidad de las funciones y la estabilidad. Google Cloud Los usuarios de tu organización que usen Gemini Code Assist en su IDE local pueden usar funciones y modelos basados en el canal de lanzamiento configurado para el proyecto.

Están disponibles los siguientes canales de lanzamiento:

  • Disponible de forma general. El canal de lanzamiento predeterminado. Te permite usar modelos y funciones que están disponibles de forma general. Ten en cuenta que es posible acceder a determinadas funciones de vista previa sin habilitar el canal de vista previa mediante mecanismos alternativos de registro de vista previa. Se podrá acceder a estas funciones en el canal de disponibilidad general, pero seguirán estando sujetas a los Términos de las Ofertas Previas a la Disponibilidad General.

  • Vista previa Te permite acceder a determinadas funciones de vista previa de Gemini Code Assist y, opcionalmente, enviar comentarios y datos de uso para ayudar a Google a mejorar las próximas versiones. Ten en cuenta que, por el momento, no hay funciones distintas en el canal de lanzamiento de la versión preliminar.

    Cuando habilitas el canal de lanzamiento de vista previa en un proyecto, aceptas en nombre del cliente que todo el uso de Gemini Code Assist en ese proyecto está sujeto a los Términos de la Oferta de Acceso Previo a la Disponibilidad General de los Google Cloud Términos Específicos del Servicio de la Plataforma. No utilices este canal para proyectos y recursos que no sean adecuados para usar con ofertas previas a la disponibilidad general.

En las siguientes secciones se indican los pasos necesarios para definir o cambiar el canal de lanzamiento de Gemini Code Assist.

Antes de empezar

Roles obligatorios

Para obtener los permisos necesarios para crear ajustes y vinculaciones que controlen el canal de lanzamiento, pide a tu administrador que te asigne el rol de administrador de ajustes de Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) en el proyecto.

Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • Configura los canales de lanzamiento mediante una API:
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • Configura el uso compartido de peticiones y respuestas mediante una API:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Para ver los ajustes de administrador de Gemini para Google Cloud , sigue estos pasos:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Configurar los canales de lanzamiento de Gemini Code Assist

Selecciona una de las opciones siguientes:

Consola

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

  2. En el menú de navegación, haz clic en Configuración.

    Se carga la página Configuración.

  3. En la sección Canales de lanzamiento de Gemini Code Assist en IDEs locales, selecciona el canal de lanzamiento que mejor se adapte a tus necesidades:

    Vista previa

    1. Selecciona Vista previa.
    2. Revisa los detalles del canal de lanzamiento de la versión preliminar y los términos del programa de testers de confianza y, a continuación, haz clic en Guardar cambios.

    Disponible de forma general

    1. Selecciona GA.
    2. Haz clic en Guardar cambios.

API

  1. Crea el ajuste del canal de lanzamiento y un valor específico del ajuste:

    1. Obtén un token de autenticación. Para obtenerlo, debes autenticarte con la autenticación de la CLI de gcloud:

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

    2. Crea el ajuste. En estas instrucciones se usa cURL para llamar a los métodos de la API:

        curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
      "release_channel": "RELEASE_CHANNEL",
    } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"

      Haz los cambios siguientes:

      • RELEASE_CHANNEL: el canal de lanzamiento, que puede ser EXPERIMENTAL (vista previa) o STABLE (disponibilidad general).
      • CONTAINER_PROJECT_NAME: el ID del proyecto del proyecto en el que se almacena el recurso de vinculación. Es el proyecto principal del enlace.
      • RC_SETTING_ID: un nombre de ajuste único; por ejemplo, rc1 para Release Channel.

      El resultado muestra que releaseChannel se ha definido como RELEASE_CHANNEL:

      {
  "name": "projects/CONTAINER_PROJECT_NAME
/locations/global/releaseChannelSettings/RC_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "releaseChannel": RELEASE_CHANNEL
}

    3. Crea el enlace del ajuste del canal de lanzamiento:

        curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CODE_ASSIST"
    }' \
  -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings?setting_binding_id=RC_BINDING_ID"

      Haz los cambios siguientes:

      • TARGET_PROJECT_NAME: el proyecto de destino al que se debe vincular el enlace. Suele ser el mismo que el proyecto del contenedor. Sin embargo, puedes vincular un ajuste a varios proyectos para que no tengas que duplicar el recurso de ajuste.
      • CONTAINER_PROJECT_NAME: el ID del proyecto del proyecto en el que se almacena el recurso de vinculación. Es el proyecto principal del enlace.
      • RC_SETTING_ID: el mismo RC_SETTING_ID que usaste al crear el ajuste, pero con b1 añadido. Por ejemplo, usa rc1b1 para Release Channel.
      • RC_BINDING_ID: un nombre único para el enlace de configuración. Por ejemplo, rc_binding.

      La salida incluye los metadatos de la operación en el siguiente formato:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

    4. Opcional: Comprueba el estado de la creación de la vinculación del ajuste del canal de lanzamiento:

      curl -H "Authorization: Bearer $TOKEN" \
https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID

      Haz los cambios siguientes:

      • CONTAINER_PROJECT_NAME: el ID del proyecto del proyecto en el que se almacena el recurso de vinculación. Es el proyecto principal del enlace.
      • RC_BINDING_OPERATION_ID: el ID de la operación de creación de la vinculación de la configuración del canal de lanzamiento proporcionado en la respuesta del paso anterior.

  2. Opcional: Crea el ajuste para compartir la petición y la respuesta, así como un valor específico del ajuste:

    1. Obtén el token:

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

    2. Crea el ajuste:

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

      Haz los cambios siguientes:

      • CONTAINER_PROJECT_NAME: el ID del proyecto principal
      • DSWG_SETTING_ID: un nombre de ajuste único; por ejemplo, dswg1 para Data Sharing with Google

      El resultado muestra que enablePreviewDataSharing se ha definido como true:

      {
  "name": "projects/CONTAINER_PROJECT_NAME
/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": true
}

    3. Crea el enlace de configuración de la petición y la respuesta:

        curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CODE_ASSIST"
    }' \
  -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings?setting_binding_id=DSWG_BINDING_ID"

      Haz los cambios siguientes:

      • TARGET_PROJECT_NAME: el proyecto de destino al que se debe aplicar el ajuste.
      • CONTAINER_PROJECT_NAME: el ID del proyecto principal.
      • DSWG_SETTING_ID: el mismo DSWG_SETTING_ID que usaste al crear el ajuste, pero con b1 añadido. Por ejemplo, usa dswg1b1 para Data Sharing with Google.
      • DSWG_BINDING_ID: un nombre único para el enlace de configuración. Por ejemplo, dswg_binding.

      La salida incluye los metadatos de la operación en el siguiente formato:

      {
"name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
  "createTime": "2025-01-23T15:27:50.076075570Z",
  "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID",
  "verb": "create",
  "requestedCancellation": false,
  "apiVersion": "v1"
},
"done": false
}

    4. Opcional: Comprueba el estado de la creación de la vinculación de la configuración de peticiones y respuestas:

      curl -H "Authorization: Bearer $TOKEN" \
https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID

      Haz los cambios siguientes:

      • CONTAINER_PROJECT_NAME: el ID del proyecto del proyecto en el que se almacena el recurso de vinculación. Es el proyecto principal del enlace.
      • DSWG_BINDING_OPERATION_ID: el ID de la operación de creación de la vinculación de la petición y la configuración de la respuesta proporcionado en la respuesta del paso anterior.

Siguientes pasos