Configurer Gemini Code Assist Standard et Enterprise

Avant de pouvoir utiliser Gemini Code Assist Standard ou Enterprise, votre équipe doit suivre 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. Attribuer 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.

Souscrire un abonnement Gemini Code Assist

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

Pour les nouveaux clients Gemini Code Assist disposant de comptes de facturation qui n'ont jamais souscrit d'abonnement Gemini Code Assist, nous appliquons automatiquement des crédits équivalents à 50 licences sans frais maximum pour le premier mois, quelle que soit l'édition Gemini Code Assist. Notez que vous ne pouvez pas augmenter le nombre de crédits sans frais une fois que les crédits de licence sans frais initiaux 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 d'acheter un abonnement.

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

    Accéder à "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 s'affiche sous la forme Gérer Gemini Code Assist et vous permet de modifier votre abonnement.

    La page Obtenir un abonnement Gemini Code Assist s'ouvre.

  3. Dans Select Gemini Code Assist subscription Edition (Sélectionner l'édition de l'abonnement Gemini Code Assist), sélectionnez 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 pour chaque édition.

    Sélectionnez ensuite Continue (Continuer).

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

    • Nom de l'abonnement.
    • Nombre de licences de 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 facturé sur une base mensuelle plutôt que 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 est désormais souscrit pour Gemini Code Assist Standard ou Enterprise. Vous devez maintenant gérer les attributions de licences Gemini dans votre organisation.

Attribuer des licences

Avant d'utiliser Gemini Code Assist, une licence doit être attribuée à chaque utilisateur de l'organisation auquel vous souhaitez accorder l'accès.

Pour les nouveaux clients Gemini Code Assist disposant de comptes de facturation qui n'ont jamais souscrit d'abonnement Gemini Code Assist, nous appliquons automatiquement des crédits équivalents à 50 licences sans frais maximum pour le premier mois, quelle que soit l'édition Gemini Code Assist. Notez que vous ne pouvez pas augmenter le nombre de crédits sans frais une fois que les crédits de licence sans frais initiaux ont été attribués. De plus, vous ne pouvez pas modifier l'édition de Gemini Code Assist au cours du premier mois.

Console

Pour attribuer des licences Gemini à des utilisateurs individuels dans la console API, vous devez disposer des autorisations suivantes sur le compte de facturation:

  • 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. Accédez à la page Administration pour Gemini.

    Accéder à Gemini pour Google Cloud

  2. Sélectionnez l'abonnement que vous souhaitez modifier, puis cliquez sur Modifier l'abonnement.

  3. Cliquez sur Attribuer des licences. Une boîte de dialogue de sélection de l'utilisateur s'affiche. Pour rechercher des utilisateurs spécifiques, saisissez leur nom dans le champ de recherche.

  4. Sélectionnez un ou plusieurs utilisateurs dans la liste, puis cliquez sur Suivant.

  5. Choisissez les services Gemini pour lesquels vous souhaitez attribuer des licences.

  6. Cliquez sur Attribuer des licences.

API

Pour attribuer des licences Gemini avec l'API, utilisez la méthode billingAccounts.orders.licensePool.assign.

  1. Assurez-vous de disposer de l'autorisation Identity and Access Management consumerprocurement.licensePools.assign sur le compte de facturation contenant le pool de licences dont vous souhaitez attribuer la licence.

  2. Créez un fichier JSON contenant les informations suivantes :

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Où USER_EMAILS est une liste de comptes utilisateur auxquels la licence est attribuée, séparés par une virgule. Exemple : "dana@example.com", "lee@example.com".

  3. Utilisez cURL pour appeler la méthode:

    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/"

    Remplacez les éléments suivants :

    • JSON_FILE_NAME: chemin d'accès au fichier JSON que vous avez créé à l'étape 2.
    • PROJECT_ID: ID d'un projet. L'utilisation des quotas et les frais associés à la requête API sont appliqués à ce projet.
    • BILLING_ACCOUNT_ID: ID du compte de facturation associé au pool de licences.
    • ORDER_ID: ID de la commande. Si vous ne connaissez pas l'ID de la commande, vous pouvez le récupérer en répertoriant les commandes associées à votre compte de facturation.

Si l'opération réussit, la réponse se présente comme suit:

  {}

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

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

Cette section décrit les étapes requises pour activer l'API Gemini for Google Cloud dans un projet Cloud.

Console

  1. Pour activer l'API Gemini pour Google Cloud, accédez à la page Gemini pour Google Cloud.

    Accéder à Gemini pour Google Cloud

  2. Dans le sélecteur de projet, sélectionnez un projet.

  3. Cliquez sur Activer.

    La page est mise à jour et affiche l'état Enabled (Activé). Gemini est désormais disponible dans le projet Cloud sélectionné pour tous les utilisateurs disposant des rôles IAM requis.

gcloud

Pour utiliser un environnement de développement local, installez et initialisez gcloud CLI.

  1. Dans le menu de sélection du projet, sélectionnez un projet.

  2. Activez l'API Gemini pour Google Cloud pour Gemini à l'aide de la commande gcloud services enable: 

    gcloud services enable cloudaicompanion.googleapis.com

    Si vous souhaitez activer l'API Gemini pour Google Cloud dans un autre projet Cloud, ajoutez le paramètre --project:

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

    Remplacez PROJECT_ID par l'ID de votre projet sur le cloud.

    Le résultat ressemble à ce qui suit :

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

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 API entre votre IDE et Google

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

  • oauth2.googleapis.com : permet de se connecter à Google Cloud.
  • serviceusage.googleapis.com : permet de 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 pour 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 peut ne pas être nécessaire si les projets sont configurés explicitement 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 la télémétrie 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é de navigateur d'API Cloud Code.
  • lh3.googleusercontent.com et lh5.googleusercontent.com: utilisés pour obtenir des photos des utilisateurs.

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

Pour activer la connectivité de votre IDE aux API Google Cloud, votre pare-feu doit autoriser le trafic TCP sortant vers les plages d'adresses IP publiques de Google. 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 avez plusieurs options:

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 en dehors 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 la section 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 attribuer aux utilisateurs les rôles IAM Gemini pour les utilisateurs Google Cloud et les consommateurs de Service Usage.

Console

  1. Pour attribuer les rôles IAM requis pour utiliser Gemini, accédez à la page IAM et administration.

    Accéder à IAM et administration

  2. Dans la colonne Compte principal, recherchez un compte principal auquel vous souhaitez accorder l'accès à Gemini, puis cliquez sur Modifier le compte principal sur cette ligne.

  3. Dans le volet Modifier les accès, cliquez sur Ajouter un autre rôle.

  4. Dans Sélectionner un rôle, sélectionnez Utilisateur de Gemini pour Google Cloud.

  5. Cliquez sur Ajouter un autre rôle, puis sélectionnez Consommateur Service Usage.

  6. Cliquez sur Enregistrer.

gcloud

Pour utiliser un environnement de développement local, installez et initialisez gcloud CLI.

  1. Dans le menu de sélection du projet, sélectionnez un projet.

  2. Accordez le rôle "Utilisateur de Gemini pour Google Cloud" :

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

    Remplacez les éléments suivants :

    • PROJECT_ID: ID de votre projet Cloud (par exemple,1234567890).
    • PRINCIPAL: identifiant du principal (par exemple, user:cloudysanfrancisco@gmail.com).

    Le résultat est une liste de liaisons de stratégie qui incluent les éléments suivants :

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

  3. Répétez l'étape précédente pour le rôle roles/serviceusage.serviceUsageConsumer.

Pour plus d'informations, consultez les sections Attribuer un seul rôle et gcloud projects add-iam-policy-binding.

Tous les utilisateurs auxquels ces rôles ont été attribués peuvent accéder aux fonctionnalités Gemini pour Google Cloud dans la console 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é.

VS Code

  1. Pour ouvrir la vue Extensions dans VS Code, cliquez sur Icône de l'extension Extensions ou appuyez sur Ctrl/Cmd+Shift+X.

  2. Recherchez Gemini Code Assist.

  3. Cliquez sur Installer.

  4. Si vous y êtes invité, redémarrez VS Code.

    Une fois l'extension installée, Gemini Code Assist s'affiche dans la barre des tâches et est prête à être utilisée. Vous pouvez procéder à une configuration plus avancée de votre installation Gemini Code Assist en spécifiant vos préférences à l'aide de la barre des tâches de niveau supérieur de l'application: accédez à Code > Settings (Paramètres) > Settings (Paramètres) > Extensions (Extensions) et recherchez Gemini Code Assist.

IntelliJ

  1. Cliquez sur settings IDE et paramètres du projet > Plug-ins.
  2. Dans l'onglet Marketplace (Place de marché), recherchez Gemini Code Assist.
  3. Cliquez sur Installer pour installer le plug-in.
  4. Une fois l'installation terminée, cliquez sur Redémarrer l'IDE.

  5. Lorsque l'IDE redémarre, Gemini Code Assist s'affiche dans la barre d'activité.

    L'icône Gemini Code Assist s'affiche dans la barre d'activité.

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

Pour commencer, consultez les guides suivants:

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

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

Windows

  • %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

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 à leurs comptes 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.

VS Code

Si vous sélectionnez un projet Google Cloud sans que l'API Gemini pour Google Cloud ne soit activée, vous recevez une notification vous permettant d'activer l'API depuis l'IDE. Sélectionnez Activer l'API dans la fenêtre de notification pour activer l'API pour votre projet. Pour en savoir plus, consultez la section Configurer Gemini Code Assist Standard et Enterprise pour un projet.

Si vous préférez suivre la procédure de codage avec Gemini Code Assist directement dans votre IDE, cliquez sur Lancer VS Code, puis suivez les étapes de la procédure pour vous connecter à Google Cloud et activer Gemini Code Assist Standard ou Enterprise.

Lancer VS Code

Sinon, procédez comme suit:

  1. Lancez votre IDE.

  2. Dans la barre d'activité, cliquez sur Gemini Code Assist.

  3. Dans le volet de chat Gemini Code Assist, cliquez sur Se connecter à Google Cloud.

  4. Lorsque vous êtes invité à autoriser Gemini Code Assist à ouvrir le site Web externe, cliquez sur Ouvrir.

  5. Suivez les instructions pour vous connecter à votre compte Google.

  6. Lorsque vous êtes invité à confirmer que vous avez téléchargé Gemini Code Assist depuis Google, cliquez sur Se connecter.

    Vous êtes désormais connecté à Google Cloud.

    Pour sélectionner un projet Google Cloud pour lequel l'API Gemini pour Google Cloud est activée, procédez comme suit:

  7. Dans la barre d'état Gemini Code Assist, cliquez sur Gemini Code Assist.

    La barre d'état de Gemini est disponible.

  8. Dans le menu Gemini Code Assist, sélectionnez Select Gemini Code project (Sélectionner un projet Gemini Code).

  9. Sélectionnez un projet Google Cloud dans lequel l'API Gemini for Google Cloud est activée.

    Gemini Code Assist Standard ou Enterprise est prêt à l'emploi.

    L'icône Gemini dans la barre d'état est définie sur "Normal".

IntelliJ

Pour vous connecter à votre compte Google, procédez comme suit:

  1. Dans la barre d'activité, cliquez sur spark Gemini Code Assist.

  2. Cliquez sur Se connecter à Google.

  3. Sur la page qui s'affiche dans le navigateur Web, sélectionnez votre compte Google.

  4. Sur l'écran qui vous demande de vérifier que vous avez téléchargé cette application depuis Google, cliquez sur Se connecter.

    Gemini Code Assist est désormais autorisé à accéder à votre compte.

    Ensuite, si vous utilisez Gemini Code Assist Standard ou Enterprise pour la première fois dans votre IDE, vous devez sélectionner un projet Google Cloud en procédant comme suit:

  5. Revenez à votre IDE. Dans la fenêtre de l'outil Gemini Code Assist, si vous acceptez que Google active les API requises pour utiliser Gemini Code Assist en votre nom pour le projet sélectionné, cliquez sur Sélectionner un projet GCP pour continuer.

  6. Dans la boîte de dialogue Select Google Cloud Project (Sélectionner un projet Google Cloud), recherchez et sélectionnez votre projet Google Cloud, puis cliquez sur OK.

  7. Cliquez sur TERMINER.

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 de l'API ou gcloud pour attribuer 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 accorder des rôles.

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

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

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

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

    Les rôles personnalisés que vous créez doivent disposer des autorisations suivantes pour que vous puissiez 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

  • Attribuer et gérer des licences

    Les rôles personnalisés que vous créez ont besoin des autorisations suivantes pour vous permettre d'attribuer et de gérer des 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 l'une des autorisations précédentes fonctionne, l'API Gemini pour Google Cloud doit être activée dans le même projet Google Cloud que celui dans lequel vous avez attribué chaque autorisation.

Étape suivante