Configurer Duet AI pour les développeurs pour un projet

Avant de pouvoir utiliser Duet AI pour les développeurs dans les produits Google Cloud compatibles, votre équipe doit suivre les étapes décrites dans ce document:

  1. Souscrivez un abonnement à une ou plusieurs offres de produits Duet AI.

  2. Activer Duet AI dans un projet Google Cloud Cette étape est généralement effectuée par un administrateur.

  3. Si vous souhaitez utiliser Duet AI dans un IDE, installez le plug-in Cloud Code.

Souscrire un abonnement Duet AI

Si vous n'utilisez que Duet AI pour BigQuery, Spanner ou Colab Enterprise, vous pouvez ignorer cette section.

Vous pouvez essayer Duet AI pour les développeurs sans frais et sans abonnement jusqu'au 11 mai 2024, dans la limite d'un utilisateur par compte de facturation. Les organisations comptant plusieurs utilisateurs par compte de facturation doivent souscrire un abonnement, comme décrit dans cette section. Si vous avez déjà signé des contrats avec Google Cloud, contactez notre équipe commerciale avant de souscrire un abonnement.

  1. Dans la console Google Cloud, accédez à la page Administration Duet AI.

    Accéder à la page Administrateur Duet AI

  2. Lisez et acceptez le message Avant de commencer.

  3. Si vous ne disposez d'aucun abonnement pour ce compte de facturation, la page de promotion s'affiche. Cliquez sur Premiers pas avec Duet AI.

  4. Si vous y êtes invité, sélectionnez un compte de facturation, puis cliquez sur Continuer la page d'administration de Duet AI.

  5. Sur la page Abonnements, cliquez sur Souscrire un nouvel abonnement.

  6. Complétez les champs de Configurer l'abonnement, y compris le nom facultatif de l'abonnement, la durée d'engagement (mensuelle ou annuelle) et le nombre de licences dans l'abonnement.

    Indiquez si vous souhaitez renouveler automatiquement votre abonnement à l'issue de la période d'engagement (mensuelle ou annuelle). Votre abonnement et vos licences restent ainsi actifs. Si l'abonnement ne se renouvelle pas automatiquement, il prend fin à la fin de la période en cours. Vous devez alors recommencer la procédure d'achat pour récupérer les licences.

  7. Cliquez sur Continuer pour vérifier les détails de l'abonnement. Lisez et acceptez les conditions d'achat.

  8. Cliquez sur Terminer l'achat, puis confirmez votre abonnement.

La facturation est désormais activée pour Duet AI. Activez ensuite Duet AI dans un ou plusieurs projets associés à ce compte de facturation. Duet AI ne s'affichera pas pour les utilisateurs tant que vous ne l'aurez pas activé dans au moins un projet

Activer Duet AI dans un projet Google Cloud

Pour activer Duet AI dans un projet Google Cloud, un administrateur doit activer l'API Cloud AI Companion et attribuer aux utilisateurs les rôles Utilisateur Cloud AI Companion ainsi que les rôles Identity and Access Management (IAM) de lecteur Service Usage.

Console

  1. Pour activer l'API, accédez à la page API Cloud AI Companion dans la console Google Cloud.

    Accéder à l'API Cloud AI Companion

  2. Dans le sélecteur de projet, choisissez un projet.

  3. Cliquez sur Activer.

    La page est mise à jour et affiche l'état Activé. Duet AI est désormais disponible dans le projet Google Cloud sélectionné pour tous les utilisateurs disposant des rôles IAM requis.

  4. Pour accorder les rôles IAM requis pour utiliser Duet AI, accédez à la page IAM.

    Accéder à IAM

  5. Dans la colonne Compte principal, recherchez un compte principal pour lequel vous souhaitez activer l'accès à Duet AI, puis cliquez sur Modifier le compte principal sur cette ligne.

  6. Dans le volet Modifier l'accès, cliquez sur Ajouter un autre rôle.

  7. Dans Sélectionner un rôle, choisissez Utilisateur Cloud AI Companion.

  8. Cliquez sur Ajouter un autre rôle et sélectionnez Lecteur Service Usage.

  9. Cliquez sur Enregistrer.

gcloud

  1. Dans la console Google Cloud, activez Cloud Shell.

    Activer Cloud Shell

  2. Dans la liste déroulante du sélecteur de projet, choisissez un projet.

  3. Activez l'API Cloud AI Companion pour Duet AI à l'aide de la commande gcloud services enable:

    gcloud services enable cloudaicompanion.googleapis.com
    

    Si vous souhaitez activer l'API Cloud AI Companion pour 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.
    

    Duet AI est désormais disponible dans le projet Google Cloud spécifié pour tous les utilisateurs disposant des rôles IAM requis.

  4. Attribuez les deux rôles IAM requis pour utiliser Duet AI:

    1. Attribuez le rôle 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: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
      
    2. Attribuez le rôle Lecteur de Service Usage:

      gcloud projects add-iam-policy-binding  PROJECT_ID \
      --member=PRINCIPAL --role=roles/serviceusage.serviceUsageViewer
      

      Le résultat est une liste de liaisons de stratégie qui incluent les éléments suivants:

      - members:
        - user:PRINCIPAL
        role: roles/serviceusage.serviceUsageViewer
      

    Pour en savoir plus, consultez Attribuer un seul rôle et gcloud projects add-iam-policy-binding.

Tous les utilisateurs disposant de ces rôles peuvent accéder aux fonctionnalités de Duet AI dans la console Google Cloud au sein du projet spécifié. Pour en savoir plus, consultez la présentation de Duet AI dans Google Cloud.

Utiliser Duet AI dans un IDE

Si vous êtes développeur et que vous souhaitez utiliser Duet AI 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'attribuer des rôles IAM prédéfinis à l'aide de la console Google Cloud ou de la gcloud CLI, vous pouvez effectuer l'une des opérations suivantes:

  • Attribuez des rôles à l'aide des API REST IAM ou des bibliothèques clientes IAM.

    Si vous utilisez ces interfaces, utilisez les noms de rôle complets:

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageViewer

    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 attribuez des rôles personnalisés.

    Tous les rôles personnalisés que vous créez doivent disposer des autorisations suivantes pour accéder à Duet AI:

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

Étapes suivantes