Configura Gemini Code Assist

Antes de que puedas usar Gemini Code Assist, tu equipo debe realizar los pasos de configuración que se describen en este documento:

  1. Compra una suscripción a Gemini Code Assist.

  2. Asignar licencias a usuarios individuales de tu organización

  3. Habilita la API de Gemini para Google Cloud en un proyecto de Google Cloud.

  4. Otorga roles de Identity and Access Management (IAM) en un proyecto de Google Cloud.

  5. Los usuarios de tu organización instalan el complemento Gemini Code Assist para usarlo en un IDE.

Compra una suscripción a Gemini Code Assist

Para obtener una lista de las funciones disponibles en cada edición, consulta Funciones compatibles.

Gemini Code Assist Enterprise está disponible por USD 19 al mes por usuario con un compromiso de 12 meses hasta el 31 de marzo de 2025. Comunícate con nuestro equipo de Ventas para aprovechar esta oferta promocional.

Si tienes contratos existentes con Google Cloud, comunícate con nuestro equipo de ventas antes de comprar una suscripción.

Nota: Debes tener el permiso de Identity and Access Management (IAM) consumerprocurement.orders.place para comprar una suscripción a Gemini. El permiso consumerprocurement.orders.place se incluye en el rol de IAM roles/billing.admin o en el rol de roles/consumerprocurement.orderAdmin. Como alternativa, puedes agregar el permiso a un rol personalizado.

  1. Ve a la página Gemini para Google Cloud.

    Ir a Gemini para Google Cloud

    Se abrirá la página Gemini para Google Cloud.

  2. Selecciona Obtener Gemini Code Assist. Si tu proyecto ya tiene Gemini Code Assist, este texto mostrará Administrar Gemini Code Assist.

    Se abrirá la página Obtener una suscripción a Gemini Code Assist.

  3. En Seleccionar la edición de la suscripción a Gemini Code Assist, selecciona una edición de Gemini Code Assist. Selecciona Comparar ediciones de Gemini Code Assist para ver una lista detallada de las funciones disponibles para cada edición.

    Luego, selecciona Continuar.

  4. En Configurar suscripción, completa los campos para configurar la suscripción, incluidos los siguientes:

    • Nombre de la suscripción.
    • Cantidad de licencias en la suscripción. Ten en cuenta que, si compras la edición Enterprise, debes comprar al menos 10 licencias.
    • Período de suscripción (mensual o anual). Con una suscripción anual, obtienes una tarifa con descuento que se cobra mensualmente en lugar de un pago único.
    • Renovación automática de tu suscripción después de que finalice el plazo de compromiso (mensual o anual). La renovación automática mantiene activas tu suscripción y tus licencias. Si la suscripción no se renueva automáticamente, finalizará cuando finalice el plazo actual y deberás volver a realizar el proceso de compra y reasignar las licencias.

  5. Para confirmar la suscripción, selecciona Continuar.

  6. Si aceptas las condiciones, selecciona Acepto las condiciones de esta compra y, luego, Confirmar suscripción.

  7. Selecciona Siguiente: Administrar asignaciones de licencias de Gemini.

Se compró la suscripción a Gemini Code Assist. Ahora debes administrar las asignaciones de licencias de Gemini en tu organización.

Asignar licencias

Antes de usar Gemini Code Assist, cada usuario de tu organización necesita una licencia.

Console

Para asignar licencias de Gemini a usuarios individuales en la console de Google Cloud, debes tener los siguientes permisos:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

  1. Ve a la página Administrador de Gemini.

    Ir a Administrador de Gemini

  2. Elige la suscripción que deseas cambiar y, luego, haz clic en Modificar suscripción.

  3. Haz clic en Asignar licencias. Aparecerá un diálogo de selección del usuario. Para buscar usuarios específicos, ingresa su nombre en el cuadro de búsqueda.

  4. Selecciona uno o más usuarios de la lista y, luego, haz clic en Siguiente.

  5. Elige los servicios de Gemini para los que deseas asignar licencias.

  6. Haz clic en Asignar licencias.

API

Para asignar licencias de Gemini con la API, debes tener el permiso consumerprocurement.licensePools.assign.

Método HTTP: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

Reemplaza lo siguiente:

  • BILLING_ACCOUNT_ID: el ID de la cuenta de facturación
  • ORDER_ID: la política de IAM

Cuerpo de la solicitud:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

El resultado es similar a este:

{}

La respuesta estará vacía si la licencia se asigna correctamente.

Ahora debes habilitar la API de Gemini para Google Cloud en uno o más proyectos asociados con esta cuenta de facturación. Los usuarios no verán Gemini Code Assist hasta que lo actives en, al menos, un proyecto.

Habilita la API de Gemini para Google Cloud en un proyecto de Google Cloud

En esta sección, se describen los pasos necesarios para habilitar la API de Gemini para Google Cloud en un proyecto de Google Cloud.

Console

  1. Para habilitar la API de Gemini para Google Cloud, ve a la página de Gemini para Google Cloud.

    Ir a Gemini para Google Cloud

  2. En el selector de proyectos, elige un proyecto.

  3. Haz clic en Habilitar.

    La página se actualiza y muestra el estado Enabled. Gemini ahora está disponible en el proyecto de Google Cloud seleccionado para todos los usuarios que tengan los roles de IAM requeridos.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. En el menú de selección de proyectos, elige un proyecto.

  3. Habilita la API de Gemini para Google Cloud con el comando gcloud services enable:

    gcloud services enable cloudaicompanion.googleapis.com

    Si quieres habilitar la API de Gemini para Google Cloud en un proyecto de Google Cloud diferente, agrega el parámetro --project:

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID

    Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud.

    El resultado es similar a este:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Gemini para Google Cloud ahora está disponible en el proyecto de Google Cloud especificado para todos los usuarios que tengan los roles de IAM requeridos.

APIs requeridas para usuarios detrás de firewalls

Además de habilitar la API de Gemini para Google Cloud, es posible que los usuarios detrás de firewalls también deban habilitar las siguientes APIs:

  • oauth2.googleapis.com: Se usa para acceder a Google Cloud.
  • serviceusage.googleapis.com: Se usa para verificar que el proyecto de Gemini Code Assist del usuario esté configurado correctamente.
  • cloudaicompanion.googleapis.com: Es el extremo principal de la API de Gemini para Google Cloud.
  • cloudcode-pa.googleapis.com: Es una API interna que proporciona funciones relacionadas con IDE.
  • cloudresourcemanager.googleapis.com: Se usa en los IDE para selectores de proyectos. Es posible que la API de Resource Manager no sea necesaria si los proyectos se configuran de forma explícita en tu archivo settings.json.
  • people.googleapis.com: Proporciona acceso a la información sobre los perfiles y los contactos.
  • firebaselogging-pa.googleapis.com: Es una API interna que se usa para enviar la telemetría del producto, incluidos los eventos sobre si se aceptaron las sugerencias.
  • feedback-pa.googleapis.com: Es una API interna que se usa para enviar comentarios en el IDE.
  • apihub.googleapis.com: Es la función que usa el navegador de la API de Cloud Code.

Opcional: Configura los Controles del servicio de VPC

Si tu organización tiene un perímetro de servicio, debes agregar los siguientes recursos a tu perímetro:

  • API de Gemini para Google Cloud
  • API de Gemini Code Assist

Si usas Gemini Code Assist desde fuera del perímetro de tu servicio, también debes modificar la política de entrada para permitir el acceso a esos servicios.

Para obtener más información, consulta Configura los Controles del servicio de VPC para Gemini.

Otorga roles de IAM en un proyecto de Google Cloud

En esta sección, se describen los pasos necesarios para otorgar a los usuarios los roles de IAM de usuario y consumidor de Gemini para Google Cloud.

Console

  1. Para otorgar los roles de IAM necesarios para usar Gemini, ve a la página IAM y administración.

    Ir a IAM y administración

  2. En la columna Principal, busca una principal para la que deseas otorgar acceso a Gemini y, luego, haz clic en Editar principal en esa fila.

  3. En el panel Editar permisos, haz clic en Agregar otra función.

  4. En Selecciona un rol, selecciona Usuario de Gemini para Google Cloud.

  5. Haz clic en Agregar otro rol y selecciona Consumidor de Service Usage.

  6. Haz clic en Guardar.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. En el menú de selección de proyectos, elige un proyecto.

  3. Otorga el rol de usuario de Gemini para Google Cloud:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user

    Reemplaza PRINCIPAL por el identificador de la principal. El identificador tiene la forma user|group|serviceAccount:email o domain:domain, por ejemplo: user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com odomain:example.domain.com.

    El resultado es una lista de vinculaciones de políticas que incluye lo siguiente:

    - members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user

  4. Otorga el rol de consumidor de Service Usage:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer

    El resultado es una lista de vinculaciones de políticas que incluye lo siguiente:

    - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

Para obtener más información, consulta Otorga un solo rol y gcloud projects add-iam-policy-binding.

Todos los usuarios a los que se les otorgaron estos roles pueden acceder a las funciones de Gemini para Google Cloud en la consola de Google Cloud dentro del proyecto especificado. Para obtener más información, consulta la descripción general de Gemini para Google Cloud.

Instala el complemento Gemini Code Assist en un IDE

Los usuarios de tu organización instalan Gemini Code Assist en su IDE preferido. Para obtener más información, consulta lo siguiente:

Tareas de configuración avanzada

En lugar de usar la consola de Google Cloud o gcloud CLI para otorgar roles de IAM predefinidos, puedes hacer lo siguiente:

  • Usa las APIs de REST de IAM o las bibliotecas cliente de IAM para otorgar roles.

    Si usas estas interfaces, usa los nombres de roles completamente calificados:

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageConsumer

    Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

  • Crea y otorga roles personalizados

    Cualquier rol personalizado que crees necesita los siguientes permisos para que accedas a Gemini Code Assist:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable

  • Asignar y administrar licencias

    Cualquier rol personalizado que crees necesita los siguientes permisos para que puedas acceder a Gemini Code Assist:

    • consumerprocurement.orders.get
    • consumerprocurement.orders.licensePools..*
    • consumerprocurement.orders.licensePools.update
    • consumerprocurement.orders.licensePools.get
    • consumerprocurement.orders.licensePools.assign
    • consumerprocurement.orders.licensePools.unassign
    • consumerprocurement.orders.licensePools.enumerateLicensedUsers

Además, ten en cuenta que, para que funcione cualquiera de los permisos anteriores, la API de Gemini para Google Cloud debe estar habilitada en el mismo proyecto de Google Cloud en el que asignaste cada permiso.

¿Qué sigue?