Antes de poder usar Gemini Code Assist, tu equipo necesita para realizar los pasos de configuración que se describen en este documento:
Asignar licencias a usuarios individuales de la organización
Habilita la API de Gemini para Google Cloud en un proyecto de Google Cloud.
Otorga roles de Identity and Access Management (IAM) en un proyecto de Google Cloud.
Los usuarios de tu organización instalan el complemento de Cloud Code para usarlo. Gemini Code Assist en un IDE.
Compra una suscripción a Gemini Code Assist
Los pasos necesarios para comprar una suscripción a Gemini Code Assist dependen de la edición que compres: Enterprise o Standard. Para ver una lista de las funciones disponibles en cada edición, consulta Funciones compatibles.
Edición Empresarial
Gemini Code Assist Enterprise está disponible por USD 19 por mes por usuario con un compromiso de 12 meses hasta el 31 de marzo de 2025. Comunícate con nuestro equipo de Ventas para aprovechar esta oferta promocional.
Edición Standard
La edición Standard de Gemini Code Assist está disponible para probarla sin un suscripción sin costo hasta el 8 de noviembre de 2024, limitada a un usuario por facturación de servicio predeterminada. Las organizaciones con varios usuarios por cuenta de facturación deben realizar compras. una suscripción, como se describe en esta sección.
Si ya tienes contratos con Google Cloud, Comunícate con nuestro equipo de ventas antes de comprar una suscripción.
Nota: Debes tener el permiso de Identity and Access Management (IAM)consumerprocurement.orders.place
para comprar una suscripción a Gemini. El permiso consumerprocurement.orders.place
se incluye en
el
Rol de IAM roles/billing.admin
o el
Rol de roles/consumerprocurement.orderAdmin
.
Como alternativa, puedes agregar el permiso a un rol personalizado.
Ve a la página de Gemini para Google Cloud.
Se abrirá la página Gemini para Google Cloud.
Haz clic en Obtener Gemini Code Assist. Si tu proyecto ya tiene Gemini Code Assist, este texto mostrará Administrar Gemini Code Assist.
Se abrirá la página Obtener suscripción a Gemini Code Assist.
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.
- Período de suscripción (mensual o anual) Con una suscripción anual, puedes reciben una tarifa con descuento que se cobra por mes en lugar que un pago único.
- Renovación automática de la suscripción después del plazo del compromiso (mensualmente) o anualmente). La renovación automática mantiene activas tu suscripción y tus licencias. Si la suscripción no se renueva automáticamente, finalizará cuando finalice el plazo actual y deberás volver a realizar el proceso de compra y reasignar las licencias.
Para revisar los detalles de la suscripción, haz clic en Continuar.
Si aceptas las condiciones, selecciona Acepto las condiciones de esta compra y, luego, haz clic en Confirmar suscripción.
Haz clic en Siguiente: Administra las asignaciones de licencias de Gemini.
Se compró la suscripción a Gemini Code Assist. Ahora, necesitas administrar las asignaciones de licencias de Gemini en tu organización.
Asignar licencias
Antes de usar Gemini Code Assist, cada usuario de tu organización necesita una licencia.
Console
Para asignar licencias de Gemini a usuarios individuales en el En la consola de Google Cloud, debes tener los siguientes permisos:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
Ve a la página Administrador de Gemini.
Elige la suscripción que quieres cambiar y, luego, haz clic en Modificar la suscripción.
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.
Selecciona uno o más usuarios de la lista y, luego, haz clic en Siguiente.
Elige los servicios de Gemini para los que quieres asignar licencias.
Haz clic en Asignar licencias.
API
Para asignar licencias de Gemini con la API, debes tener el permiso consumerprocurement.licensePools.assign
.
Método HTTP: POST
URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/
Reemplaza lo siguiente:
BILLING_ACCOUNT_ID
: Es el ID de la cuenta de facturación.ORDER_ID
: Es la política de IAM.
Cuerpo de la solicitud:
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
El resultado es similar a este:
{}
La respuesta estará vacía si la licencia se asignó de forma correcta.
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 lo 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 Google Cloud
En esta sección, se describen los pasos necesarios para habilitar 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 de Gemini para Google Cloud.
En el selector de proyectos, elige un proyecto.
Haz clic en Habilitar.
La página se actualiza y muestra el estado Enabled. 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ú de selección de proyectos, elige un proyecto.
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 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 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 los usuarios que tengan los roles de IAM requeridos.
APIs requeridas para usuarios detrás de firewalls
Además de habilitar la API de Gemini para Google Cloud, es posible que los usuarios detrás de firewalls también deban habilitar las siguientes APIs:
oauth2.googleapis.com
: Se usa para acceder a Google Cloud.serviceusage.googleapis.com
: que se usa para verificar que el proyecto de Gemini Code Assist del usuario configurar correctamente.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 archivosettings.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 del producto, 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
: que usa la función del navegador de la API de Cloud Code.
Otorga roles de IAM en un proyecto de Google Cloud
En esta sección, se describen los pasos necesarios para otorgar acceso al usuario de Gemini para Google Cloud 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 una principal para la que deseas otorgar 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, selecciona Usuario de Gemini para Google Cloud.
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ú de selección de proyectos, elige un proyecto.
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
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.
Instala el complemento de Cloud Code para usar Gemini Code Assist en un IDE
Los usuarios de tu organización instalan Gemini Code Assist en su IDE preferido. Para obtener más información, consulta lo siguiente:
- Cloud Workstations: Crea código 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: Crea código 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 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
Todos los roles personalizados que crees deben tener los siguientes permisos para que accedas a Gemini Code Assist:
cloudaicompanion.companions.generateChat
cloudaicompanion.companions.generateCode
cloudaicompanion.instances.completeCode
cloudaicompanion.instances.completeTask
cloudaicompanion.instances.generateCode
cloudaicompanion.instances.generateText
serviceusage.services.enable
Asignar y administrar licencias
Todos los roles personalizados que crees deben tener los siguientes permisos para que accedas a 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?
- Obtén más información sobre la tipos de asistencia para IA generativa disponibles en Gemini Code Assist para Google Cloud.
- Aprendizaje cómo Gemini Code Assist para Google Cloud usa tus datos.
- Aprendizaje cómo acceder a los controles de administrador de Gemini Code Assist y administrarlos.
- Obtén información para configurar la personalización del código.