Configura Gemini Code Assist Standard y Enterprise

Antes de que puedas usar Gemini Code Assist estándar o empresarial, 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 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 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.

Compra una suscripción a Gemini Code Assist

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

En el caso de 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 asignen los créditos iniciales de la licencia gratuita. 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.

    Ve 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 con el proyecto, este botón aparecerá como Administrar Gemini Code Assist y te permitirá editar tu suscripción.

    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.

  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 compra 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 Gemini Code Assist, se debe asignar una licencia a cada usuario individual al que se le debe otorgar acceso en la organización.

En el caso de 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 asignen los créditos iniciales de la licencia gratuita. Además, no puedes cambiar la edición de Gemini Code Assist durante el primer mes.

Console

Para asignar licencias de Gemini a usuarios individuales en la Console de la API, debes tener los siguientes permisos en la cuenta de facturación:

  • billing.accounts.get
  • billing.accounts.list
  • consumerprocurement.orders.get
  • consumerprocurement.orders.list
  • consumerprocurement.orders.modify
  • consumerprocurement.orders.place
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.update
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.unassign

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

    Ir a Gemini para Google Cloud

  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, usa el método billingAccounts.orders.licensePool.assign.

  1. Asegúrate de tener el permiso de Identity and Access Management (IAM) consumerprocurement.licensePools.assign en la cuenta de facturación que contiene el grupo de licencias cuya licencia deseas asignar.

  2. Crea un archivo JSON que contenga la siguiente información:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    En el ejemplo anterior, USER_EMAILS es una lista de cuentas de usuario separadas por comas a las que se les asigna la licencia. Por ejemplo, "dana@example.com", "lee@example.com"

  3. Usa cURL para llamar al método:

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

    Reemplaza lo siguiente:

    • JSON_FILE_NAME: Es la ruta de acceso del archivo JSON que creaste en el paso 2.
    • PROJECT_ID: Es el ID de un proyecto. El uso de la cuota y los cargos asociados con la solicitud a la API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID: Es el ID de la cuenta de facturación asociada con el grupo de licencias.
    • ORDER_ID: el ID del pedido. Si no conoces el ID del pedido, puedes enumerar los pedidos asociados con tu cuenta de facturación para recuperarlo.

Si se realiza de forma correcta, la respuesta se verá como la siguiente:

  {}

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 Cloud

En esta sección, se describen los pasos necesarios para habilitar la API de Gemini para Google Cloud en un proyecto de 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 Cloud seleccionado para todos los usuarios que tengan los roles de IAM requeridos.

gcloud

Para usar un entorno de desarrollo local, instala y 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 API entre tu IDE y Google

Además de habilitar Gemini para Google Cloud, los usuarios detrás de firewalls también deben permitir que el tráfico pase por 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 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 de productos, 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.
  • lh3.googleusercontent.com y lh5.googleusercontent.com: Se usan para obtener fotos del usuario.

Determina las direcciones IP de los dominios predeterminados de Google Cloud

Para habilitar la conectividad de tu IDE a las APIs de Google Cloud, el 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 para Google Cloud
  • API de Gemini Code Assist

Si usas Gemini Code Assist Standard o Enterprise 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 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

Para usar un entorno de desarrollo local, instala y 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: El identificador del 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 la API 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

Los usuarios de tu organización instalan el complemento Gemini Code Assist en su IDE compatible preferido.

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, especifica 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 Install 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 actividad.

    Aparecerá el ícono de Gemini Code Assist 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 directorios en los que Gemini Code Assist almacena información de la extensión, como tokens de autenticació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 Google y selecciona un proyecto de Google Cloud

Una vez que los usuarios hayan instalado Gemini Code Assist en sus IDE, 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, deben seleccionar un proyecto de Google Cloud.

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 de tu proyecto. Para obtener más información, consulta Configura Gemini Code Assist Standard y Enterprise para un proyecto.

Si prefieres seguir la explicación Cómo codificar con Gemini Code Assist directamente en tu IDE, haz clic en Launch VS Code y sigue los pasos de la explicación para conectarte a Google Cloud y activar Gemini Code Assist Standard o Enterprise.

Cómo iniciar 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 indicaciones 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ú 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 su uso.

    El ícono de Gemini en la barra de estado se establece como 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.

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

  4. En la pantalla que te solicita 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 permitir que Google habilite las APIs necesarias para usar Gemini Code Assist en tu nombre para el proyecto que seleccionaste, haz clic en Select a GCP project 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.

Selecciona tu proyecto de Google Cloud 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 lugar de usar la consola de API 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 accedas 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 las 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

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?