Configurer Gemini Code Assist pour un projet

Avant de pouvoir utiliser Gemini Code Assist, votre équipe doit 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 11 juillet 2024, dans la limite d'un utilisateur par compte de facturation.

  2. Activer Gemini Code Assist dans un projet Google Cloud Un administrateur effectue généralement cette étape.

  3. Facultatif: Pour utiliser Gemini Code Assist dans un IDE, installez le plug-in Cloud Code.

Facultatif: Souscrire un abonnement Gemini Code Assist

Vous pouvez essayer Gemini Code Assist sans frais jusqu'au 11 juillet 2024, dans la limite d'un utilisateur par compte de facturation. Les organisations comptant plusieurs utilisateurs par compte de facturation doivent souscrire un abonnement, comme décrit dans cette section. Si vous avez déjà signé des contrats avec Google Cloud, contactez notre équipe commerciale avant de souscrire un abonnement.

  1. Dans la console Google Cloud, accédez à la page Gemini pour Google Cloud.

    Accéder à Gemini pour Google Cloud

  2. Cliquez sur Premiers pas avec Gemini.

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

  4. Dans Configurer l'abonnement, renseignez les champs permettant de configurer l'abonnement, y compris la durée d'engagement (mensuelle ou annuelle) et le nombre de licences dans l'abonnement.

    Indiquez si vous souhaitez renouveler automatiquement votre abonnement à l'issue 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 prend fin à la fin de la période en cours. Vous devez alors recommencer la procédure d'achat pour récupérer les licences.

  5. Pour afficher les détails de l'abonnement, cliquez sur Continuer.

  6. Si vous acceptez les conditions, cliquez sur Terminer l'achat, puis confirmez votre abonnement.

La facturation est désormais activée pour Gemini. Vous devez maintenant activer Gemini Code Assist dans un ou plusieurs projets associés à ce compte de facturation. Les utilisateurs ne verront pas Gemini tant que vous ne l'aurez pas activé dans au moins un projet.

Activer Gemini Code Assist dans un projet Google Cloud

Pour activer Gemini Code Assist dans un projet Google Cloud, un administrateur doit activer l'API Cloud AI Companion et attribuer aux utilisateurs les rôles IAM "Utilisateur Cloud AI Companion" et "Lecteur de l'utilisation du service".

Console

  1. Pour activer l'API Cloud AI Companion, accédez à la page 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 le projet Google Cloud sélectionné pour tous les utilisateurs disposant des rôles IAM requis.

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

    Accéder à IAM et administration

  5. Dans la colonne Compte principal, recherchez un compte principal pour lequel vous souhaitez activer l'accès à Gemini, puis cliquez sur Modifier le compte principal sur cette ligne.

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

  7. Dans Sélectionner un rôle, choisissez Utilisateur Cloud AI Companion.

  8. Cliquez sur Ajouter un autre rôle et sélectionnez Lecteur Service Usage.

  9. Cliquez sur Enregistrer.

gcloud

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

    Activer Cloud Shell

  2. Dans la liste déroulante du sélecteur de projet, choisissez un projet.

  3. Activez 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 pour 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 est désormais disponible dans le projet Google Cloud spécifié pour tous les utilisateurs disposant des rôles IAM requis.

  4. Attribuez les deux rôles IAM requis pour utiliser Gemini:

    1. Attribuez le rôle 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

    2. Attribuez le rôle Lecteur de Service Usage:

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

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

      - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageViewer

    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 aux fonctionnalités Gemini dans la console Google Cloud au sein du projet spécifié. Pour en savoir plus, consultez Utiliser Gemini pour l'assistance et le développement d'IA.

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'attribuer des rôles IAM prédéfinis à l'aide de la console Google Cloud ou de la gcloud CLI, vous pouvez effectuer l'une des opérations suivantes:

  • Attribuez des rôles à l'aide des API REST IAM ou des bibliothèques clientes IAM.

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

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageViewer

    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 attribuez des rôles personnalisés.

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

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

Étapes suivantes