Configurer Gemini Code Assist Standard et Enterprise

Avant que vous puissiez utiliser Gemini Code Assist Standard ou Enterprise, votre équipe doit effectuer les étapes de configuration décrites dans ce document :

1. Souscrivez un abonnement à Gemini Code Assist Standard ou Enterprise.

2. Attribuez des licences à des utilisateurs spécifiques de votre organisation.

3. Activez l'API Gemini pour Google Cloud dans un projet Google Cloud.

4. Attribuez des rôles Identity and Access Management dans un projet Google Cloud.

5. Les utilisateurs de votre organisation installent le plug-in Gemini Code Assist pour utiliser Gemini Code Assist Standard ou Enterprise dans un IDE. Cette étape n'est pas obligatoire pour les utilisateurs de Gemini CLI.

Souscrire un abonnement Gemini Code Assist

Pour obtenir la liste des fonctionnalités disponibles dans chaque édition, consultez Fonctionnalités compatibles.

Pour les nouveaux clients Gemini Code Assist dont les comptes de facturation n'ont jamais servi à souscrire d'abonnement Gemini Code Assist, nous appliquons automatiquement des crédits équivalant à un maximum de 50 licences gratuites pour le premier mois, quelle que soit l'édition de Gemini Code Assist. Notez que vous ne pouvez pas augmenter le nombre de crédits gratuits une fois que les crédits de licence gratuite initiale ont été attribués. De plus, vous ne pouvez pas modifier l'édition de Gemini Code Assist au cours du premier mois.

Si vous avez déjà des contrats avec Google Cloud, contactez notre équipe commerciale avant de souscrire un abonnement.

1. Accédez à la page Administration de Gemini.

   Accéder à la page "Administration de Gemini"

   La page Administration de Gemini s'ouvre.

2. Sélectionnez Obtenir Gemini Code Assist.

   Notez que si vous ne disposez pas de l'autorisation consumerprocurement.orders.place requise, ce bouton est désactivé. Si un abonnement Gemini Code Assist existe déjà pour le compte de facturation associé au projet, ce bouton porte le libellé Gérer Gemini Code Assist et vous permet de modifier votre abonnement.

   La page S'abonner à Gemini Code Assist s'ouvre.

3. Dans Sélectionner l'édition de l'abonnement Gemini Code Assist, choisissez une édition de Gemini Code Assist. Sélectionnez Comparer les éditions de Gemini Code Assist pour afficher une liste détaillée des fonctionnalités disponibles avec chaque édition.

   Sélectionnez ensuite Continuer.

4. Dans Configurer l'abonnement, renseignez les champs pour configurer l'abonnement, y compris les suivants :

   • Nom de l'abonnement.
   • Nombre de licences dans l'abonnement. Notez que si vous achetez l'édition Enterprise, vous devez acheter au moins 10 licences.
   • Période d'abonnement (mensuelle ou annuelle). Avec un abonnement annuel, vous bénéficiez d'un tarif réduit qui est facturé mensuellement plutôt que sous la forme d'un paiement unique.

5. Pour confirmer l'abonnement, sélectionnez Continuer.

6. Si vous acceptez les conditions, sélectionnez J'accepte les conditions de cet achat, puis Confirmer l'abonnement.

7. Sélectionnez Suivant : Gérer les attributions de licences Gemini.

L'abonnement à Gemini Code Assist Standard ou Enterprise est désormais souscrit. Vous devez maintenant gérer les attributions de licences Gemini dans votre organisation.

Attribuer des licences

Avant d'utiliser Gemini Code Assist, chaque utilisateur individuel de l'organisation ayant besoin d'y accéder doit se voir attribuer une licence.

Pour les nouveaux clients Gemini Code Assist dont les comptes de facturation n'ont jamais servi à souscrire d'abonnement Gemini Code Assist, nous appliquons automatiquement des crédits équivalant à un maximum de 50 licences gratuites pour le premier mois, quelle que soit l'édition de Gemini Code Assist. Notez que vous ne pouvez pas augmenter le nombre de crédits gratuits une fois que les crédits de licence gratuite initiale ont été attribués. De plus, vous ne pouvez pas modifier l'édition de Gemini Code Assist au cours du premier mois.

Par défaut, les nouveaux abonnements nécessitent que vous attribuiez manuellement les licences. Une fois la configuration terminée, vous pouvez choisir d'attribuer les licences manuellement ou automatiquement.

  {} 

Vous devez maintenant activer l'API Gemini for Google Cloud dans un ou plusieurs projets associés à ce compte de facturation. Les utilisateurs ne verront pas Gemini Code Assist tant que vous ne l'aurez pas activé dans au moins un projet.

Activer l'API Gemini pour Google Cloud dans un projet Cloud

Cette section décrit la procédure à suivre pour activer l'API Gemini for Google Cloud dans un projet Cloud.

Gemini pour Google Cloud est désormais disponible dans le projet Cloud spécifié pour tous les utilisateurs disposant des rôles IAM requis.

Configurer le pare-feu pour le trafic des API entre votre IDE et Google

En plus d'activer Gemini pour Google Cloud, les utilisateurs situés derrière des pare-feu doivent également autoriser le trafic pour les API suivantes :

• oauth2.googleapis.com : utilisé pour se connecter à Google Cloud.
• serviceusage.googleapis.com : utilisé pour vérifier que le projet Gemini Code Assist de l'utilisateur est correctement configuré.
• cloudaicompanion.googleapis.com : point de terminaison principal de l'API Gemini for Google Cloud.
• cloudcode-pa.googleapis.com : API interne qui fournit des fonctionnalités liées à l'IDE.
• cloudresourcemanager.googleapis.com : utilisé dans les IDE pour les sélecteurs de projets. L'API Resource Manager n'est peut-être pas nécessaire si les projets sont explicitement configurés dans votre fichier settings.json.
• people.googleapis.com : permet d'accéder aux informations sur les profils et les contacts.
• firebaselogging-pa.googleapis.com : API interne utilisée pour envoyer les données télémétriques des produits, y compris les événements indiquant si les suggestions ont été acceptées.
• feedback-pa.googleapis.com : API interne utilisée pour l'envoi de commentaires dans l'IDE.
• apihub.googleapis.com : utilisé par la fonctionnalité d'explorateur d'API Cloud Code.
• lh3.googleusercontent.com et lh5.googleusercontent.com : utilisés pour obtenir des photos d'utilisateurs.

Déterminer les adresses IP pour les domaines Google Cloud par défaut

Pour activer la connectivité entre votre IDE et les API Google Cloud, votre pare-feu doit autoriser le trafic TCP sortant vers les plages d'adresses IP Google documentées publiquement. Ces plages sont gérées de manière dynamique par Google.

Pour gérer une liste de plages d'adresses IP permettant d'accéder aux domaines Google Cloud, vous disposez de plusieurs options :

• Utilisez nos listes publiées ou automatisez un script pour obtenir les plages d'adresses IP Google.
• Utilisez l'adresse IP virtuelle private.googleapis.com.
• Utilisez Private Service Connect.

Facultatif : Configurer VPC Service Controls

Si votre organisation dispose d'un périmètre de service, vous devez y ajouter les ressources suivantes :

• API Gemini for Google Cloud
• API Gemini Code Assist

Si vous utilisez Gemini Code Assist Standard ou Enterprise depuis l'extérieur de votre périmètre de service, vous devez également modifier la règle d'entrée pour autoriser l'accès à ces services.

Pour en savoir plus, consultez Configurer VPC Service Controls pour Gemini.

Attribuer des rôles IAM dans un projet Google Cloud

Cette section décrit la procédure à suivre pour accorder les rôles IAM "Utilisateur Gemini pour Google Cloud" et "Consommateur Service Usage" aux utilisateurs.

Tous les utilisateurs auxquels ces rôles ont été attribués peuvent accéder aux fonctionnalités de Gemini pour Google Cloud dans la console d'API du projet spécifié. Pour en savoir plus, consultez la présentation de Gemini pour Google Cloud.

Installer le plug-in Gemini Code Assist

Les utilisateurs de votre organisation installent le plug-in Gemini Code Assist dans leur IDE compatible préféré. Les utilisateurs d'IDE JetBrains compatibles doivent suivre les instructions pour IntelliJ.

Les utilisateurs sont maintenant prêts à utiliser Gemini Code Assist Standard ou Enterprise dans leur IDE. En savoir plus sur les fonctionnalités disponibles :

• Présentation des fonctionnalités de code
• Présentation des fonctionnalités de chat

Pour commencer, consultez les guides suivants :

• Coder avec Gemini Code Assist
• Discuter avec Gemini Code Assist

Liste des répertoires dans lesquels Gemini Code Assist met en cache les informations

Le tableau suivant fournit une liste des répertoires dans lesquels Gemini Code Assist stocke les informations sur les extensions, telles que les jetons d'authentification :

Se connecter à Google et sélectionner un projet Google Cloud

Une fois que les utilisateurs ont installé Gemini Code Assist dans leurs IDE, ils doivent se connecter à leur compte Google. S'ils utilisent Gemini Code Assist Standard ou Enterprise pour la première fois dans leur IDE, ils doivent sélectionner un projet Google Cloud.

Votre projet Google Cloud est sélectionné et l'API Gemini Code Assist est activée. Vous êtes prêt à utiliser Gemini Code Assist Standard ou Enterprise dans votre IDE.

Tâches de configuration avancées

Au lieu d'utiliser la console API ou gcloud pour accorder des rôles IAM prédéfinis, vous pouvez effectuer l'une des opérations suivantes :

• Utilisez les API REST IAM ou les bibliothèques clientes IAM pour attribuer des rôles.

  Si vous utilisez ces interfaces, employez les noms de rôles complets :

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

  Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

• Créez et attribuez des rôles personnalisés.

  Tous les rôles personnalisés que vous créez doivent disposer des autorisations suivantes pour qu'il leur soit possible d'accéder à Gemini Code Assist Standard et 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

• Attribuez et gérez des licences.

  Tous les rôles personnalisés que vous créez doivent disposer des autorisations suivantes pour que vous puissiez attribuer et gérer les licences 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

Notez également que pour que chacune des autorisations précédentes fonctionne, l'API Gemini for Google Cloud doit être activée dans le projet Google Cloud où vous avez attribué ladite autorisation.

Étape suivante

• Découvrez-en plus sur les types d'assistance d'IA générative disponibles dans Gemini pour Google Cloud.
• Découvrez comment Gemini pour Google Cloud utilise vos données.
• Découvrez comment accéder aux commandes d'administration de Gemini Code Assist Standard et Enterprise et les gérer.
• Découvrez comment configurer la personnalisation du code pour Gemini Code Assist Enterprise.
• Configurez VPC Service Controls pour Gemini Code Assist Standard et Enterprise.