Configurar Gemini Code Assist Standard y Enterprise

Antes de poder utilizar Gemini Code Assist Standard o Enterprise, su equipo debe realizar los pasos de configuración que se describen en este documento:

  1. Compre una suscripción a Gemini Code Assist Standard o Enterprise .

  2. Asignar licencias a usuarios individuales en su organización .

  3. Habilite la API de Gemini para Google Cloud en un Google Cloud proyecto .

  4. Otorgar roles de Gestión de Identidad y Acceso (IAM) en un Google Cloud proyecto .

  5. Los usuarios de su organización instalan el complemento Gemini Code Assist para usar Gemini Code Assist Standard o Enterprise en un IDE.

Comprar una suscripción a Gemini Code Assist

Para obtener una lista de las características disponibles en cada edición, consulte Funciones compatibles .

Para los nuevos clientes de Gemini Code Assist con cuentas de facturación que nunca tuvieron una suscripción, aplicamos automáticamente créditos equivalentes a hasta 50 licencias gratuitas durante el primer mes, independientemente de la edición de Gemini Code Assist . Tenga en cuenta que no puede aumentar la cantidad de créditos gratuitos una vez asignados los créditos iniciales de licencias gratuitas. Además, no puede cambiar de edición de Gemini Code Assist durante el primer mes.

Si tiene contratos existentes con Google Cloud, comuníquese con nuestro equipo de ventas antes de comprar una suscripción.

Nota: Para adquirir una suscripción a Gemini, debe tener el permiso consumerprocurement.orders.place de Gestión consumerprocurement.orders.place Identidad y Acceso (IAM) en la cuenta de facturación. Este permiso se incluye en el rol de IAM roles/billing.admin o roles/consumerprocurement.orderAdmin . También puede agregarlo a un rol personalizado.

  1. Vaya a la página de administración de Gemini .

    Vaya a Administración para Gemini

    Se abre la página de administración de Gemini .

  2. Seleccione Obtener asistencia con el código Gemini .

    Tenga en cuenta que si no tiene el permiso consumerprocurement.orders.place requerido, este botón estará deshabilitado. Si ya existe una suscripción a Gemini Code Assist para la cuenta de facturación asociada al proyecto, este botón se mostrará como "Administrar Gemini Code Assist" y le permitirá editar su suscripción .

    Se abre la página de suscripción de Get Gemini Code Assist .

  3. En la sección "Seleccionar edición de suscripción de Gemini Code Assist" , seleccione una edición de Gemini Code Assist. Seleccione "Comparar ediciones de Gemini Code Assist" para ver una lista detallada de las funciones disponibles en cada edición .

    Luego, seleccione Continuar .

  4. En Configurar suscripción , complete los campos para configurar la suscripción, incluidos lo siguiente:

    • Nombre de la suscripción.
    • Número de licencias de la suscripción. Tenga en cuenta que si adquiere la edición Enterprise, deberá adquirir al menos 10 licencias.
    • Periodo de suscripción (mensual o anual). Con una suscripción anual, se ofrece una tarifa con descuento que se cobra mensualmente en lugar de un pago único.

  5. Para confirmar la suscripción, seleccione Continuar .

  6. Si acepta los términos, seleccione Acepto los términos de esta compra y luego seleccione Confirmar suscripción .

  7. Seleccione Siguiente: Administrar asignaciones de licencias de Gemini .

Ya se ha adquirido la suscripción para Gemini Code Assist Standard o Enterprise. Ahora debe gestionar las asignaciones de licencias de Gemini en su organización.

Asignar licencias

Antes de utilizar Gemini Code Assist, se debe asignar una licencia a cada usuario individual al que se le debe otorgar acceso en la organización.

Para los nuevos clientes de Gemini Code Assist con cuentas de facturación que nunca tuvieron una suscripción, aplicamos automáticamente créditos equivalentes a hasta 50 licencias gratuitas durante el primer mes, independientemente de la edición de Gemini Code Assist . Tenga en cuenta que no puede aumentar la cantidad de créditos gratuitos una vez asignados los créditos iniciales de licencias gratuitas. Además, no puede cambiar de edición de Gemini Code Assist durante el primer mes.

Consola

Para asignar licencias de Gemini a usuarios individuales en elGoogle Cloud consola, debe tener los siguientes permisos en la cuenta de facturación:

  • billing.accounts.get
  • billing.accounts.list
  • consumerprocurement.orders.get
  • consumerprocurement.orders.list
  • consumerprocurement.orders.modify
  • consumerprocurement.orders.place
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.update
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.unassign

  1. Vaya a la página de administración de Gemini .

    Vaya a Gemini para Google Cloud

  2. Seleccione la suscripción que desea cambiar y luego haga clic en Modificar suscripción .

  3. Haga clic en Asignar licencias . Aparecerá un cuadro de diálogo de selección de usuarios. Para buscar usuarios específicos, escriba su nombre en el cuadro de búsqueda.

  4. Seleccione uno o más usuarios de la lista y luego haga clic en Siguiente .

  5. Seleccione los servicios de Gemini para los que desea asignar licencias.

  6. Haga clic en Asignar licencias .

API

Para asignar licencias de Gemini con la API, utilice el método billingAccounts.orders.licensePool.assign .

  1. Asegúrese de tener el permiso de Administración de identidad y acceso (IAM) consumerprocurement.licensePools.assign en la cuenta de facturación que contiene el grupo de licencias cuya licencia desea asignar.

  2. Crea un archivo JSON que contenga la siguiente información:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Donde USER_EMAILS es una lista separada por comas de las cuentas de usuario a las que se les asigna la licencia. Por ejemplo, "dana@example.com", "lee@example.com" .

  3. Utilice cURL para llamar al método:

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

    Reemplace lo siguiente:

    • JSON_FILE_NAME : la ruta del archivo JSON que creó en el paso 2.
    • PROJECT_ID : ID del proyecto. El uso de cuota y los cargos asociados a la solicitud de API se aplican a este proyecto.
    • BILLING_ACCOUNT_ID : el ID de la cuenta de facturación asociada con el grupo de licencias.
    • ORDER_ID : ID del pedido. Si no conoce el ID del pedido, puede recuperarlo listando los pedidos asociados a su cuenta de facturación .

Si tiene éxito, la respuesta es similar a la siguiente:

  {}

Ahora debe habilitar la API de Gemini para Google Cloud en uno o más proyectos asociados a esta cuenta de facturación. Los usuarios no verán Gemini Code Assist hasta que lo active en al menos un proyecto.

Habilite la API de Gemini para Google Cloud en un Google Cloud proyecto

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

Consola

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

    Vaya a Gemini para Google Cloud

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

  3. Haga clic en Habilitar .

    La página se actualiza y muestra el estado "Habilitado" . Gemini ya está disponible en la aplicación seleccionada.Google Cloud proyecto a todos los usuarios que tienen los roles de IAM requeridos.

CLI de gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  1. En el menú selector de proyectos, seleccione un proyecto.

  2. Habilite la API de Gemini para Google Cloud mediante el comando gcloud services enable :

    gcloud services enable cloudaicompanion.googleapis.com

    Si desea habilitar la API de Gemini para Google Cloud en una nube diferenteGoogle Cloud proyecto, agregue el parámetro --project :

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID

    Reemplace PROJECT_ID con su Google Cloud Identificación del proyecto.

    La salida es similar a la siguiente:

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

Géminis para Google Cloud Ahora está disponible en el especificadoGoogle Cloud proyecto a todos los usuarios que tienen los roles de IAM requeridos .

Configurar el firewall para el tráfico de API entre su IDE y Google

Además de habilitar la API de Gemini para Google Cloud, los usuarios detrás de firewalls también deben permitir el paso del tráfico para las siguientes API:

  • oauth2.googleapis.com : se utiliza para iniciar sesión en Google Cloud.
  • serviceusage.googleapis.com : se utiliza para verificar que el proyecto Gemini Code Assist del usuario esté configurado correctamente.
  • cloudaicompanion.googleapis.com : el Gemini principal para Google Cloud Punto final de API.
  • cloudcode-pa.googleapis.com : una API interna que proporciona funciones relacionadas con IDE.
  • cloudresourcemanager.googleapis.com : se utiliza en los IDE para los selectores de proyectos. La API de Resource Manager podría no ser necesaria si los proyectos están configurados explícitamente en el archivo settings.json .
  • people.googleapis.com : proporciona acceso a información sobre perfiles y contactos.
  • firebaselogging-pa.googleapis.com : una API interna utilizada para enviar telemetría del producto, incluidos eventos sobre si se aceptaron sugerencias.
  • feedback-pa.googleapis.com : una API interna utilizada para el envío de comentarios en IDE.
  • apihub.googleapis.com : utilizado por la función del navegador API de Cloud Code.
  • lh3.googleusercontent.com y lh5.googleusercontent.com : se utilizan para obtener fotos del usuario.

Determinar direcciones IP para Google Cloud dominios predeterminados

Para habilitar la conectividad desde su IDE a Google Cloud API: su firewall debe permitir el tráfico TCP saliente a los rangos de direcciones IP documentados públicamente por Google. Google administra dinámicamente estos rangos.

Para mantener una lista de rangos de IP a los que acceder Google Cloud dominios, tienes varias opciones:

Opcional: Configurar los controles del servicio VPC

Si su organización tiene un perímetro de servicio, deberá agregar los siguientes recursos a su perímetro:

  • API de Gemini para Google Cloud
  • API de asistencia de código de Gemini

Si utiliza Gemini Code Assist Standard o Enterprise desde fuera del perímetro de su servicio, también deberá modificar la política de ingreso para permitir el acceso a esos servicios.

Para obtener más información, consulte Configurar controles de servicio de VPC para Gemini .

Otorgar roles de IAM en un Google Cloud proyecto

En esta sección se describen los pasos necesarios para otorgar los roles de IAM de usuario y consumidor de uso de servicio de Gemini para Google Cloud a los usuarios.

Consola

  1. Para otorgar los roles de IAM necesarios para usar Gemini, vaya a la página IAM y administración .

    Vaya a IAM y administración

  2. En la columna Principal , busque un principal al cual desea darle acceso a Gemini y luego haga clic en Editar principal en esa fila.

  3. En el panel Editar acceso , haga clic en Agregar otro rol .

  4. En Seleccionar un rol , seleccione Gemini para usuario de Google Cloud .

  5. Haga clic en Agregar otro rol y seleccione Consumidor de uso de servicio .

  6. Haga clic en Guardar .

CLI de gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  1. En el menú selector de proyectos, seleccione un proyecto.

  2. Otorgar el rol de usuario de Gemini para Google Cloud: 

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

    Reemplace lo siguiente:

    • PROJECT_ID : el ID de suGoogle Cloud proyecto—por ejemplo, 1234567890 .
    • PRINCIPAL : el identificador del principal, por ejemplo, user:cloudysanfrancisco@gmail.com .

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

    - members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user

  3. Repita el paso anterior para el rol roles/serviceusage.serviceUsageConsumer .

Para obtener más información, consulte Otorgar un rol único y gcloud projects add-iam-policy-binding .

Todos los usuarios a los que se les han otorgado estos roles pueden acceder a Gemini para Google Cloud características en elGoogle Cloud consola dentro del proyecto especificado. Para obtener más información, consulte Gemini para Google Cloud descripción general .

Instalar el complemento Gemini Code Assist

Los usuarios de su organización instalan el complemento Gemini Code Assist en su IDE compatible preferido

Código VS

  1. Para abrir la vista Extensiones en VS Code, haga clic en Icono de extensión Extensiones o presione Ctrl / Cmd + Shift + X .

  2. Buscar Gemini Code Assist .

  3. Haga clic en Instalar .

  4. Si se le solicita, reinicie VS Code.

    Una vez instalada la extensión, Gemini Code Assist aparecerá en la barra de actividades y estará listo para usar. Puede configurar aún más la instalación de Gemini Code Assist especificando sus preferencias en la barra de tareas superior de la aplicación: vaya a Código > Configuración > Configuración > Extensiones y busque Gemini Code Assist .

IntelliJ

  1. Haga clic settings IDE y Configuración del proyecto > Complementos .
  2. En la pestaña Marketplace , busque Gemini Code Assist .
  3. Haga clic en Instalar para instalar el complemento.
  4. Cuando finalice la instalación, haga clic en Reiniciar IDE .

  5. Cuando el IDE se reinicia, Gemini Code Assist aparece en la barra de actividad.

    El icono de Gemini Code Assist aparece en la barra de actividad.

Ahora los usuarios pueden usar Gemini Code Assist Standard o Enterprise en su IDE. Más información sobre las funciones compatibles:

Comience con las siguientes guías:

Lista de directorios donde Gemini Code Assist almacena en caché información

La siguiente tabla proporciona una lista de directorios donde Gemini Code Assist almacena información de extensión, como tokens de autenticación:

Ventanas

  • %LOCALAPPDATA%/cloud-code
  • %LOCALAPPDATA%/google-vscode-extension

macOS

  • ~/Library/Application Support/cloud-code
  • ~/Library/Application Support/google-vscode-extension

Linux

  • ~/.cache/cloud-code
  • ~/.cache/google-vscode-extension

Inicie sesión en Google y seleccione una Google Cloud proyecto

Una vez que los usuarios hayan instalado Gemini Code Assist en sus IDE, deben iniciar sesión en sus cuentas de Google y, si es la primera vez que usan Gemini Code Assist Standard o Enterprise en su IDE, deben seleccionar una Google Cloud proyecto.

Código VS

Si selecciona una Google Cloud Si su proyecto no tiene habilitada la API de Gemini para Google Cloud, recibirá una notificación que le permitirá habilitarla desde el IDE. Seleccione "Habilitar la API" en la ventana de notificaciones para habilitarla en su proyecto. Para obtener más información, consulte Configurar Gemini Code Assist Standard y Enterprise para un proyecto .

Si prefiere seguir el tutorial de Code with Gemini Code Assist directamente en su IDE, haga clic en Iniciar VS Code y siga los pasos del tutorial para conectarse a Google Cloud y activar Gemini Code Assist Standard o Enterprise.

Lanzar VS Code

De lo contrario, siga estos pasos:

  1. Inicie su IDE.

  2. En la barra de actividades, haga clic en Gemini Code Assist .

  3. En el panel de chat de Gemini Code Assist , haga clic en Iniciar sesión en Google Cloud .

  4. Cuando se le solicite permitir que Gemini Code Assist abra el sitio web externo, haga clic en Abrir .

  5. Siga las instrucciones para iniciar sesión en su cuenta de Google.

  6. Cuando se le pregunte si descargó Gemini Code Assist de Google, haga clic en Iniciar sesión .

    Ahora estás conectado a Google Cloud.

    A continuación, para seleccionar un Google Cloud proyecto que tiene habilitada la API de Gemini para Google Cloud, siga estos pasos:

  7. En la barra de estado de Gemini Code Assist , haga clic en Gemini Code Assist .

    La barra de estado de Gemini está disponible.

  8. En el menú Gemini Code Assist , seleccione Seleccionar proyecto Gemini Code .

  9. Seleccione una Google Cloud Proyecto que tiene habilitada la API de Gemini para Google Cloud.

    Gemini Code Assist Standard o Enterprise está listo para usar.

    El icono de Géminis en la barra de estado está configurado en normal.

IntelliJ

Para iniciar sesión en su cuenta de Google, siga estos pasos:

  1. En la barra de actividades, haga clic en spark Gemini Code Assist .

  2. Haga clic en Iniciar sesión en Google .

  3. En la página que se abre en el navegador web, seleccione su cuenta de Google.

  4. En la pantalla que le solicita asegurarse de haber descargado esta aplicación de Google, haga clic en Iniciar sesión .

    Gemini Code Assist ahora está autorizado para acceder a su cuenta.

    A continuación, si es la primera vez que utiliza Gemini Code Assist Standard o Enterprise en su IDE, debe seleccionar un Google Cloudproyecto siguiendo estos pasos:

  5. Regresa a tu IDE. En la ventana de herramientas de Gemini Code Assist, si aceptas que Google habilite las API necesarias para usar Gemini Code Assist en tu nombre para el proyecto seleccionado, haz clic en "Seleccionar un proyecto de GCP" para continuar.

  6. En el cuadro de diálogo Seleccionar proyecto de Google Cloud , busque y seleccione su Google Cloud proyecto y luego haga clic en Aceptar .

  7. Haga clic en FINALIZAR .

Su Google Cloud El proyecto está seleccionado con la API de Gemini Code Assist habilitada. ¡Listo para usar Gemini Code Assist Standard o Enterprise en tu IDE!

Tareas de configuración avanzadas

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

  • Utilice las API REST de IAM o las bibliotecas de cliente de IAM para otorgar roles.

    Si utiliza estas interfaces, utilice los nombres de roles completos:

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageConsumer

    Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

  • Crear y otorgar roles personalizados.

    Cualquier rol personalizado que cree necesitará los siguientes permisos para acceder a Gemini Code Assist Standard y Enterprise:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • cloudaicompanion.instances.exportMetrics
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings
    • serviceusage.services.enable

  • Asignar y gestionar licencias.

    Cualquier rol personalizado que cree necesitará los siguientes permisos para poder asignar y administrar licencias de 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

Tenga en cuenta también que para que funcione cualquiera de los permisos anteriores, la API de Gemini para Google Cloud debe estar habilitada en el mismo Google Cloud proyecto en el que has asignado cada permiso.

¿Qué sigue?