Configura Gemini Code Assist para un proyecto

Nota: Gemini Code Assist está disponible para probar sin costo hasta el 11 de julio de 2024, con un límite de un usuario por cuenta de facturación. Las organizaciones pueden comprar una licencia aquí.

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

1. Opcional: Compra una suscripción a Gemini Code Assist. Gemini Code Assist está disponible para probar sin costo hasta el 11 de julio de 2024, con un límite de un usuario por cuenta de facturación.

2. Activa Gemini Code Assist en un proyecto de Google Cloud. Por lo general, un administrador realiza este paso.

3. Para usar Gemini Code Assist en un IDE, instala el complemento de Cloud Code (opcional).

Opcional: Compra una suscripción a Gemini Code Assist

Gemini Code Assist está disponible para probarse sin una suscripción sin costo hasta el 11 de julio de 2024, con un límite de un usuario por cuenta de facturación. Las organizaciones con varios usuarios por cuenta de facturación deben comprar una suscripción como se describe en esta sección. Si tienes contratos con Google Cloud, comunícate con nuestro equipo de ventas antes de comprar una suscripción.

Nota: Debes tener el permiso billing.subscriptions.create de Identity and Access Management (IAM) para comprar una suscripción a Gemini. El permiso billing.subscriptions.create se incluye en la función de IAM roles/billing.admin, o puedes agregar el permiso a una función personalizada.

1. En la consola de Google Cloud, ve a la página Gemini para Google Cloud.

   Ir a Gemini para Google Cloud

2. Haz clic en Comenzar a usar Gemini.

3. Si se te solicita, selecciona una cuenta de facturación y, luego, haz clic en Ir a la página Admin for Gemini.

4. En Configurar suscripción, completa los campos para configurar la suscripción, incluido el período del compromiso (mensual o anual) y la cantidad de licencias en la suscripción.

   Nota: Una suscripción anual te cobra el precio anual con descuento todos los meses en lugar de un pago único.

   Elige si quieres renovar automáticamente la suscripción después del plazo del compromiso (mensual o anual). La renovación automática mantiene activas la suscripción y las licencias. Si la suscripción no se renueva automáticamente, finalizará cuando finalice el período actual y deberás volver a realizar el proceso de compra para recuperar las licencias.

5. Para revisar los detalles de la suscripción, haz clic en Continuar.

6. Si aceptas las condiciones, haz clic en Completar compra y, luego, confirma tu suscripción.

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

Activa Gemini Code Assist en un proyecto de Google Cloud

Para activar Gemini Code Assist en un proyecto de Google Cloud, un administrador debe habilitar la API de Cloud AI Companion y otorgar a los usuarios los roles de IAM de usuario y visualizador de Service Usage de Cloud AI Companion.

Console

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

   Ir a Gemini para Google Cloud

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

3. Haz clic en Habilitar.

   La página se actualizará y mostrará el estado Habilitada. Gemini ahora está disponible en el proyecto de Google Cloud seleccionado para todos los usuarios que tienen los roles de IAM necesarios.

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

   Ir a IAM y administración

5. En la columna Principal, busca una principal para la que quieras habilitar el acceso a Gemini y, luego, haz clic en Editar principal en esa fila.

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

7. En Selecciona un rol, elige Usuario de Cloud AI Companion.

8. Haz clic en Agregar otro rol y selecciona Visualizador de Service Usage.

9. Haz clic en Guardar.

gcloud

1. En la consola de Google Cloud, activa Cloud Shell.

   Activar Cloud Shell

2. En la lista desplegable del selector de proyectos, selecciona un proyecto.

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

   gcloud services enable cloudaicompanion.googleapis.com
   

   Si quieres habilitar la API de Cloud AI Companion para 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 al siguiente:

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

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

4. Otorga las dos funciones de IAM necesarias para usar Gemini:

   1. Otorga el rol Usuario de Cloud AI Companion:

      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:[e-mail], group:[e-mail], serviceAccount:[e-mail] 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
      

   2. Otorga el rol Visualizador de Service Usage:

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

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

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

   Para obtener más información, consulta Cómo otorgar 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 en la consola de Google Cloud dentro del proyecto especificado. Para obtener más información, consulta Cómo usar Gemini para obtener asistencia y desarrollo con IA.

Opcional: Usa Gemini Code Assist en un IDE

Si eres desarrollador y quieres usar Gemini en tu IDE, debes instalar el complemento de Cloud Code. Para obtener más información, consulta lo siguiente:

• Cloud Workstations: Código con Gemini Code Assist
• Editor de Cloud Shell: Code with Gemini Code Assist
• Cloud Code para VS Code: Code with Gemini Code Assist
• Cloud Code para IntelliJ y otros IDE de JetBrains: Code with Gemini Code Assist

Tareas de configuración avanzada

En lugar de usar la consola de Google Cloud o gcloud CLI para otorgar roles predefinidos de IAM, puedes realizar cualquiera de las siguientes acciones:

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

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

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageViewer

  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 función personalizada que crees necesita los siguientes permisos para acceder a Gemini:

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • serviceusage.services.get

¿Qué sigue?

• Obtén más información sobre los tipos de asistencia de IA generativa disponibles en Gemini para Google Cloud.
• Descubre cómo Gemini para Google Cloud usa tus datos.
• Obtén más información para acceder a los controles de administrador de Gemini y administrarlos.