Configurer Gemini Code Assist

Pour que vous puissiez utiliser Gemini Code Assist, votre équipe doit suivre la procédure de configuration décrite 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. Activez l'API Cloud AI Companion dans un projet Google Cloud. C'est généralement un administrateur qui effectue cette étape.

  3. Accordez des rôles Identity and Access Management (IAM) dans un projet Google Cloud. C'est généralement un administrateur qui effectue cette étape.

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

Facultatif: Acheter 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à souscrit 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

    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 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 après 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 vous devez recommencer le processus 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, 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. Les utilisateurs ne verront 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 les étapes requises pour activer l'API Cloud AI Companion dans un projet Google Cloud.

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.

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. 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 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.

Attribuer des rôles IAM dans un projet Google Cloud

Cette section décrit la procédure à suivre pour attribuer les rôles IAM "Utilisateur" et "Client de Service Usage" de Cloud AI aux utilisateurs.

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 pour lequel vous souhaitez activer 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 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 aux fonctionnalités de Gemini pour Google Cloud dans la console Google Cloud au sein du projet spécifié. Pour en savoir plus, consultez la 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 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 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

    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.use

Étapes suivantes