Configurer Gemini Code Assist

Avant de pouvoir utiliser Gemini Code Assist, votre équipe a besoin pour effectuer 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 Cloud Code pour utiliser Gemini Code Assist dans un IDE.

Acheter un abonnement Gemini Code Assist

La procédure à suivre pour souscrire un abonnement Gemini Code Assist dépend de l'édition que vous achetez : Enterprise ou Standard. Pour obtenir la liste des fonctionnalités disponibles dans chaque édition, consultez la section Fonctionnalités compatibles.

Édition Enterprise

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

Édition Standard

Vous pouvez essayer l'édition standard de Gemini Code Assist sans abonnement et sans frais jusqu'au 8 novembre 2024, dans la limite d'un utilisateur par compte de facturation. Les organisations disposant de plusieurs utilisateurs par compte de facturation doivent souscrire un abonnement, comme décrit dans cette section.

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 la Rôle IAM roles/billing.admin ou 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. Cliquez sur Obtenir Gemini Code Assist. Si votre projet a déjà Gemini Code Assist, ce texte s'affiche Gérer Gemini Code Assist

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

  3. Dans Configurer l'abonnement, renseignez les champs pour configurer le dont voici une liste non exhaustive:

    • Nom de l'abonnement.
    • Nombre de licences dans l'abonnement.
    • 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.
    • Renouvellement automatique de votre abonnement à la fin de la période d'engagement (mensuelle ou annuelle). Le renouvellement automatique maintient votre abonnement et vos licences actifs. Si l'abonnement ne se renouvelle pas automatiquement, il se termine à la fin de la période en cours. et que vous devez recommencer le processus d'achat et réattribuer licences.

  4. Pour consulter les détails de l'abonnement, cliquez sur Continuer.

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

  6. Cliquez sur Suivant: Gérer les attributions de licences Gemini.

L'abonnement Gemini Code Assist est désormais souscrit. Vous maintenant pour gérer l'attribution des licences Gemini dans votre organisation.

Attribuer des licences

Avant d'utiliser Gemini Code Assist, chaque utilisateur de votre organisation a besoin 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" pour Gemini

  2. Choisissez 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 effectuer une recherche pour 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. Sélectionnez 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, vous devez disposer du 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: 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 la licence a bien été attribuée.

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 de projet, choisissez 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 les Google Cloud à tous les utilisateurs disposant du 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 vous devez également activer 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 correctement configurés.
  • 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. Il est possible que l'API Resource Manager ne soit pas nécessaire si les projets sont explicitement configurés dans votre 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 les commentaires dans l'IDE l'envoi.
  • apihub.googleapis.com: utilisé par le navigateur de l'API Cloud Code.

Attribuer des rôles IAM dans un projet Google Cloud

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

Console

  1. Pour accorder les rôles IAM requis pour utiliser Gemini, accédez à la section IAM et Administration.

    Accéder à IAM et administration

  2. Dans la colonne Compte principal, recherchez un compte principal pour lequel vous souhaitez accorder l'accès à Gemini, puis cliquez sur Modifiez 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 Gemini pour utilisateur 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. Attribuez 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 disposant de ces rôles peuvent accéder Gemini pour Google Cloud dans console Google Cloud dans le projet spécifié. Pour en savoir plus, consultez la présentation de Gemini pour Google Cloud.

Installer le plug-in Cloud Code pour utiliser 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 la CLI 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 les autorisations suivantes vous permettent d'accéder à Gemini Code Assist:

    • 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

    Les rôles personnalisés que vous créez doivent disposer des autorisations suivantes pour que vous puissiez accéder à 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 si l'une des autorisations précédentes fonctionne, Gemini pour l'API Google Cloud doit être activé dans le projet Google Cloud où que vous avez attribuées à chaque autorisation.

Étape suivante