Avant de pouvoir utiliser Gemini Code Assist, votre équipe doit suivre les étapes de configuration décrites dans ce document:
Attribuez des licences à des utilisateurs spécifiques de votre organisation.
Activez l'API Gemini pour Google Cloud dans un projet Google Cloud.
Accorder des rôles Identity and Access Management (IAM) dans un projet Google Cloud
Les utilisateurs de votre organisation installent le plug-in Gemini Code Assist pour utiliser Gemini Code Assist dans un IDE.
Souscrire un abonnement Gemini Code Assist
Pour obtenir la liste des fonctionnalités disponibles pour chaque édition, consultez la section Fonctionnalités compatibles.
Gemini Code Assist Enterprise est disponible pour 19 $par mois et par utilisateur, avec un engagement de 12 mois jusqu'au 31 mars 2025. Contactez notre équipe commerciale pour profiter de cette offre promotionnelle.
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 le rôle IAM roles/billing.admin
ou le rôle roles/consumerprocurement.orderAdmin
.
Vous pouvez également ajouter l'autorisation à un rôle personnalisé.
Accédez à la page Gemini pour Google Cloud.
Accéder à Gemini pour Google Cloud
La page Gemini pour Google Cloud s'ouvre.
Sélectionnez Obtenir Gemini Code Assist. Si Gemini Code Assist est déjà disponible dans votre projet, le texte Gérer Gemini Code Assist s'affiche.
La page Obtenir un abonnement Gemini Code Assist s'ouvre.
Dans Sélectionner l'édition de l'abonnement Gemini Code Assist, sélectionnez une édition de Gemini Code Assist. Sélectionnez Comparer les éditions de Gemini Code Assist pour afficher une liste détaillée des fonctionnalités disponibles pour chaque édition.
Sélectionnez ensuite Continue (Continuer).
Dans Configurer l'abonnement, renseignez les champs pour configurer l'abonnement, y compris les suivants:
- Nom de l'abonnement.
- Nombre de licences de l'abonnement. Notez que si vous achetez l'édition Enterprise, vous devez acheter au moins 10 licences.
- Durée de l'abonnement (mensuel ou annuel) 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 permet de maintenir 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 suivre à nouveau la procédure d'achat et réattribuer les licences.
Pour confirmer l'abonnement, sélectionnez Continuer.
Si vous acceptez les conditions, sélectionnez J'accepte les conditions de cet achat, puis Confirmer l'abonnement.
Sélectionnez Suivant: Gérer les attributions de licences Gemini.
L'abonnement à Gemini Code Assist est désormais souscrit. Vous devez maintenant gérer les attributions de licences Gemini dans votre organisation.
Attribuer des licences
Pour pouvoir utiliser Gemini Code Assist, chaque utilisateur de votre organisation doit disposer 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
Accédez à la page Administration pour Gemini.
Sélectionnez l'abonnement que vous souhaitez modifier, puis cliquez sur Modifier l'abonnement.
Cliquez sur Attribuer des licences. Une boîte de dialogue de sélection de l'utilisateur s'affiche. Pour rechercher des utilisateurs spécifiques, saisissez leur nom dans le champ de recherche.
Sélectionnez un ou plusieurs utilisateurs dans la liste, puis cliquez sur Suivant.
Choisissez les services Gemini pour lesquels vous souhaitez attribuer des licences.
Cliquez sur Attribuer des licences.
API
Pour attribuer des licences Gemini à l'aide de l'API, vous devez disposer de l'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 facturationORDER_ID
: la 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 l'attribution de la licence aboutit.
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
Pour activer l'API Gemini pour Google Cloud, accédez à la page Gemini pour Google Cloud.
Dans le sélecteur de projet, sélectionnez un projet.
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
-
In the Google Cloud console, activate Cloud Shell.
Dans le menu de sélection du projet, sélectionnez un projet.
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 le projet Google Cloud spécifié pour tous les utilisateurs disposant des 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 également avoir besoin d'activer les API suivantes:
oauth2.googleapis.com
: permet de se connecter à Google Cloud.serviceusage.googleapis.com
: permet de vérifier que le projet Gemini Code Assist de l'utilisateur est correctement configuré.cloudaicompanion.googleapis.com
: point de terminaison principal de l'API Gemini pour Google Cloud.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. L'API Resource Manager peut ne pas être nécessaire si les projets sont configurés explicitement dans votre fichiersettings.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 l'envoi de commentaires dans l'IDE.apihub.googleapis.com
: utilisé par la fonctionnalité de navigateur d'API Cloud Code.
Facultatif: Configurer VPC Service Controls
Si votre organisation dispose d'un périmètre de service, vous devez y ajouter les ressources suivantes:
- API Gemini pour Google Cloud
- API Gemini Code Assist
Si vous utilisez Gemini Code Assist en dehors de votre périmètre de service, vous devez également modifier la stratégie d'entrée pour autoriser l'accès à ces services.
Pour en savoir plus, consultez la section Configurer VPC Service Controls pour Gemini.
Attribuer des rôles IAM dans un projet Google Cloud
Cette section décrit la procédure à suivre pour attribuer aux utilisateurs les rôles IAM Gemini pour les utilisateurs Google Cloud et les consommateurs de Service Usage.
Console
Pour accorder les rôles IAM requis pour utiliser Gemini, accédez à la page IAM et administration.
Dans la colonne Compte principal, recherchez un compte principal auquel vous souhaitez accorder l'accès à Gemini, puis cliquez sur Modifier le compte principal sur cette ligne.
Dans le volet Modifier les accès, cliquez sur
Ajouter un autre rôle.Dans Sélectionner un rôle, sélectionnez Utilisateur de Gemini pour Google Cloud.
Cliquez sur Ajouter un autre rôle, puis sélectionnez Consommateur Service Usage.
Cliquez sur Enregistrer.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Dans le menu de sélection du projet, sélectionnez un projet.
Accordez 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 formeuser|group|serviceAccount:email
oudomain:domain
(par exemple,user:cloudysanfrancisco@gmail.com
,group:admins@example.com
,serviceAccount:test123@example.domain.com
oudomain: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
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 auxquels ces rôles ont été attribués peuvent accéder aux fonctionnalités Gemini pour Google Cloud dans la console Google Cloud du projet spécifié. Pour en savoir plus, consultez la présentation de Gemini pour Google Cloud.
Installer le plug-in 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 :
- Cloud Workstations : coder avec Gemini Code Assist
- Éditeur Cloud Shell : coder avec Gemini Code Assist
- VS Code : Coder avec Gemini Code Assist
- IntelliJ et autres IDE JetBrains : Coder avec Gemini Code Assist
Tâches de configuration avancées
Au lieu d'utiliser la console Google Cloud ou 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 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.
Pour accéder à Gemini Code Assist, vous devez disposer des autorisations suivantes pour tous les rôles personnalisés que vous créez:
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
Pour accéder à Gemini Code Assist, vous devez disposer des autorisations suivantes pour tous les rôles personnalisés que vous créez:
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 pour que l'une des autorisations précédentes fonctionne, l'API Gemini pour Google Cloud doit être activée dans le même projet Google Cloud que celui dans lequel vous avez attribué chaque autorisation.
Étape suivante
- Découvrez les types d'assistance d'IA générative disponibles dans Gemini pour Google Cloud.
- Découvrez comment Gemini pour Google Cloud utilise vos données.
- Découvrez comment accéder aux commandes d'administration de Gemini Code Assist et les gérer.
- Découvrez comment configurer la personnalisation du code.
- Configurez VPC Service Controls pour Gemini.