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 : Abonnez-vous à 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 Gemini pour Google Cloud 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 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 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 Continuer vers la page "Administration pour 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 Gemini pour Google Cloud 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 Gemini pour Google Cloud dans un projet Google Cloud

Cette section décrit la procédure à suivre pour activer Gemini pour l'API 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 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. Activer 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 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 dans les Google Cloud à tous les utilisateurs disposant du 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 page 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. In the Google Cloud console, activate Cloud Shell.

    Activate 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:[email protected], group:[email protected], serviceAccount:[email protected] 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 Présentation de Gemini pour Google Cloud

Facultatif : Utiliser Gemini Code Assist dans un IDE

Si vous êtes un 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éez et accordez 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
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.use

Étape suivante