- L’événement qui déclenche l’automatisation.
- Le prompt qu’ARIA reçoit lorsque l’événement se produit.
Disponible uniquement dans le Cloud mutualisé de W&B.ARIA fonctionne dans les projets d’équipe, et non dans votre entity personnel. L’administrateur de votre organisation doit également activer 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, 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 projet, au registre ou à la collection auquel l’automatisation est limitée.
- Pour limiter une automatisation W&B à un registre et envoyer des prompts à ARIA, vous devez appartenir à une équipe de la même organisation. Chaque conversation ARIA étant associée à une équipe, vous ne pouvez pas créer d’automatisation limitée à un registre si vous n’appartenez à aucune équipe de cette organisation.
Créer une automatisation
Sélectionnez Registre ou Projet selon la portée à laquelle l’automatisation doit s’appliquer. Suivez ensuite ces étapes pour créer une automatisation qui envoie un prompt à ARIA.Pour appliquer une automatisation plus largement, créez-la depuis le hub global Automations et sélectionnez la portée Team ou Organization. Les étapes sont identiques à celles décrites ci-dessous. Avec ces portées, W&B prend uniquement en charge les événements d’artifact et de collection. Voir Hub Automations.
- Registre
- Projet
Un administrateur de registre peut créer des automatisations dans ce registre.
- Connectez-vous à W&B.
- Cliquez sur le nom d’un registre pour afficher ses détails.
- 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).
- Choisissez l’événement à surveiller. Renseignez les éventuels champs supplémentaires qui s’affichent selon l’événement choisi. Par exemple, si vous sélectionnez An artifact alias is added, vous devez renseigner le champ Alias regex. Cliquez sur Next step.
- Sélectionnez l’équipe qui héberge la conversation ARIA. Les registres appartiennent à votre organisation et non à une équipe, mais chaque conversation ARIA doit appartenir à une équipe. Voir Afficher les conversations créées par des automatisations.
- Définissez Action type sur Trigger ARIA.
- Dans le champ Prompt, rédigez le prompt à envoyer à ARIA. Voir Rédiger le prompt. Cliquez sur Next step.
- Indiquez un nom pour l’automatisation et, si vous le souhaitez, une description.
- Cliquez sur Create automation.
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 : Demandez à ARIA de renommer une automatisation : Une fois que vous avez confirmé, ARIA renomme l’automatisation.Afficher vos automatisations ARIA dans le chat
Ouvrez ARIA, cliquez sur Reveal chat history dans l’en-tête du chat, puis ouvrez la section Customize en bas de la barre latérale de l’historique de conversation et sélectionnez My automations. My automations remplace la vue de conversation dans le panneau principal d’ARIA au lieu de s’ouvrir à côté. Pour revenir à la conversation, sélectionnez une conversation ou démarrez un nouveau chat. Le volet n’est pas conservé après un rechargement : actualiser la page vous ramène donc également à votre conversation. Le volet répertorie uniquement les automatisations que vous avez créées et qui envoient des prompts à ARIA. Les automatisations qui utilisent d’autres actions n’y figurent pas, pas plus que les automatisations ARIA de vos coéquipiers. Le volet est en lecture seule. Vous pouvez voir si une automatisation est activée ou désactivée, mais pour l’activer, la désactiver, la modifier ou la supprimer, cliquez sur View all automations afin d’ouvrir la page Automations complète dans un nouvel onglet. Voir Afficher et gérer les automatisations. Effectuez une recherche par nom ou parcourez les résultats par pages de 20 avec Previous et Next. La liste affiche le nom, l’Event type et le Scope de chaque automatisation. Cliquez sur une automatisation pour ouvrir sa vue détaillée, qui affiche les champs Description, Scope, Created by, Created, Status (Enabled ou Disabled), Event type et le Prompt ARIA qu’elle envoie. La section Automation history indique, pour chaque exécution, l’heure de déclenchement (Triggered) et le Status, ainsi qu’une colonne Conversation. Cliquez sur Open thread pour ouvrir la conversation créée par une exécution. La valeur No thread signifie que l’exécution n’a créé aucune conversation. Les exécutions restent affichées pendant 6 mois au maximum. Utilisez Back to chat ou Back to My automations pour quitter la liste ou une vue détaillée. Cliquez sur Create automation pour en créer une. Aucun formulaire ne s’ouvre : un nouveau chat ARIA démarre, avec le prompt suivant déjà envoyé en votre nom : Create automation est désactivé si vous disposez d’un accès à la facturation en lecture seule. My automations n’est pas disponible pour les comptes personnels : sélectionnez une organisation pour afficher vos automatisations. Le volet ne nécessite aucun feature flag distinct. Il est soumis aux mêmes contrôles d’accès que ceux décrits dans Exigences.Rédiger le prompt
Le prompt est le seul élément à configurer 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 le run, l’artifact ou la métrique qu’ARIA doit examiner. Tenez compte des contraintes suivantes :- Le prompt est obligatoire et ne peut pas dépasser 4 000 caractères. W&B vérifie à nouveau la longueur après avoir substitué les variables de modèle : un prompt enregistré sans erreur peut donc tout de même échouer lors de l’exécution de l’automatisation si les valeurs substituées sont longues. Un prompt qui ne passe pas cette vérification est consigné comme une exécution en échec dans l’historique des exécutions de l’automatisation.
- Une variable de modèle qui ne s’applique pas à l’événement est remplacée par une chaîne vide, et non par son propre nom. Utilisez uniquement les variables répertoriées pour votre événement.
- ARIA démarre une nouvelle conversation à chaque exécution de l’automatisation. Il ne reprend pas une conversation précédente et ne garde aucune mémoire des exécutions antérieures de la même automatisation.
Variables de modèle
Les variables de modèle utilisent la syntaxe${variable_name}. Les variables disponibles dans 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 sont également disponibles, en plus des précédentes :
Les remarques suivantes concernent certaines variables en particulier :
${artifact_version}est résolue en une instance d’artifact, par exemplewandb-artifact://_id/QXJ0aWZhY3Q6NTE3ODg5ODg3. Pour désigner la version par son nom, utilisez${artifact_version_string}.${artifact_metadata.KEY}lit une valeur de métadonnées personnalisées dans la version d’artifact qui a déclenché l’événement. RemplacezKEYpar la clé de métadonnées voulue. Seules les clés de métadonnées de premier niveau sont prises en charge.
Afficher les conversations créées par les automatisations
L’automatisation crée la conversation ARIA sous le compte de l’utilisateur qui l’a créée. La conversation apparaît dans la barre latérale de l’historique de conversation ARIA de cette personne, à côté des conversations qu’elle a elle-même lancé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 limitées à un projet ou à une équipe : la conversation est créée dans le projet où l’événement s’est produit.
-
Automatisations limitées à 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_projectest un projet réservé que W&B gère pour chaque équipe afin d’accueillir les conversations qui ne sont liées à aucun projet que vous avez ouvert. Vous n’avez pas à le créer, et il ne contient normalement rien d’autre que ces conversations.
thread_id de la conversation. Pour ouvrir cette conversation, utilisez le lien Open thread du volet My automations d’ARIA, généré à partir du même thread_id. Dans votre historique de conversation, rien ne distingue une conversation créée par une automatisation des autres.
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 global Automations. Dans la liste des automatisations, l’action apparaît 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. Il est impossible de transférer la propriété d’une automatisation. Supprimez-la, puis 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 présentent les limitations suivantes :- Les automatisations ARIA sont disponibles uniquement sur le Cloud mutualisé de W&B, dans les projets d’équipe, et seulement si l’administrateur de votre organisation a activé 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 a bien détecté l’événement, mais n’a pas exécuté son action.
- Si la personne qui a créé l’automatisation perd l’accès en écriture au projet ou si son compte est désactivé, toutes les exécutions ultérieures échouent. L’échec est consigné dans l’historique d’exécution de l’automatisation.
- Seul le créateur de l’automatisation peut la modifier.
- La bibliothèque Python
wandbne prend pas en charge les automatisations ARIA. Voir Gérer les automatisations avec l’API. - Le volet My automations du chat est en lecture seule. Pour activer, désactiver, modifier ou supprimer une automatisation, utilisez plutôt l’onglet Automations ou le hub.