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. Facultatif: Souscrivez un abonnement à Gemini Code Assist. Vous pouvez essayer Gemini Code Assist sans frais jusqu'au 8 novembre 2024, limité à un utilisateur par compte de facturation.

  2. Activez l'API Cloud AI Companion dans un projet Google Cloud. Cette étape est généralement effectuée par un administrateur.

  3. Accordez des rôles Identity and Access Management (IAM) dans un projet Google Cloud. Cette étape est généralement effectuée par un administrateur.

  4. Facultatif: pour utiliser Gemini Code Assist dans un IDE, installer le plug-in Cloud Code.

Facultatif: Acheter un abonnement Gemini Code Assist

Vous pouvez essayer Gemini Code Assist sans abonnement à l'adresse sans frais jusqu'au 8 novembre 2024 (limité à un utilisateur par compte de facturation). Les organisations comptant plusieurs utilisateurs par compte de facturation doivent acheter un comme décrit dans cette section. Si vous avez déjà des contrats avec Google Cloud, contactez notre équipe commerciale avant d'acheter abonnement.

  1. Dans la console Google Cloud, 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 Gemini Code Assist.

    Le panneau Gemini Code Assist s'affiche.

  3. Cliquez sur Obtenir Gemini Code Assist.

  4. Si vous y êtes invité, sélectionnez un compte de facturation, puis cliquez sur Accéder à la page Administration de Gemini

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

  5. Dans Configurer l'abonnement, renseignez les champs pour configurer le incluant la durée d'engagement (mensuelle ou annuelle) le nombre de licences dans l'abonnement.

    Indiquez si vous souhaitez renouveler automatiquement votre abonnement après le la durée d'engagement (mensuelle ou annuelle). Le renouvellement automatique vous permet licences actives. Si l'abonnement n'est pas renouvelé automatiquement, il se termine au la période en cours arrive à expiration et que vous devez suivre la procédure d'achat pour récupérer les licences.

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

  7. Si vous acceptez les conditions d'utilisation, cliquez sur Finaliser l'achat, puis confirmez votre abonnement.

La facturation est désormais activée pour Gemini. Vous devez maintenant Activer l'API Cloud AI Companion dans un ou plusieurs projets associés à ce compte de facturation. Utilisateurs ne verra pas Gemini tant que vous ne l'aurez pas activé dans au moins un projet.

Activer l'API Cloud AI Companion dans un projet Google Cloud

Cette section décrit la procédure à suivre pour activer API Cloud AI Companion dans un projet Google Cloud.

Console

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

    Accéder à Gemini pour Google Cloud

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

  3. Cliquez sur Activer.

    La page est mise à jour et affiche l'état Activé. Gemini est désormais disponible dans les Google Cloud à tous les utilisateurs disposant IAM.

gcloud

  1. Dans la console Google Cloud, activez Cloud Shell.

    Activer Cloud Shell

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

  3. Activer l'API Cloud AI Companion pour Gemini à l'aide de la commande gcloud services enable:

    gcloud services enable cloudaicompanion.googleapis.com

    Si vous souhaitez activer l'API Cloud AI Companion dans une autre dans votre 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 pour tous les utilisateurs du projet Google Cloud spécifié aux utilisateurs disposant des rôles IAM requis.

Attribuer des rôles IAM dans un projet Google Cloud

Cette section décrit la procédure à suivre pour accorder à l'utilisateur Cloud AI Companion 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 activer 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 Utilisateur Cloud AI Companion.

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

  6. Cliquez sur Enregistrer.

gcloud

  1. Dans la console Google Cloud, activez Cloud Shell.

    Activer Cloud Shell

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

  3. Attribuez le rôle d'utilisateur Cloud AI Companion:

    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 de la console Google Cloud au sein du projet spécifié. Pour plus pour en savoir plus, consultez Présentation de Gemini pour Google Cloud

Facultatif: Utiliser Gemini Code Assist dans un IDE

Si vous êtes développeur et que vous souhaitez utiliser Gemini dans votre IDE, vous devez installer le plug-in Cloud Code. Pour en savoir plus, consultez les ressources suivantes :

Tâches de configuration avancées

Au lieu d'utiliser la console Google Cloud ou la gcloud CLI pour des rôles IAM prédéfinis, vous pouvez effectuer les opérations suivantes:

  • Utiliser les API REST IAM ou les bibliothèques clientes IAM pour attribuer 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éer et attribuer des rôles personnalisés

    Les rôles personnalisés que vous créez doivent disposer les autorisations suivantes pour accéder à Gemini:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • serviceusage.services.use

Étape suivante