Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt

Use this file to discover all available pages before exploring further.

Il existe des automatisations à la fois pour les Projects et les registries. 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. W&B Automations follow a simple pattern: when an event occurs and optional conditions are met, an action runs automatically. For example:
  • When a run fails (event), notify a Slack channel (action).
  • When the production alias is added to an artifact (event), call a webhook to trigger deployment (action).
Events and available conditions differ for automations scoped to a project or a registry. See Automation events and scopes. 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

  • In a project: Open the project, then click the Automations tab in the project sidebar.
  • In a registry: Open the registry, then click the Automations tab.

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 :
  • Slack notification: Send a message to a Slack channel with details about the triggering event. The message summarizes the event, with a link to view more details in W&B.
  • Webhook: Call a webhook URL with a JSON payload containing information about the triggering event. This enables integration with external systems like CI/CD pipelines, model deployment services, or custom workflows.
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

  • Start small: Begin with one or two automations for high-value events (for example, run failures or production alias changes). Validate that they work as expected before adding more.
  • Test before production: Create automations in a test project or with a test webhook or Slack channel first. Manually trigger the event and confirm the action runs and the payload or message looks correct.
  • Avoid alert fatigue: Use run filters, metric thresholds, or alias patterns to limit how often an automation fires. Route different severities to different channels if needed.

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