Enregistrer et partager des requêtes

Ce document explique comment enregistrer et partager des requêtes dans Vertex AI Studio. Les invites de partage vous permettent de collaborer avec les membres de votre équipe, d'assurer la cohérence et de créer une bibliothèque d'invites efficaces pour diverses tâches.

Le partage fonctionne comme suit :

  • Par défaut, tous les utilisateurs de Vertex AI ont un accès complet à toutes les requêtes enregistrées dans le projet. Il n'est pas nécessaire de partager les requêtes enregistrées avec d'autres utilisateurs du projet, sauf si des restrictions organisationnelles ou de projet ont été appliquées à ces requêtes ou à des ressources spécifiques comme des ensembles de données.

  • Les utilisateurs de Vertex AI peuvent partager n'importe quel prompt du projet, même ceux qu'ils n'ont pas créés ni enregistrés.

  • Seuls les utilisateurs de Vertex AI peuvent partager des requêtes. Si un utilisateur externe est invité à collaborer sur une requête, il ne peut pas la partager avec un autre utilisateur.

  • Le partage de requêtes s'effectue par requête, et non par projet. Les utilisateurs invités ne peuvent accéder qu'aux requêtes sur lesquelles ils ont été invités à collaborer. Il n'a pas accès aux autres invites du projet.

Avant de commencer

Si la fonctionnalité de partage de prompts n'est pas encore activée pour le projet, demandez à votre administrateur de l'activer.

Pour activer le partage d'invites, l'administrateur doit disposer des autorisations suivantes :

  • Au niveau de l'organisation :

    • Autorisations permettant de gérer les règles de refus (roles/iam.denyAdmin)

  • Au niveau du projet :

    • Autorisations permettant de gérer les rôles personnalisés (roles/iam.roleAdmin)

    • Autorisations permettant d'attribuer et de supprimer des rôles pour les comptes principaux (roles/resourcemanager.projectIamAdmin)

    • Autorisations permettant de gérer les comptes de service (roles/iam.serviceAccountAdmin)

    • Autorisations permettant de gérer les tags (roles/resourcemanager.tagAdmin)

    • Autorisations permettant d'utiliser des tags (roles/resourcemanager.tagUser)

    • Autorisations d'utiliser les ressources Vertex AI ( roles/aiplatform.user)

Activer le partage de prompts

Pour activer le partage de prompts :

  1. Dans Vertex AI Studio, accédez à Gestion des requêtes ou à Bac à sable Chat.

    Accéder à la gestion des requêtes

    Accéder à Chat Playground

  2. Ouvrez un prompt enregistré, puis cliquez sur le bouton Partager.

    Si votre compte dispose des autorisations nécessaires pour activer le partage, un bouton Activer s'affiche.

    Bouton d'activation du partage de requêtes

    Si votre compte ne dispose pas des autorisations nécessaires pour activer le partage, une liste des rôles requis s'affiche.

    Rôles requis pour le partage de requêtes

  3. Cliquez sur Activer.

    Le système crée un compte de service au niveau du projet, appelé compte de service de partage des requêtes, dans votre projet avec les autorisations requises pour le partage des requêtes. Pour en savoir plus, consultez Informations sur la sécurité.

Enregistrer un prompt

Pour enregistrer une requête pour une utilisation ou un partage ultérieurs :

  1. Accédez à Vertex AI Studio.

    Accéder à Vertex AI Studio

  2. Rédigez une requête ou ouvrez-en une existante, puis cliquez sur Envoyer Envoyer.

  3. Cliquez sur le bouton  Enregistrer.

Partager un prompt enregistré

Une fois le partage d'invites activé, tout utilisateur Vertex AI peut partager une invite enregistrée.

  1. Dans Vertex AI Studio, accédez à Gestion des requêtes ou à Bac à sable Chat.

    Accéder à la gestion des requêtes

    Accéder à Chat Playground

  2. Ouvrez un prompt enregistré, puis cliquez sur le bouton Partager.

    Si le partage d'invites a été activé, une fenêtre semblable à celle-ci s'affiche :

    Fenêtre de partage de requêtes

    Lorsqu'une requête est partagée, le ou les destinataires reçoivent une notification par e-mail semblable à celle-ci :

    Adresse e-mail de partage de prompt

Arrêter de partager une requête

Pour révoquer l'accès à une requête :

  1. Ouvrez un prompt enregistré, puis cliquez sur le bouton Partager.

  2. À côté des principaux, sélectionnez Supprimer, puis cliquez sur Enregistrer.

    Arrêter le partage de prompts

    Notez que la suppression d'une requête enregistrée supprime automatiquement l'accès pour toutes les personnes avec lesquelles elle a été partagée.

Informations relatives à la sécurité

Lorsque vous activez le partage des requêtes, vous accordez au service de l'API Vertex AI les autorisations nécessaires pour inviter des utilisateurs à rejoindre votre projet en votre nom. Plus précisément, vous créez un compte de service au niveau du projet, appelé compte de service de partage d'invites, dans votre projet avec les autorisations suivantes :

  • iam.roles.create
  • iam.roles.list
  • iam.roles.update
  • iam.roles.delete
  • resourcemanager.projects.setIamPolicy
  • resourcemanager.projects.getIamPolicy
  • cloudasset.assets.searchAllIamPolicies

Pour s'assurer que seul le service d'API Vertex AI est autorisé à utiliser le compte de service de partage d'invites, le système crée automatiquement une règle de refus lorsque le partage d'invites est activé.

Étape suivante