Configura Gemini Code Assist Standard y Enterprise

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

  1. Compra una suscripción a Gemini Code Assist Standard o Enterprise.

  2. Asigna licencias a los usuarios 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 en un proyecto de Google Cloud.

  5. Los usuarios de tu organización instalan el complemento de Gemini Code Assist para usar Gemini Code Assist Standard o Enterprise en un IDE. Este paso no es obligatorio para los usuarios de Gemini CLI ni de Gemini en Android Studio.

Compra una suscripción a Gemini Code Assist

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

Para los clientes nuevos de Gemini Code Assist con cuentas de facturación que nunca tuvieron una suscripción a Gemini Code Assist, aplicamos automáticamente créditos equivalentes a hasta 50 licencias gratuitas durante el primer mes, independientemente de la edición de Gemini Code Assist. Ten en cuenta que no puedes aumentar la cantidad de créditos gratuitos después de que se asignan los créditos de licencia gratuitos iniciales. Además, no puedes cambiar la edición de Gemini Code Assist durante el primer mes.

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

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

    Ir a Administrador de Gemini

    Se abrirá la página Administrador de Gemini.

  2. Selecciona Obtener Gemini Code Assist.

    Ten en cuenta que, si no tienes el permiso consumerprocurement.orders.place requerido, este botón estará inhabilitado. Si ya existe una suscripción a Gemini Code Assist para la cuenta de facturación asociada al proyecto, este botón se muestra como Administrar Gemini Code Assist y te permite editar tu suscripción.

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

  3. En Select Gemini Code Assist subscription Edition, selecciona una edición de Gemini Code Assist. Selecciona Compare Gemini Code Assist Editions para ver una lista detallada de las funciones disponibles en 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.

    De forma predeterminada, las suscripciones nuevas se configuran para la asignación automática de licencias. A un usuario de tu organización se le asigna automáticamente una licencia cuando usa Gemini Code Assist en un IDE compatible, siempre que se cumplan todas las siguientes condiciones:

    • El usuario seleccionó un proyecto asociado a la cuenta de facturación de la suscripción.
    • El usuario tiene el permiso de IAM cloudaicompanion.licences.selfAssign en el proyecto seleccionado.

    Después de configurar Gemini Code Assist, puedes asignar licencias manualmente.

  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.

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

Asigna licencias

Antes de usar una licencia de Gemini Code Assist, los usuarios deben tener el rol de usuario de Gemini para Google Cloud o permisos análogos en un proyecto en el que la API ya esté habilitada.

Para los clientes nuevos de Gemini Code Assist con cuentas de facturación que nunca tuvieron una suscripción a Gemini Code Assist, aplicamos automáticamente créditos equivalentes a hasta 50 licencias gratuitas durante el primer mes, independientemente de la edición de Gemini Code Assist. Ten en cuenta que no puedes aumentar la cantidad de créditos gratuitos después de que se asignan los créditos de licencia gratuitos iniciales. Además, no puedes cambiar la edición de Gemini Code Assist durante el primer mes.

De forma predeterminada, las suscripciones nuevas se configuran para la asignación automática de licencias. A un usuario de tu organización se le asigna automáticamente una licencia cuando usa Gemini Code Assist en un IDE compatible, siempre que se cumplan todas las siguientes condiciones:

  • El usuario seleccionó un proyecto asociado a la cuenta de facturación de la suscripción.
  • El usuario tiene el permiso de IAM cloudaicompanion.licences.selfAssign en el proyecto seleccionado.

Si una licencia está inactiva durante 30 días, se asignará automáticamente a otro usuario de tu organización que cumpla con las condiciones anteriores.

Después de configurar Gemini Code Assist, puedes ver las asignaciones de licencias. Para ello, navega a la página Administrador de Gemini, selecciona tu cuenta de facturación, haz clic en Administrar la suscripción a Gemini Code Assist y, luego, selecciona la pestaña Administración de licencias. Si necesitas un control más detallado sobre las asignaciones de licencias, también puedes usar esta pestaña para cambiar de la administración automática de licencias a la administración manual de licencias.

La API de Gemini para Google Cloud debe estar habilitada 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 Cloud

En esta sección, se describen los pasos necesarios para habilitar la API de Gemini para Google Cloud en un proyecto de Cloud. Gemini Code Assist requiere un proyecto de Cloud para administrar el acceso a la API, la cuota y la facturación. Por este motivo, debes habilitar la API de Gemini para Google Cloud en un proyecto de Cloud de tu elección antes de que los usuarios puedan acceder a Gemini Code Assist.

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 Habilitada. Gemini ahora está disponible en el proyecto de Cloud seleccionado para todos los usuarios que tengan los roles de IAM requeridos.

gcloud

Para usar un entorno de desarrollo local, instala y, luego, inicializa la CLI de gcloud.

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

  2. 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 Cloud diferente, agrega el parámetro --project:

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

    Reemplaza PROJECT_ID por el ID de tu proyecto de 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 Cloud especificado para todos los usuarios que tengan los roles de IAM requeridos.

Configura el firewall para el tráfico de la API entre tu IDE y Google

Además de habilitar Gemini para Google Cloud, los usuarios que se encuentran detrás de firewalls también deben permitir el tráfico a través de 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 for Google Cloud.
  • cloudcode-pa.googleapis.com: Es una API interna que proporciona funciones relacionadas con el IDE.
  • cloudresourcemanager.googleapis.com: Se usa en los IDE para los selectores de proyectos. Es posible que la API de Resource Manager no sea necesaria si los proyectos están configurados de forma explícita en tu archivo settings.json.
  • people.googleapis.com: Proporciona acceso a la información sobre perfiles y contactos.
  • firebaselogging-pa.googleapis.com: Es una API interna que se usa para enviar telemetría de productos, incluidos eventos que indican 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: La usa la función API Browser de Cloud Code.
  • lh3.googleusercontent.com y lh5.googleusercontent.com: Se usan para obtener fotos de los usuarios.

Determina las direcciones IP de los dominios predeterminados de Google Cloud

Para habilitar la conectividad desde tu IDE a las APIs de Google Cloud, tu firewall debe permitir el tráfico TCP saliente a los rangos de direcciones IP documentados públicamente de Google. Google administra estos rangos de forma dinámica.

Para mantener una lista de rangos de IP para acceder a los dominios de Google Cloud, tienes varias opciones:

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 for Google Cloud
  • API de Gemini Code Assist

Si usas Gemini Code Assist Standard o Enterprise desde fuera de tu perímetro de 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 Gemini para Google Cloud User y Service Usage Consumer.

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. Haz clic en Otorgar acceso y, luego, ingresa el nombre de la principal para la que deseas otorgar acceso a Gemini.

  3. En el panel Otorgar acceso, haz clic en Agregar otro rol.

  4. En Asignar roles, selecciona Usuario de Gemini para Google Cloud.

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

  6. Haz clic en Guardar.

gcloud

Para usar un entorno de desarrollo local, instala y, luego, inicializa la CLI de gcloud.

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

  2. 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 lo siguiente:

    • PROJECT_ID: El ID de tu proyecto de Cloud, por ejemplo,1234567890.
    • PRINCIPAL: Es el identificador de la entidad principal, por ejemplo, user:cloudysanfrancisco@gmail.com.

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

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

  3. Repite el paso anterior para el rol 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 de Gemini Code Assist

Los usuarios de tu organización instalan el complemento de Gemini Code Assist en su IDE compatible preferido. Los usuarios de IDE de JetBrains admitidos deben seguir las instrucciones de IntelliJ.

VS Code

  1. Para abrir la vista Extensiones en VS Code, haz clic en Ícono de extensión Extensiones o presiona Ctrl/Cmd+Shift+X.

  2. Busca Gemini Code Assist.

  3. Haz clic en Install.

  4. Si se te solicita, reinicia VS Code.

    Una vez que hayas instalado la extensión de forma correcta, Gemini Code Assist aparecerá en la barra de actividades y estará listo para usar. Para configurar con más detalle la instalación de Gemini Code Assist, debes especificar tus preferencias mediante la barra de tareas del nivel superior de la aplicación: navega a Código > Configuración > Configuración > Extensiones y busca Gemini Code Assist.

IntelliJ

  1. Haz clic en settings IDE and Project Settings > Plugins.
  2. En la pestaña Marketplace, busca Gemini Code Assist.
  3. Haz clic en Instalar para instalar el complemento.
  4. Cuando finalice la instalación, haz clic en Restart IDE.

  5. Cuando se reinicie el IDE, Gemini Code Assist aparecerá en la barra de actividades.

    El ícono de Gemini Code Assist aparece en la barra de actividades.

Ahora los usuarios pueden usar Gemini Code Assist Standard o Enterprise en su IDE. Obtén más información sobre las funciones compatibles:

Comienza con las siguientes guías:

Lista de directorios en los que Gemini Code Assist almacena información en caché

En la siguiente tabla, se proporciona una lista de los directorios en los que Gemini Code Assist almacena información de la extensión, como tokens de autorización:

Windows

  • %LOCALAPPDATA%/cloud-code
  • %LOCALAPPDATA%/google-vscode-extension

macOS

  • ~/Library/Application Support/cloud-code
  • ~/Library/Application Support/google-vscode-extension

Linux

  • ~/.cache/cloud-code
  • ~/.cache/google-vscode-extension

Accede a tu cuenta de Google y selecciona un proyecto de Google Cloud

Una vez que los usuarios instalen Gemini Code Assist en sus IDEs, deberán acceder a sus Cuentas de Google y, si es la primera vez que usan Gemini Code Assist Standard o Enterprise en su IDE, deberán seleccionar un proyecto de Google Cloud. Este es el mismo proyecto que se usó para configurar Gemini Code Assist y se usa para administrar el acceso a la API, la cuota y la facturación.

VS Code

Si seleccionas un proyecto de Google Cloud sin la API de Gemini para Google Cloud habilitada, recibirás una notificación que te dará la opción de habilitar la API desde el IDE. Selecciona Habilitar la API en la ventana de notificación para habilitar la API para tu proyecto. Para obtener más información, consulta Configura Gemini Code Assist Standard y Enterprise para un proyecto.

Si prefieres seguir la guía Code with Gemini Code Assist directamente en tu IDE, haz clic en Launch VS Code y sigue los pasos de la guía para conectarte a Google Cloud y activar Gemini Code Assist Standard o Enterprise.

Inicia VS Code

De lo contrario, sigue estos pasos:

  1. Inicia tu IDE.

  2. En la barra de actividades, haz clic en Gemini Code Assist.

  3. En el panel de chat de Gemini Code Assist, haz clic en Acceder a Google Cloud.

  4. Cuando se te solicite permitir que Gemini Code Assist abra el sitio web externo, haz clic en Abrir.

  5. Sigue las instrucciones para acceder a tu Cuenta de Google.

  6. Cuando se te pregunte si descargaste Gemini Code Assist de Google, haz clic en Acceder.

    Ya te conectaste a Google Cloud.

    A continuación, para seleccionar un proyecto de Google Cloud que tenga habilitada la API de Gemini para Google Cloud, sigue estos pasos:

  7. En la barra de estado de Gemini Code Assist, haz clic en Gemini Code Assist.

    La barra de estado de Gemini está disponible.

  8. En el menú de Gemini Code Assist, selecciona Select Gemini Code project.

  9. Selecciona un proyecto de Google Cloud que tenga habilitada la API de Gemini para Google Cloud.

    Gemini Code Assist Standard o Enterprise está listo para usarse.

    El ícono de Gemini en la barra de estado se establece en normal.

IntelliJ

Para acceder a tu Cuenta de Google, sigue estos pasos:

  1. En la barra de actividades, haz clic en spark Gemini Code Assist.

  2. Haz clic en Acceder a Google. También puedes hacer clic en Copiar vínculo y pegar la URL en tu navegador.

  3. En la página que se abre en el navegador web, selecciona tu Cuenta de Google.

  4. En la pantalla en la que se te pide que te asegures de haber descargado esta app de Google, haz clic en Acceder.

    Gemini Code Assist ahora tiene autorización para acceder a tu cuenta.

    A continuación, si es la primera vez que usas Gemini Code Assist Standard o Enterprise en tu IDE, debes seleccionar un proyecto de Google Cloud. Para ello, sigue estos pasos:

  5. Regresa a tu IDE. En la ventana de la herramienta Gemini Code Assist, si aceptas que Google habilite las APIs necesarias para usar Gemini Code Assist en tu nombre para el proyecto seleccionado, haz clic en Selecciona un proyecto de GCP para continuar.

  6. En el diálogo Select Google Cloud Project, busca y selecciona tu proyecto de Google Cloud y, luego, haz clic en OK.

  7. Haz clic en FINALIZAR.

Tu proyecto de Google Cloud está seleccionado con la API de Gemini Code Assist habilitada. Ya puedes usar Gemini Code Assist Standard o Enterprise en tu IDE.

Tareas de configuración avanzada

En las siguientes secciones, se describen las tareas de configuración avanzadas que puedes realizar para personalizar Gemini Code Assist.

Consideraciones avanzadas de IAM

En lugar de usar la consola de Google Cloud o gcloud 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 puedas acceder a Gemini Code Assist Standard y Enterprise:

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

  • Asignar y administrar licencias

    Cualquier rol personalizado que crees necesita los siguientes permisos para que puedas asignar y administrar licencias de 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

Ten en cuenta también que, para que cualquiera de los permisos anteriores funcione, la API de Gemini para Google Cloud debe estar habilitada en el mismo proyecto de Google Cloud en el que asignaste cada permiso.

Cambia el canal de versiones del proyecto de Google Cloud

Lanzamos las funciones de Gemini Code Assist en diferentes canales de versiones, ya sea con disponibilidad general o en versión preliminar. Cuando configuras Gemini Code Assist, tu proyecto se establece automáticamente en el canal de versiones de disponibilidad general.

Puedes cambiar el canal de versiones de Gemini Code Assist al canal de versión preliminar o volver al canal de disponibilidad general en cualquier momento.

¿Qué sigue?