Configurer Gemini Cloud Assist dans Cloud Billing

Pour configurer Gemini Cloud Assist dans la facturation Cloud, procédez comme suit:

  1. Activez l'API Gemini pour Google Cloud dans un projet Google Cloud. Cette étape est généralement effectuée par un administrateur.

  2. Dans le projet Google Cloud, attribuez des rôles IAM (Identity and Access Management) aux mêmes utilisateurs qui accèdent aux rapports Cloud Billing. Cette étape est généralement effectuée par un administrateur.

  3. Pour les utilisateurs qui ont besoin d'accéder aux rapports Cloud Billing et à Gemini Cloud Assist dans Cloud Billing, attribuez des rôles IAM dans le compte de facturation Cloud associé au projet où l'API Gemini pour Google Cloud est activée. Cette étape est généralement effectuée par un administrateur.

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

  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.

    Pour les utilisateurs de Cloud Billing disposant d'autorisations au niveau du compte de facturation sur le compte de facturation Cloud, nous vous recommandons d'utiliser un projet d'administration FinOps pour contenir l'API.

  3. Cliquez sur Activer.

    La page est mise à jour et affiche l'état API activée.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. Dans le menu de sélection du projet, sélectionnez un projet.

    Pour les utilisateurs Cloud Billing disposant d'autorisations au niveau du compte de facturation sur le compte de facturation Cloud, nous vous recommandons d'utiliser un projet d'administration FinOps pour contenir l'API.

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

Une fois que vous avez activé l'API Gemini pour Google Cloud dans le projet Google Cloud spécifié, Gemini Cloud Assist est disponible pour tous les utilisateurs disposant des rôles IAM requis pour le projet spécifié.

Attribuer des rôles IAM dans un projet Google Cloud

Cette section décrit les étapes à suivre pour accorder les autorisations de projet requises pour utiliser Gemini Cloud Assist. Dans le projet Google Cloud dans lequel vous avez activé l'API Gemini pour Google Cloud, attribuez les rôles IAM suivants aux utilisateurs (principaux) du projet:

  • Utilisateur Gemini pour Google Cloud
  • Consommateur Service Usage

Console

  1. Pour attribuer les rôles IAM requis pour utiliser Gemini pour Google Cloud, 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 de Gemini pour Google Cloud.

  5. Cliquez sur Ajouter un autre rôle, puis sélectionnez Consommateur 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 du projet, sélectionnez un projet.

  3. 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 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 en savoir plus, consultez les sections Attribuer un rôle unique et gcloud projects add-iam-policy-binding.

Tous les utilisateurs (principaux) auxquels ces rôles sont attribués peuvent accéder aux fonctionnalités Gemini pour Google Cloud dans la console Google Cloud du projet spécifié. Si les utilisateurs du projet ont également accès aux rapports Cloud Billing, ils peuvent utiliser Gemini Cloud Assist dans les rapports Cloud Billing pour obtenir une assistance basée sur l'IA pour créer des rapports sur les coûts et résumer les insights clés de ces rapports. Pour en savoir plus, consultez la présentation de Gemini Cloud Assist dans Cloud Billing.

Tâches de configuration IAM avancées pour les projets

Au lieu d'utiliser la console Google Cloud ou gcloud CLI pour attribuer des rôles IAM prédéfinis à un projet, 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 pour les autorisations de projet ont besoin des autorisations suivantes pour accéder à Gemini pour Google Cloud:

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

Attribuer des rôles IAM dans un compte de facturation Cloud

Pour les utilisateurs qui ont besoin d'accéder aux rapports Cloud Billing, vous devez accorder des autorisations sur le compte de facturation Cloud suffisantes pour accéder à la page Rapports. Pour utiliser Gemini Cloud Assist dans le rapport de facturation, accordez un accès au compte de facturation Cloud associé au projet où l'API Gemini pour Google Cloud est activée.

Étape suivante