Antes de poder usar Gemini Code Assist, tu equipo necesita para 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 8 de noviembre de 2024, con un límite de un usuario por cuenta de facturación.
Habilita la API de Gemini para Google Cloud 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 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.
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 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 las suscripción, incluido el plazo del compromiso (mensual o anual) y el la cantidad de licencias de la suscripción.
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.
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.
La facturación ahora está habilitada para Gemini. Ahora debes habilitar la API de Gemini para Google Cloud 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 Gemini para Google Cloud en un proyecto de Google Cloud
En esta sección, se describen los pasos necesarios para habilitar la La API de Gemini para Google Cloud en un proyecto de Google Cloud.
Console
Para habilitar la API de Gemini para Google Cloud, 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 los proyecto de Google Cloud a todos los usuarios que cuenten de IAM personalizados.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
En el menú del selector de proyectos, elige un proyecto.
Habilita la API de Gemini para Google Cloud con Gemini 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 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 a todos los usuarios que cuenten con 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
Para otorgar los roles de IAM necesarios para usar Gemini, ve a la página IAM y administración.
En la columna Principal, busca un principal quieres habilitar el acceso a Gemini y, luego, haz clic 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
-
In the Google Cloud console, activate 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 Otorga un solo rol y gcloud projects add-iam-policy-binding
.
Todos los usuarios a los que se les otorgaron estos roles pueden acceder funciones de Gemini para Google Cloud la consola de Google Cloud en el proyecto especificado. Para obtener más información, consulta Descripción general de Gemini para Google Cloud.
Opcional: Usa Gemini Code Assist en un IDE
Si eres un desarrollador que desea usar Gemini en su IDE, entonces 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 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.
Crear y otorgar roles personalizados
Los roles personalizados que crees necesitan los siguientes permisos para acceder a Gemini:
cloudaicompanion.companions.generateChat
cloudaicompanion.companions.generateCode
cloudaicompanion.instances.completeCode
cloudaicompanion.instances.completeTask
cloudaicompanion.instances.generateCode
cloudaicompanion.instances.generateText
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.