Skip to main content
Utilisez une automatisation W&B pour envoyer un prompt à ARIA lorsqu’un événement spécifique se produit. Chaque fois que l’événement se produit, l’automatisation démarre une nouvelle conversation ARIA et lui envoie le prompt configuré. Une automatisation qui envoie un prompt à ARIA comporte deux parties principales :
  • L’événement qui déclenche l’automatisation.
  • Le prompt qu’ARIA reçoit lorsque l’événement se produit.
Utilisez ce flux de travail pour explorer les résultats d’expériences, résumer des runs ou en faire un rapport, ou encore examiner des métriques qui franchissent un seuil. L’envoi d’un prompt à ARIA est l’une des actions qu’une automatisation W&B peut effectuer. Pour créer des automatisations qui envoient des notifications vers d’autres destinations, référez-vous à Créer une automatisation Slack ou Créer une automatisation webhook. Vous pouvez également demander à ARIA de créer et de gérer des automatisations W&B à votre place. Pour plus de détails, voir Créer et gérer des automatisations avec ARIA.
Disponible uniquement sur le W&B Cloud mutualisé.ARIA fonctionne dans les projects d’équipe, et non dans votre entité personnelle. Votre administrateur de l’organisation doit également activer les Smart features. Voir Gouvernance et sécurité.

​
Exigences

Avant de créer une automatisation qui envoie un prompt à ARIA, vérifiez les points suivants :
  • ARIA doit être activé pour votre organisation. Si Trigger ARIA n’apparaît pas dans la liste Action type, c’est qu’ARIA n’est pas disponible pour votre organisation, votre portée ou votre déploiement. L’option est alors simplement absente de la liste, sans explication. Voir Gouvernance et sécurité.
  • Vous devez disposer d’un accès en écriture au project, au registre ou à la collection sur lesquels porte la portée de l’automatisation.
  • Pour définir la portée d’une automatisation W&B sur un registre et envoyer des prompts à ARIA, vous devez appartenir à une équipe de la même organisation. Chaque conversation ARIA est associée à une équipe : vous ne pouvez donc pas créer d’automatisation dont la portée est un registre si vous n’appartenez à aucune équipe de cette organisation.
Chaque fois qu’une automatisation ARIA s’exécute, elle démarre une conversation ARIA comptabilisée dans l’utilisation de votre organisation, au même titre qu’une conversation que vous démarrez vous-même.

​
Créer une automatisation

Sélectionnez registre ou Project selon la portée à laquelle vous souhaitez appliquer l’automatisation. Suivez ensuite ces étapes pour créer une automatisation qui envoie un prompt à ARIA.
Pour appliquer une automatisation à plus grande échelle, créez-la depuis le hub Automations global et sélectionnez la portée équipe ou organisation. Les étapes sont identiques à celles décrites ci-dessous. À ces portées, W&B ne prend en charge que les événements d’artifact et de collection. Voir Hub Automations.
Un admin de registre peut créer des automatisations dans ce registre.
  1. Connectez-vous à W&B.
  2. Cliquez sur le nom d’un registre pour afficher ses détails.
  3. Pour créer une automatisation limitée au registre, cliquez sur l’onglet Automations, puis sur Create automation. Une automatisation limitée à un registre s’applique automatiquement à toutes ses collections, y compris celles créées ultérieurement.
  4. Choisissez l’événement à surveiller. Renseignez les champs supplémentaires qui s’affichent ; ceux-ci varient selon l’événement. Par exemple, si vous sélectionnez An artifact alias is added, vous devez renseigner le champ Alias regex. Cliquez sur Next step.
  5. Sélectionnez l’équipe qui héberge la conversation ARIA. Voir Où la conversation apparaît.
  6. Définissez Action type sur Trigger ARIA.
  7. Dans le champ Prompt, rédigez le prompt à envoyer à ARIA. Voir Rédiger le prompt. Cliquez sur Next step.
  8. Donnez un nom à l’automatisation. Vous pouvez également ajouter une description.
  9. Cliquez sur Create automation.
L’automatisation est désormais active : elle démarre une nouvelle conversation ARIA chaque fois que l’événement choisi se produit dans le registre.

​
Créer et gérer des automatisations avec ARIA

ARIA peut créer, supprimer, activer et désactiver des automatisations à la demande. Demandez à ARIA de créer une automatisation : Interrogez ARIA sur vos automatisations existantes :

​
Rédiger le prompt

Le prompt est le seul élément que vous configurez pour une action ARIA. Rédigez-le comme vous rédigeriez un message dans la fenêtre de chat d’ARIA, et incluez des variables de modèle pour indiquer quel run, artifact ou métrique ARIA doit examiner. Gardez à l’esprit les contraintes suivantes :
  • Un prompt est requis et ne peut pas dépasser 4 000 caractères. W&B vérifie de nouveau la longueur après avoir substitué les variables de modèle : un prompt enregistré avec succès peut donc échouer lors de l’exécution de l’automatisation si les valeurs substituées sont longues. Un prompt qui échoue à cette vérification est consigné comme exécution en échec dans l’historique d’exécution de l’automatisation.
  • Une variable de modèle qui ne s’applique pas à l’événement est résolue en chaîne vide plutôt qu’en son propre nom. Utilisez uniquement les variables listées pour votre événement.
  • ARIA démarre une nouvelle conversation à chaque exécution de l’automatisation. Elle ne poursuit pas une conversation précédente et ne garde aucune mémoire des exécutions antérieures de la même automatisation.
Pour insérer une variable, cliquez sur le situé à côté d’elle dans la liste sous le champ Prompt. W&B ajoute la variable à la fin du prompt. La liste n’affiche que les variables applicables à l’événement que vous avez sélectionné. Par exemple, ce prompt analyse chaque nouvelle version de modèle liée :
Vous pouvez demander à ARIA de vous aider à formuler un prompt avant d’enregistrer l’automatisation :

​
Variables de modèle

Les variables de modèle utilisent la syntaxe ${variable_name}. Les variables disponibles pour un prompt dépendent de l’événement surveillé par l’automatisation. Les variables suivantes sont disponibles pour tous les événements : Selon l’événement, les variables suivantes s’ajoutent aux précédentes : Les remarques suivantes s’appliquent à certaines variables :
  • ${artifact_version} se résout en une instance d’artifact, par exemple wandb-artifact://_id/QXJ0aWZhY3Q6NTE3ODg5ODg3. Pour désigner la version par son nom, utilisez ${artifact_version_string}.
  • ${artifact_metadata.KEY} lit une valeur de metadata personnalisée dans la version d’artifact ayant déclenché l’événement. Remplacez KEY par la clé de metadata souhaitée. Seules les clés de metadata de premier niveau sont prises en charge.
Pour connaître les événements disponibles à chaque portée, voir Événements et portée des automatisations.

​
Consulter les conversations créées par les automatisations

L’automatisation crée la conversation ARIA sous le compte de l’utilisateur qui a créé l’automatisation, et non de l’utilisateur dont l’action a déclenché l’événement. La conversation apparaît dans l’historique de conversation ARIA de cette personne, sous Past conversations, aux côtés des conversations qu’elle a elle-même démarrées. Pour identifier l’utilisateur à l’origine de l’événement, incluez ${event_author} dans le prompt. L’emplacement de la conversation dépend de la portée de l’automatisation :
  • Automatisations dont la portée est un projet ou une équipe : la conversation est créée dans le projet où l’événement s’est produit.
  • Automatisations dont la portée est un registre : un registre appartient à votre organisation et non à une équipe, or les conversations ARIA doivent appartenir à une équipe. La conversation est donc créée dans l’équipe que vous avez sélectionnée lors de la création de l’automatisation, dans un projet nommé wandb_agent_default_project. Cherchez-la à cet endroit plutôt que dans le registre. wandb_agent_default_project est un projet réservé que W&B maintient pour chaque équipe afin d’héberger les conversations qui ne sont rattachées à aucun projet que vous avez ouvert. Vous n’avez pas à le créer, et il est normalement vide en dehors de ces conversations.
Pour vérifier que l’automatisation s’est bien exécutée, ouvrez son historique d’exécution. Une exécution ARIA réussie affiche le prompt envoyé par W&B ainsi qu’un corps de réponse contenant le thread_id de la conversation. W&B ne fournit aucun lien entre l’exécution et la conversation, et une conversation créée par une automatisation n’est pas signalée différemment dans votre historique de conversation.

​
Afficher et gérer les automatisations

Affichez et gérez les automatisations depuis l’onglet Automations d’un projet ou d’un registre, ou depuis le hub Automations global. Dans la liste des automatisations, l’action s’affiche sous le nom ARIA. Seul le créateur d’une automatisation qui envoie des prompts à ARIA peut la modifier, car la conversation ARIA s’exécute sous l’identité de cet utilisateur. Les membres de l’équipe disposant d’un accès en écriture au projet ou au registre peuvent afficher et supprimer l’automatisation, mais l’option Edit ne leur est pas proposée. Vous ne pouvez pas transférer la propriété d’une automatisation. Supprimez-la plutôt et demandez au nouveau propriétaire de la recréer. Procédez de la même manière pour récupérer une automatisation dont le créateur a quitté l’équipe.

​
Limitations

  • Les automatisations ARIA sont disponibles uniquement sur le Cloud mutualisé de W&B, dans les projects d’équipe, et seulement si votre administrateur de l’organisation a activé les Smart features.
  • Chaque automatisation peut démarrer au maximum trois conversations ARIA par minute. Au-delà de cette limite, W&B consigne les exécutions dans l’historique de l’automatisation avec le statut Skipped, ce qui signifie que l’automatisation correspondait à l’événement mais n’a pas exécuté son action.
  • Si la personne ayant créé l’automatisation perd l’accès en écriture au project ou si son compte est désactivé, toutes les exécutions suivantes échouent. L’échec apparaît dans l’historique d’exécution de l’automatisation.
  • Seul le créateur de l’automatisation peut la modifier.
  • La bibliothèque Python wandb ne prend pas en charge les automatisations ARIA. Voir Gérer les automatisations avec l’API.

​
Étapes suivantes