Passer au contenu principal
Il existe des automatisations à la fois pour les Projects et les registres. L’emplacement où vous créez une automatisation, les événements que vous pouvez utiliser et le fonctionnement de la portée varient. Pour connaître les types d’événements par portée, voir événements et portée des automatisations. Les Automatisations W&B suivent ce schéma : lorsqu’un événement se produit et que des conditions facultatives sont remplies, une action s’exécute automatiquement. Par exemple :
  • Lorsqu’un run échoue (événement), notifier un canal Slack (action).
  • Lorsque l’alias production est ajouté à un artefact (événement), appeler un webhook pour déclencher un déploiement (action).
Les événements et les conditions disponibles diffèrent selon que les automatisations s’appliquent à un projet ou à un registre. Voir événements et portée des automatisations. Exemple : Le run échoue (événement) et un filtre facultatif sur le nom du run (condition), puis notification Slack (action). Ou : alias production ajouté (événement), puis webhook (action).

​
Où créer des automatisations

  • Dans un projet : ouvrez le projet, puis sélectionnez l’onglet Automatisations dans la barre latérale du projet.
  • Dans un registre : ouvrez le registre, puis sélectionnez l’onglet Automatisations.

​
Cas d’utilisation

  • Surveillance des runs et alertes : notifier l’équipe lorsqu’un run échoue ou lorsqu’une métrique franchit un seuil (par exemple, la perte passe à NaN ou la précision baisse).
  • CI/CD du Registry : lorsqu’une nouvelle version de modèle est liée ou qu’un alias (tel que staging ou production) est ajouté, déclencher un webhook pour exécuter des tests ou déployer.
  • Flux de travail des artefacts de projet : lorsqu’une nouvelle version d’artefact est créée ou qu’un alias est ajouté dans un projet, exécuter un job en aval ou publier sur Slack.
Pour obtenir tous les détails sur les événements et les portées, voir événements et portée des automatisations.

​
Actions d’automatisation

Lorsqu’un événement déclenche une automatisation, celle-ci peut exécuter l’une des actions suivantes :
  • Notification Slack : Envoie un message dans un canal Slack avec des détails sur l’événement déclencheur. Le message résume l’événement et inclut un lien pour afficher plus de détails dans W&B.
  • Webhook : Appelle une URL de webhook avec une charge utile JSON contenant des informations sur l’événement déclencheur. Utilisez les webhooks pour intégrer des systèmes externes tels que des pipelines CI/CD, des services de déploiement de modèles ou des flux de travail personnalisés.
Pour plus de détails sur l’implémentation, voir Créer une automatisation Slack et Créer une automatisation webhook.

​
Fonctionnement des automatisations

Pour créer une automatisation, vous devez :
  1. Si nécessaire, configurez des secrets pour les chaînes sensibles dont l’automatisation a besoin, comme des jetons d’accès, des mots de passe ou des détails de configuration sensibles. Les secrets sont définis dans Team Settings. Ils sont le plus souvent utilisés dans les automatisations webhook pour transmettre en toute sécurité des identifiants ou des jetons au service externe du webhook, sans les exposer en clair ni les coder en dur dans la charge utile du webhook.
  2. Configurez des intégrations webhook ou Slack au niveau de l’équipe afin d’autoriser W&B à publier dans Slack ou à exécuter le webhook en votre nom. Une même action d’automatisation (webhook ou notification Slack) peut être utilisée par plusieurs automatisations. Ces actions sont définies dans Team Settings.
  3. Dans le projet ou le registre, créez l’automatisation :
    1. Définissez l’événement à surveiller, par exemple l’ajout d’une nouvelle version d’artefact.
    2. Définissez l’action à effectuer lorsque l’événement se produit (publier dans un canal Slack ou exécuter un webhook). Pour un webhook, indiquez un secret à utiliser pour le jeton d’accès et/ou un secret à envoyer avec la charge utile, si nécessaire.

​
Recommandations

  • Commencez simple : commencez par une ou deux automatisations pour des événements à fort impact (par exemple, des échecs de run ou des changements d’alias de production). Vérifiez qu’elles fonctionnent comme prévu avant d’en ajouter d’autres.
  • Testez avant la mise en production : créez d’abord des automatisations dans un projet de test ou avec un webhook ou un salon Slack de test. Déclenchez manuellement l’événement, puis vérifiez que l’action s’exécute et que la charge utile ou le message est correct.
  • Évitez la surcharge d’alertes : utilisez des filtres de run, des seuils de métrique ou des motifs d’alias pour limiter la fréquence de déclenchement d’une automatisation. Si vous avez plusieurs niveaux de gravité, acheminez-les vers différents canaux.

​
Limites

Les automatisations des métriques de run et les automatisations de changement du z-score des métriques de run sont actuellement prises en charge uniquement dans W&B Multi-tenant Cloud.

​
Étapes suivantes

Vous cherchez des tutoriels complémentaires sur les automatisations ?