Configurer Gemini Code Assist

Avant de pouvoir utiliser Gemini Code Assist, votre équipe doit suivre les étapes de configuration décrites dans ce document:

  1. Souscrivez un abonnement à Gemini Code Assist.

  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. Accorder des rôles Identity and Access Management (IAM) dans un projet Google Cloud

  5. Les utilisateurs de votre organisation installent le plug-in Gemini Code Assist pour utiliser Gemini Code Assist 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.

Gemini Code Assist Enterprise est disponible pour 19 $par mois et par utilisateur, avec un engagement de 12 mois jusqu'au 31 mars 2025. Contactez notre équipe commerciale pour profiter de cette offre promotionnelle.

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

Remarque: Vous devez disposer de l'autorisation IAM (Identity and Access Management) consumerprocurement.orders.place pour souscrire un abonnement Gemini. L'autorisation consumerprocurement.orders.place est incluse dans le rôle IAM roles/billing.admin ou le rôle roles/consumerprocurement.orderAdmin. Vous pouvez également ajouter l'autorisation à un rôle personnalisé.
  1. Accédez à la page Gemini pour Google Cloud.

    Accéder à Gemini pour Google Cloud

    La page Gemini pour Google Cloud s'ouvre.

  2. Sélectionnez Obtenir Gemini Code Assist. Si Gemini Code Assist est déjà disponible dans votre projet, le texte Gérer Gemini Code Assist s'affiche.

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

  3. Dans 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.
    • Durée de l'abonnement (mensuel ou annuel) 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.
    • Renouvellement automatique de votre abonnement à la fin de la période d'engagement (mensuelle ou annuelle). Le renouvellement automatique permet de maintenir votre abonnement et vos licences actifs. Si l'abonnement ne se renouvelle pas automatiquement, il prend fin à la fin de la période en cours. Vous devez alors suivre à nouveau la procédure d'achat et réattribuer les licences.
  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 est désormais souscrit. Vous devez maintenant gérer les attributions de licences Gemini dans votre organisation.

Attribuer des licences

Pour pouvoir utiliser Gemini Code Assist, chaque utilisateur de votre organisation doit disposer d'une licence.

Console

Pour attribuer des licences Gemini à des utilisateurs individuels dans la console Google Cloud, vous devez disposer des autorisations suivantes:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign
  1. Accédez à la page Administration pour Gemini.

    Accéder à "Administration de Gemini"

  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 à l'aide de l'API, vous devez disposer de l'autorisation consumerprocurement.licensePools.assign.

Méthode HTTP: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

Remplacez les éléments suivants :

  • BILLING_ACCOUNT_ID: ID du compte de facturation
  • ORDER_ID: la stratégie IAM

Corps de la requête :

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

Le résultat ressemble à ce qui suit :

{}

La réponse est vide si l'attribution de la licence aboutit.

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 Google Cloud

Cette section décrit les étapes requises pour activer l'API Gemini pour Google Cloud dans un projet Google 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 Google Cloud sélectionné pour tous les utilisateurs disposant des rôles IAM requis.

gcloud

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

    Activate Cloud Shell

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

  3. 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 Google Cloud, ajoutez le paramètre --project:

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

    Remplacez PROJECT_ID par l'ID de votre projet Google 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 Google Cloud spécifié pour tous les utilisateurs disposant des rôles IAM requis.

API requises pour les utilisateurs derrière des pare-feu

En plus d'activer l'API Gemini pour Google Cloud, les utilisateurs derrière des pare-feu peuvent également avoir besoin d'activer 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 du produit, 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.

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 pour Google Cloud
  • API Gemini Code Assist

Si vous utilisez Gemini Code Assist en dehors de votre périmètre de service, vous devez également modifier la stratégie 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 accorder 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

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

    Activate Cloud Shell

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

  3. 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 PRINCIPAL par l'identifiant du compte principal. L'identifiant se présente sous la forme user|group|serviceAccount:email ou domain:domain (par exemple, user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com ou domain:example.domain.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
    
  4. Attribuez le rôle Consommateur Service Usage:

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

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

    - members:
      - user:PRINCIPAL
      role: 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 Google Cloud du projet spécifié. Pour en savoir plus, consultez la présentation de Gemini pour Google Cloud.

Installer le plug-in Gemini Code Assist dans un IDE

Les utilisateurs de votre organisation installent Gemini Code Assist dans l'IDE de leur choix. Pour en savoir plus, consultez les ressources suivantes :

Tâches de configuration avancées

Au lieu d'utiliser la console Google Cloud ou gcloud CLI 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.

    Pour accéder à Gemini Code Assist, vous devez disposer des autorisations suivantes pour tous les rôles personnalisés que vous créez:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable
  • Attribuer et gérer des licences

    Pour accéder à Gemini Code Assist, vous devez disposer des autorisations suivantes pour tous les rôles personnalisés que vous créez:

    • 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