Avant de pouvoir utiliser Gemini Code Assist, votre équipe a besoin pour effectuer 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 Cloud Code pour utiliser Gemini Code Assist dans un IDE.
Acheter un abonnement Gemini Code Assist
La procédure à suivre pour souscrire un abonnement Gemini Code Assist dépend de l'édition que vous achetez : Enterprise ou Standard. Pour obtenir la liste des fonctionnalités disponibles dans chaque édition, consultez la section Fonctionnalités compatibles.
Édition Enterprise
Gemini Code Assist Enterprise est disponible pour 19 $ par utilisateur et par mois avec un engagement de 12 mois jusqu'au 31 mars 2025. Contacter notre équipe commerciale pour profiter de cette offre promotionnelle.
Édition Standard
Vous pouvez essayer l'édition standard de 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 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
la
Rôle IAM roles/billing.admin
ou
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.
Cliquez sur Obtenir Gemini Code Assist. Si votre projet a déjà Gemini Code Assist, ce texte s'affiche Gérer Gemini Code Assist
La page Obtenir un abonnement Gemini Code Assist s'ouvre.
Dans Configurer l'abonnement, renseignez les champs pour configurer le dont voici une liste non exhaustive:
- Nom de l'abonnement.
- Nombre de licences dans l'abonnement.
- Période d'abonnement (mensuelle ou annuelle) 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 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 que vous devez recommencer le processus d'achat et réattribuer licences.
Pour consulter les détails de l'abonnement, cliquez sur Continuer.
Si vous acceptez les conditions, sélectionnez J'accepte les conditions de cet achat, puis cliquez sur Confirmer l'abonnement.
Cliquez sur Suivant: Gérer les attributions de licences Gemini.
L'abonnement Gemini Code Assist est désormais souscrit. Vous maintenant pour gérer l'attribution des licences Gemini dans votre organisation.
Attribuer des licences
Avant d'utiliser Gemini Code Assist, chaque utilisateur de votre organisation a besoin 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.
Choisissez 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 effectuer une recherche pour 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.
Sélectionnez les services Gemini pour lesquels vous souhaitez attribuer des licences.
Cliquez sur Attribuer des licences.
API
Pour attribuer des licences Gemini avec l'API, vous devez disposer du
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
: stratégie IAM
Corps de la requête :
{
"usernames": [
"[email protected]",
"[email protected]"
]
}
Le résultat ressemble à ce qui suit :
{}
La réponse est vide si la licence a bien été attribuée.
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 de projet, choisissez 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 les Google Cloud à tous les utilisateurs disposant du 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 vous devez également activer les API suivantes:
oauth2.googleapis.com
: utilisé pour se connecter à Google Cloud.serviceusage.googleapis.com
: utilisé pour vérifier que le projet Gemini Code Assist de l'utilisateur correctement configurés.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. Il est possible que l'API Resource Manager ne soit pas nécessaire si les projets sont explicitement configurés dans votresettings.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 les commentaires dans l'IDE l'envoi.apihub.googleapis.com
: utilisé par le navigateur de l'API Cloud Code.
Attribuer des rôles IAM dans un projet Google Cloud
Cette section décrit la procédure à suivre pour accorder à l'utilisateur Gemini pour Google Cloud et les rôles IAM Consommateur Service Usage aux utilisateurs.
Console
Pour accorder les rôles IAM requis pour utiliser Gemini, accédez à la section IAM et Administration.
Dans la colonne Compte principal, recherchez un compte principal pour lequel vous souhaitez accorder l'accès à Gemini, puis cliquez sur Modifiez 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 Gemini pour utilisateur 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.
Attribuez 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:[email protected]
,group:[email protected]
,serviceAccount:[email protected]
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 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 la présentation de Gemini pour Google Cloud.
Installer le plug-in Cloud Code pour utiliser 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 :
- Stations de travail cloud : coder avec Gemini Code Assist
- Éditeur Cloud Shell: Coder avec Gemini Code Assist
- Cloud Code pour VS Code : coder avec Gemini Code Assist
- Cloud Code pour IntelliJ et les autres IDE JetBrains: Coder avec Gemini Code Assist
Tâches de configuration avancées
Au lieu d'utiliser la console Google Cloud ou la CLI gcloud 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.
Les rôles personnalisés que vous créez doivent disposer les autorisations suivantes vous permettent d'accéder à Gemini Code Assist:
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
Les rôles personnalisés que vous créez doivent disposer des autorisations suivantes pour que vous puissiez accéder à Gemini Code Assist :
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 si l'une des autorisations précédentes fonctionne, Gemini pour l'API Google Cloud doit être activé dans le projet Google Cloud où que vous avez attribuées à chaque autorisation.
Étape suivante
- En savoir plus sur les types d'assistance d'IA générative disponibles dans Gemini Code Assist pour Google Cloud
- Découvrez comment Gemini Code Assist 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.