Configura Gemini Code Assist

Antes de poder usar Gemini Code Assist, tu equipo necesita para 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 la 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 de Cloud Code para usarlo. Gemini Code Assist en un IDE.

Compra una suscripción a Gemini Code Assist

Los pasos necesarios para comprar una suscripción a Gemini Code Assist dependen de la edición que compres: Enterprise o Standard. Para ver una lista de las funciones disponibles en cada edición, consulta Funciones compatibles.

Edición Empresarial

Gemini Code Assist Enterprise está disponible por USD 19 por 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.

Edición Standard

La edición Standard de Gemini Code Assist está disponible para probarla sin un suscripción sin costo hasta el 8 de noviembre de 2024, limitada a un usuario por facturación de servicio predeterminada. Las organizaciones con varios usuarios por cuenta de facturación deben realizar compras. una suscripción, como se describe en esta sección.

Si ya tienes contratos 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 el Rol de roles/consumerprocurement.orderAdmin. Como alternativa, puedes agregar el permiso a un rol personalizado.
  1. Ve a la página de Gemini para Google Cloud.

    Ir a Gemini para Google Cloud

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

  2. Haz clic en 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 suscripción a Gemini Code Assist.

  3. 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.
    • Período de suscripción (mensual o anual) Con una suscripción anual, puedes reciben una tarifa con descuento que se cobra por mes en lugar que un pago único.
    • Renovación automática de la suscripción después del plazo del compromiso (mensualmente) o anualmente). 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.
  4. Para revisar los detalles de la suscripción, haz clic en Continuar.

  5. Si aceptas las condiciones, selecciona Acepto las condiciones de esta compra y, luego, haz clic en Confirmar suscripción.

  6. Haz clic en Siguiente: Administra las asignaciones de licencias de Gemini.

Se compró la suscripción a Gemini Code Assist. Ahora, necesitas 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 el En la consola 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 quieres cambiar y, luego, haz clic en Modificar la 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 quieres 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: Es el ID de la cuenta de facturación.
  • ORDER_ID: Es 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 asignó de forma correcta.

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 lo 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 los proyecto de Google Cloud a todos los usuarios que cuenten de IAM personalizados.

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: que se usa para verificar que el proyecto de Gemini Code Assist del usuario configurar correctamente.
  • 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: que usa la función del navegador de la API de Cloud Code.

Otorga roles de IAM en un proyecto de Google Cloud

En esta sección, se describen los pasos necesarios para otorgar acceso al usuario de Gemini para Google Cloud y los roles de IAM de consumidor de Service Usage.

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 funciones de Gemini para Google Cloud la consola de Google Cloud en el proyecto especificado. Para obtener más información, consulta Descripción general de Gemini para Google Cloud.

Instala el complemento de Cloud Code para usar 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

    Todos los roles personalizados que crees deben tener 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

    Todos los roles personalizados que crees deben tener los siguientes permisos para que accedas 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?