Antes de que puedas usar Gemini Code Assist, tu equipo debe realizar los pasos de configuración que se describen en este documento:
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.
Habilita la API de Cloud AI Companion en un proyecto de Google Cloud. Por lo general, un administrador realiza este paso.
Otorga roles de Identity and Access Management (IAM) en un proyecto de Google Cloud. Por lo general, un administrador realiza este paso.
Opcional: Para usar Gemini Code Assist en un IDE, instala el complemento de Cloud Code.
Opcional: Compra una suscripción a Gemini Code Assist
Gemini Code Assist está disponible para probar sin suscripción y 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 existentes con Google Cloud, comunícate con nuestro equipo de ventas antes de comprar una suscripción.
En la consola de Google Cloud, ve a la página Gemini para Google Cloud.
Se abrirá la página Gemini para Google Cloud.
Selecciona Gemini Code Assist.
Se mostrará el panel de Gemini Code Assist.
Haz clic en Obtener Gemini Code Assist.
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.
En Configurar suscripción, completa los campos para configurar la suscripción, incluido el plazo del compromiso (mensual o anual) y la cantidad de licencias de la suscripción.
Elige si deseas renovar automáticamente la suscripción después del período 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 realizar el proceso de compra de nuevo para recuperar las licencias.
Para revisar los detalles de la suscripción, haz clic en Continuar.
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. Los usuarios no verán Gemini hasta que lo actives en al menos un proyecto.
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 API de Cloud AI Companion en un proyecto de Google Cloud.
Console
Para habilitar la API de Cloud AI Companion, ve a la página Gemini para Google Cloud.
En el selector de proyectos, elige un proyecto.
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 tengan los roles de IAM necesarios.
gcloud
-
En la consola de Google Cloud, activa Cloud Shell.
En el menú del selector de proyectos, elige un proyecto.
Habilita la API de Cloud AI Companion para Gemini con el comando
gcloud services enable
:gcloud services enable cloudaicompanion.googleapis.com
Si deseas habilitar la API de Cloud AI Companion en un proyecto diferente de Google Cloud, 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 para Google Cloud ahora está disponible en el proyecto de Google Cloud especificado para todos los usuarios que tengan 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 otorgar a los usuarios los roles de IAM de usuario de Cloud AI Companion y de consumidor de Service Usage.
Console
Si quieres otorgar los roles de IAM necesarios para usar Gemini, ve a la página IAM y administración.
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.
En el panel Editar permisos, haz clic en
Agregar otra función.En Selecciona un rol, elige Usuario de Cloud AI Companion.
Haz clic en Agregar otro rol y selecciona Consumidor de Service Usage.
Haz clic en Guardar.
gcloud
-
En la consola de Google Cloud, activa Cloud Shell.
En el menú del selector de proyectos, elige un proyecto.
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 de la principal. El identificador tiene la formauser|group|serviceAccount:email
odomain: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
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 Cómo otorgar una sola función 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.
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ódigo con Gemini Code Assist
- Cloud Code para VS Code: Code 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 otorgar roles de IAM predefinidos, puedes realizar cualquiera de las siguientes acciones:
Usa las APIs de REST de IAM o las bibliotecas cliente de IAM para otorgar funciones.
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 funciones, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Crear y otorgar roles personalizados
Los roles personalizados que crees necesitarán 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 los tipos de asistencia de IA generativa disponibles en Gemini para Google Cloud.
- Descubre cómo Gemini para Google Cloud usa tus datos.
- Descubre cómo acceder y gestionar los controles de administrador de Gemini.