Configurer Gemini Cloud Assist

Avant que vous puissiez utiliser Gemini Cloud Assist, votre administrateur doit suivre la procédure de configuration décrite dans ce document. Gemini Cloud Assist peut être configuré pour un projet ou un dossier.

Configurer Gemini Cloud Assist pour un projet

Les étapes suivantes expliquent comment configurer Gemini Cloud Assist pour un projet dans la console Google Cloud ou à l'aide de la CLI Google Cloud.

Console

  1. Accédez à la page Administration pour Gemini.

    Accéder à Gemini pour Google Cloud

  2. Dans le sélecteur de projets situé en haut de la page, sélectionnez la ressource de votre projet.

  3. Sélectionnez Obtenir Gemini Cloud Assist.

  4. Dans la boîte de dialogue Obtenir l'assistance Gemini Cloud, procédez comme suit:

    1. Sélectionnez la flèche d'expansion  dans la section API requises et recommandées.

    2. Assurez-vous que les API requises suivantes sont activées: l'API Gemini Cloud Assist et l'API Gemini pour Google Cloud.

    3. Dans la liste API recommandées, sélectionnez les API que vous souhaitez activer.

    4. Facultatif: sélectionnez Aidez Google à améliorer Cloud Assist en partageant vos requêtes et réponses.

    5. Sélectionnez Activer Gemini Cloud Assist sans frais.

  5. Cliquez sur Enregistrer.

  6. Attribuez les rôles IAM requis pour utiliser Gemini Cloud Assist.

    1. Accédez à la page IAM et administration.

      Accéder à IAM et administration

    2. Dans la colonne Compte principal, recherchez un compte principal auquel vous souhaitez accorder l'accès à Gemini Cloud Assist, 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 Cloud Assist.

    5. Cliquez sur Ajouter un autre rôle, puis sélectionnez Lecteur du recommender.

    Si le principal souhaite obtenir de l'aide concernant des produits auxquels il n'a pas encore accès, vous devrez peut-être lui accorder des rôles IAM supplémentaires. Consultez les Exigences IAM pour utiliser Gemini Cloud Assist pour obtenir un tableau des rôles IAM qui permettent une expérience optimale de Gemini Cloud Assist pour différents produits.

gcloud

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

    Activate Cloud Shell

  2. Activez l'API Gemini Cloud Assist à l'aide de la commande gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com
    

    Cette étape active également l'API Gemini pour Google Cloud, qui est également requise pour utiliser Gemini Cloud Assist.

    Si vous souhaitez activer l'API Gemini Cloud Assist dans un autre projet Google Cloud, ajoutez le paramètre --project:

    gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
    

    Le résultat ressemble à ce qui suit :

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
    Operation finished successfully.
    
  3. Attribuez des rôles IAM dans un projet Google Cloud. Pour en savoir plus, consultez les sections Attribuer un seul rôle et gcloud projects add-iam-policy-binding.

    1. Attribuez le rôle roles/geminicloudassist.user :

      gcloud projects add-iam-policy-binding  PROJECT_ID \
          --member=PRINCIPAL --role=roles/geminicloudassist.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/geminicloudassist.user
      
    2. Répétez l'étape précédente pour le rôle roles/recommender.viewer.

    Si le principal souhaite obtenir de l'aide concernant des produits auxquels il n'a pas encore accès, vous devrez peut-être lui accorder des rôles IAM supplémentaires. Consultez les Exigences IAM pour utiliser Gemini Cloud Assist pour obtenir un tableau des rôles IAM qui permettent une expérience optimale de Gemini Cloud Assist pour différents produits.

Configurer Gemini Cloud Assist pour un dossier

Les étapes suivantes expliquent comment configurer Gemini Cloud Assist pour un dossier dans la console Google Cloud. Vous ne pouvez pas utiliser Google Cloud CLI pour configurer Gemini Cloud Assist.

  1. Activez les API requises et recommandées.

    1. Accédez à la page Administration pour Gemini.

      Accéder à "Administration de Gemini"

    2. Dans le sélecteur de projets situé en haut de la page, sélectionnez votre ressource de dossier.

    3. Sélectionnez Obtenir des assistances Gemini Cloud.

      La boîte de dialogue Enable API for existing projects within folder (Activer l'API pour les projets existants dans le dossier) s'affiche.

    4. Dans la boîte de dialogue Activer l'API pour les projets existants dans un dossier,sélectionnez la flèche d'expansion  dans la section API requises et recommandées.

    5. Assurez-vous que les API requises suivantes sont activées: l'API Gemini Cloud Assist et l'API Gemini pour Google Cloud.

    6. Dans la liste API recommandées, sélectionnez les API que vous souhaitez activer.

    7. Facultatif: sélectionnez Aidez Google à améliorer Cloud Assist en partageant vos requêtes et réponses.

    8. Sélectionnez Activer Gemini Cloud Assist sans frais.

      Cette étape active les API requises et recommandées sélectionnées pour tous les projets du dossier. Si vous souhaitez des exceptions pour certains projets du dossier, vous pouvez bloquer l'activation des API en définissant une contrainte de règle d'administration Restreindre l'utilisation des services de ressources sur ces projets. Pour en savoir plus, consultez la section Limiter l'utilisation des ressources.

  2. Accordez les rôles IAM suivants ou créez des rôles personnalisés avec des autorisations équivalentes sur le dossier:

    • Utilisateur Gemini pour Google Cloud
    • Lecteur d'éléments Cloud
    • Visionneuse de l'outil de recommandation

    Si le principal souhaite obtenir de l'aide concernant des produits auxquels il n'a pas encore accès, vous devrez peut-être lui accorder des rôles IAM supplémentaires. Consultez les Exigences IAM pour utiliser Gemini Cloud Assist pour obtenir un tableau des rôles IAM qui permettent une expérience optimale de Gemini Cloud Assist pour différents produits.

  3. Si vous utilisez Gemini Cloud Assist avec des applications, vous devez également activer la gestion des applications. Cette étape crée un projet de gestion auquel vous devez associer un compte de facturation.

    1. Revenez à la page Administration pour Gemini.

      Accéder à "Administration de Gemini"

    2. Sélectionnez Activer la gestion des applications.

      La page des paramètres IAM et administration s'affiche.

    3. Sélectionnez Activer dans la section Activation de l'application de la page.

      La boîte de dialogue Activer les API d'applications pour ce dossier s'affiche.

    4. Sélectionnez Activer.

      Une barre d'état indique la progression de l'activation de l'API. La page des paramètres IAM et administration s'actualise une fois l'activation de l'API terminée.

    5. Sélectionnez Gérer la facturation.

      La page Compte associé s'affiche.

    6. Sélectionnez un compte de facturation dans la liste, puis sélectionnez Définir le compte.

  4. Accordez les rôles IAM que vous avez accordés au dossier à l'étape 2, ou créez des rôles personnalisés avec des autorisations équivalentes à celles du projet de gestion créé à l'étape précédente.

    Recherchez le projet de gestion du dossier:

    1. Revenez à la page Administration pour Gemini.

      Accéder à "Administration de Gemini"

    2. Dans le sélecteur de projets situé en haut de la page, sélectionnez votre ressource de dossier.

    3. Sélectionnez Gérer les paramètres de Gemini Cloud Assist.

      La boîte de dialogue Gérer Gemini Cloud Assist s'affiche.

    4. Notez le projet de gestion.

  5. (Facultatif) Configurez les paramètres des projets du dossier.

Étape suivante