Configura Gemini Code Assist

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

Antes de poder usar Gemini Code Assist, tu equipo necesita para 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 probarlo sin costo hasta el 8 de noviembre de 2024, limitado a un usuario por cuenta de facturación.

2. Habilita la API de Cloud AI Companion en un proyecto de Google Cloud. Por lo general, un administrador realiza este paso.

3. Otorga roles de Identity and Access Management (IAM) en un proyecto de Google Cloud. Por lo general, un administrador realiza este paso.

4. Opcional: Para usar Gemini Code Assist en un IDE, instalar el complemento de Cloud Code.

Opcional: Compra una suscripción a Gemini Code Assist

Gemini Code Assist está disponible para probarlo sin una suscripción en sin costo hasta el 8 de noviembre 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 un suscripción, como se describe en esta sección. Si ya tienes contratos existentes con Google Cloud, comunícate con nuestro equipo de Ventas antes de comprar un suscripción.

Nota: Debes tener la billing.subscriptions.create permiso de Identity and Access Management (IAM) para comprar un suscripción a Gemini. El billing.subscriptions.create permiso está incluido en la Rol de IAM roles/billing.admin, o puedes agregar el permiso a un rol personalizado.

1. En la consola de Google Cloud, 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 Gemini Code Assist.

   Se mostrará el panel de Gemini Code Assist.

3. Haz clic en Obtener Gemini Code Assist.

4. Si se te solicita, selecciona una cuenta de facturación y, luego, haz clic en Ir al Administrador de la página de Gemini

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

5. En Configurar suscripción, completa los campos para configurar las suscripción, incluido el plazo del compromiso (mensual o anual) y el la cantidad de licencias de 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 tu suscripción después de del plazo del compromiso (mensual o anual). La renovación automática mantiene tus suscripciones licencias activas. Si la suscripción no se renueva automáticamente, finalizará cuando finaliza el plazo actual y tienes que pasar por el proceso de compra para recuperar las licencias.

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

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

Se habilitó la facturación para Gemini. Ahora debes habilitar la API de Cloud AI Companion en uno o más proyectos asociados con esta cuenta de facturación. Usuarios no verá Gemini hasta que lo actives en al menos uno en un proyecto final.

Habilita la API de Cloud AI Companion en un proyecto de Google Cloud

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

Console

1. Para habilitar la API de Cloud AI Companion, ve a la 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 actualizará y mostrará el estado Habilitada. Gemini ahora está disponible en los proyecto de Google Cloud a todos los usuarios que cuenten de IAM personalizados.

gcloud

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

   Activar Cloud Shell

2. En el menú del selector de proyectos, elige 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 en otra proyecto de Google Cloud, agrega 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 usuarios que tienen los roles de IAM necesarios.

Otorga roles de IAM en un proyecto de Google Cloud

En esta sección, se describen los pasos necesarios para otorgarle al usuario Cloud AI Companion. y los roles de IAM de consumidor de Service Usage.

Console

1. Para otorgar los roles de IAM necesarios Gemini, ve a la página de IAM y Administrador.

   Ir a IAM y administración

2. En la columna Principal, busca un principal quieres habilitar el acceso a Gemini y, luego, haz clic Editar principal en esa fila.

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

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

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

6. Haz clic en Guardar.

gcloud

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

   Activar Cloud Shell

2. En el menú del selector de proyectos, elige un proyecto.

3. Otorga el rol de usuario de Cloud AI Companion:

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

   Reemplaza PRINCIPAL por el identificador del el 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
   

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

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ómo programar con Gemini Code Assist
• Editor de Cloud Shell: Cómo programar con Gemini Code Assist
• Cloud Code para VS Code: Cómo programar con Gemini Code Assist
• Cloud Code para IntelliJ y otros IDE de JetBrains: Cómo programar con Gemini Code Assist

Tareas de configuración avanzada

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

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

  Si usas estas interfaces, usa los nombres de función 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.

• Crear y otorgar roles personalizados

  Todos los roles personalizados que crees deben tener los siguientes permisos para acceder a Gemini:

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

¿Qué sigue?

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