Cómo configurar los canales de versiones de Gemini Code Assist

En este documento, se describe cómo configurar los canales de versiones de Gemini Code Assist para un proyecto con la consola de APIs de Google o una API.

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

Están disponibles los siguientes canales de versiones:

  • Disponible de forma general. Es el canal de versiones predeterminado. Te permite usar modelos y funciones disponibles de forma general. Ten en cuenta que es posible acceder a ciertas funciones de versión preliminar sin habilitar el canal de versión preliminar, a través de mecanismos alternativos de registro en la versión preliminar. Se podrá acceder a estas funciones en el canal de DG, pero seguirán sujetas a las Condiciones de las Ofertas de la Fase Previa a la DG.

  • Vista previa Te permite acceder a ciertas funciones en versión preliminar de Gemini Code Assist y, de forma opcional, proporcionar comentarios y datos de uso para ayudar a Google a mejorar las versiones futuras. Ten en cuenta que, actualmente, no hay funciones distintas en el canal de versiones preliminares.

    Cuando habilitas el canal de versiones preliminares en un proyecto, aceptas en nombre del cliente que todo el uso de Gemini Code Assist en ese proyecto está sujeto a las Condiciones de la Oferta de Fase Previa a la DG de las Condiciones Específicas del Servicio de Google Cloud Platform. No uses este canal para proyectos y recursos que no sean adecuados para usarse con las ofertas de la fase previa a la DG.

En las siguientes secciones, se proporcionan los pasos necesarios para establecer o cambiar tu canal de versiones de Gemini Code Assist.

Antes de comenzar

Roles obligatorios

Para obtener los permisos necesarios para crear parámetros de configuración y vinculaciones que controlen el canal de versiones, pídele a tu administrador que te otorgue el rol de administrador de configuración de Gemini para Google Cloud (roles/cloudaicompanion.settingsAdmin) en el proyecto.

Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • Configura canales de versiones con 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 instrucciones y respuestas con una API:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Sigue estos pasos para ver la configuración del administrador de Gemini para Google Cloud:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Cómo configurar los canales de versiones de Gemini Code Assist

Selecciona una de las siguientes opciones:

Console

  1. En la consola de APIs, ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

    Se carga la página Gemini para Google Cloud.

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

    Se carga la página Configuración.

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

    Vista previa

    1. Selecciona Vista previa.
    2. Revisa los detalles del canal de versiones preliminares y las condiciones del programa de verificadores de confianza, y, luego, haz clic en Guardar cambios.

    Disponible de manera general

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

API

  1. Crea el parámetro de configuración del canal de versiones y un valor específico del parámetro de configuración:

    1. Obtén un token de autenticación. Debes autenticarte con la autenticación de gcloud para obtenerlo:

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

    2. Crea el parámetro de configuración. 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"

      Reemplaza lo siguiente:

      • RELEASE_CHANNEL: Es el canal de versiones, que puede ser EXPERIMENTAL para la versión preliminar o STABLE para la versión disponible de forma general.
      • CONTAINER_PROJECT_NAME: Es el ID del proyecto en el que se almacena el recurso de vinculación. Este es el proyecto principal de la vinculación.
      • RC_SETTING_ID: Es un nombre de configuración único, por ejemplo, rc1 para Release Channel.

      El resultado muestra el releaseChannel establecido en 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 la vinculación de configuración del canal de versiones:

        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"

      Reemplaza lo siguiente:

      • TARGET_PROJECT_NAME: Es el proyecto de destino al que se debe vincular la vinculación. Por lo general, es el mismo que el proyecto del contenedor. Sin embargo, puedes vincular un parámetro de configuración a varios proyectos para que no se duplique el recurso de configuración.
      • CONTAINER_PROJECT_NAME: Es el ID del proyecto en el que se almacena el recurso de vinculación. Este es el proyecto principal de la vinculación.
      • RC_SETTING_ID: Es el mismo RC_SETTING_ID que usaste cuando creaste el parámetro de configuración, pero con b1 agregado. Por ejemplo, usa rc1b1 para Release Channel.
      • RC_BINDING_ID: Es un nombre único para la vinculación de la configuración, por ejemplo, rc_binding.

      El resultado 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: Verifica el estado de la creación de la vinculación de la configuración del canal de versiones:

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

      Reemplaza lo siguiente:

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

  2. Opcional: Crea el parámetro de configuración para compartir instrucciones y respuestas, y un valor específico del parámetro de configuración:

    1. Obtén el token:

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

    2. Crea el parámetro de configuración:

      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"

      Reemplaza lo siguiente:

      • CONTAINER_PROJECT_NAME: El ID del proyecto principal
      • DSWG_SETTING_ID: Es un nombre de configuración único, por ejemplo, dswg1 para Data Sharing with Google.

      El resultado muestra el enablePreviewDataSharing establecido en 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 la vinculación de configuración de la instrucció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"

      Reemplaza lo siguiente:

      • TARGET_PROJECT_NAME: Es el proyecto de destino al que se debe aplicar el parámetro de configuración.
      • CONTAINER_PROJECT_NAME: Es el ID del proyecto principal.
      • DSWG_SETTING_ID: Es el mismo DSWG_SETTING_ID que usaste cuando creaste el parámetro de configuración, pero con b1 agregado. Por ejemplo, usa dswg1b1 para Data Sharing with Google.
      • DSWG_BINDING_ID: Es un nombre único para la vinculación de la configuración, por ejemplo, dswg_binding.

      El resultado 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: Verifica el estado de la creación de la vinculación de la configuración de la instrucción y la respuesta:

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

      Reemplaza lo siguiente:

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