> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-docs-2989.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Aperçu des automatisations

> Utilisez les automatisations W&B pour déclencher des flux de travail en fonction d’événements dans W&B

*Les automatisations* envoient des notifications Slack ou déclenchent des webhooks en réponse à des événements spécifiques dans W\&B. Vous pouvez définir la portée d’une automatisation au niveau d’une organisation, d’une équipe, d’un projet, d’un registre ou d’une collection. Une automatisation surveille l’événement dans l’ensemble des ressources incluses dans sa portée, y compris les projets, registres et collections créés ultérieurement. La procédure de création d’une automatisation et les événements disponibles dépendent de sa portée. Pour connaître les types d’événements par portée, voir [événements et portée des automatisations](/fr/models/automations/automation-events).

<Note>
  Les automatisations à l’échelle d’une équipe ou d’une organisation, ainsi que le [hub Automatisations](#automations-hub), sont disponibles sur Cloud mutualisé de W\&B et sur W\&B Cloud dédié (Server v0.83.0 et versions ultérieures).
</Note>

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).
  <TutorialDiagramProject />
* Lorsque l’alias `production` est ajouté à un artefact (événement), appeler un webhook pour déclencher un déploiement (action).
  <TutorialDiagramRegistry />

Les événements et les conditions disponibles diffèrent selon que les automatisations s’appliquent à un [projet](/fr/models/automations/automation-events#project) ou à un [registre](/fr/models/automations/automation-events#registry). Voir [événements et portée des automatisations](/fr/models/automations/automation-events).

```mermaid theme={null}
flowchart LR
  Event[Événement] --> Condition[Condition]
  Condition --> Action[Action]
```

**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).

<div id="where-to-create-automations">
  ## Où créer des automatisations
</div>

* **Dans le hub Automatisations** : sélectionnez **Automatisations** dans la navigation de gauche pour voir toutes les automatisations auxquelles vous avez accès, toutes portées confondues : organisation, équipe, projet, registre ou collection. Vous choisissez la portée lors de la création d’une automatisation. Voir le [hub Automatisations](/fr/models/automations#automations-hub).

- **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**.

<div id="automations-hub">
  ## Hub Automatisations
</div>

Le hub **Automatisations** est une section globale de la navigation de gauche qui regroupe, dans une liste unique, toutes les automatisations auxquelles vous avez accès, toutes portées et projets confondus. Utilisez-le pour découvrir, examiner et gérer les automatisations sans devoir accéder à chaque projet ou registre.

Depuis le hub **Automatisations**, vous pouvez :

* Créer une automatisation et choisir sa portée, sans avoir à connaître au préalable le point d'entrée correspondant.
* Afficher dans une seule liste toutes les automatisations auxquelles vous avez accès, puis les filtrer et les trier (par exemple, par portée, déclencheur ou action).
* Cliquer sur le nom d'une automatisation pour afficher les détails complets de sa configuration.
* Afficher l'[historique d'exécution](/fr/models/automations/view-automation-history) d'une automatisation pour vérifier si elle a réussi ou échoué.
* Utiliser le filtre rapide pour basculer entre les automatisations que vous avez créées et toutes les automatisations de votre organisation.
* Sélectionner plusieurs automatisations et les supprimer en une seule fois.

Le hub **Automatisations** complète l'onglet **Automatisations** de chaque projet et registre ; ces onglets spécifiques à une portée restent disponibles pour un accès ciblé rapide.

<div id="use-cases">
  ## Cas d’utilisation
</div>

* **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](/fr/models/automations/automation-events).

<div id="automation-actions">
  ## Actions d’automatisation
</div>

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](/fr/models/automations/create-automations/slack) et [Créer une automatisation webhook](/fr/models/automations/create-automations/webhook).

<div id="how-automations-work">
  ## Fonctionnement des automatisations
</div>

Pour [créer une automatisation](/fr/models/automations/create-automations), vous devez :

1. Si nécessaire, configurez des [secrets](/fr/platform/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](/fr/models/automations/automation-events) à 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.

<div id="recommendations">
  ## Recommandations
</div>

* **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.

<div id="limitations">
  ## Limitations
</div>

* Les [automatisations sur les métriques des runs](/fr/models/automations/automation-events/#run-metrics-change) et les [automatisations sur les variations du score z des métriques des runs](/fr/models/automations/automation-events/#run-metrics-z-score-change) sont prises en charge uniquement dans le [Cloud mutualisé de W\&B](/fr/platform/hosting/#wb-multi-tenant-cloud) et le [Cloud dédié](/fr/platform/hosting/hosting-options/dedicated-cloud).
* Aux portées **Équipe** et **Organisation**, W\&B App ne prend en charge que les événements liés aux artefacts et aux collections. Les événements basés sur les runs ne sont pas disponibles dans W\&B App à ces portées. Voir [événements et portée des automatisations](/fr/models/automations/automation-events).

<div id="next-steps">
  ## Étapes suivantes
</div>

* [Tutoriel sur les automatisations](/fr/models/automations/tutorial) : vous guide dans la création d’une automatisation de projet pour alerter en cas d’échec de run, ainsi que d’une automatisation Registry pour exécuter un webhook lorsqu’un alias est ajouté. Le tutoriel utilise l’application W\&B.
* [Créer une automatisation](/fr/models/automations/create-automations).
* [Événements et portée des automatisations](/fr/models/automations/automation-events).
* [Créer un secret](/fr/platform/secrets).

<Info>
  Vous cherchez des tutoriels complémentaires sur les automatisations ?

  * [Découvrez comment déclencher automatiquement une GitHub Action pour l'évaluation et le déploiement de modèles](https://wandb.ai/wandb/wandb-model-cicd/reports/Model-CI-CD-with-W-B--Vmlldzo0OTcwNDQw).
  * [Regardez une vidéo montrant comment déployer automatiquement un modèle vers un endpoint SageMaker](https://www.youtube.com/watch?v=s5CMj_w3DaQ).
  * [Regardez une série de vidéos présentant les automatisations](https://youtube.com/playlist?list=PLD80i8An1OEGECFPgY-HPCNjXgGu-qGO6\&feature=shared).
</Info>
