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

# Aperçu d’Automations

> Utilisez l’API W&B Automations pour créer et gérer des flux de travail automatisés dans vos pipelines ML

L’API W\&B Automations permet de créer et de gérer par programmation des flux de travail automatisés qui réagissent aux événements de votre pipeline ML. Configurez des actions pour qu’elles se déclenchent lorsque des conditions spécifiques sont remplies, comme des seuils de performance du modèle ou la création d’un artifact.

<div id="core-classes">
  ### Classes principales
</div>

| Classe                                                              | Description                                                                 |
| ------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| [`Automation`](/fr/models/ref/python/automations/automation/)       | Représente une instance d’automatisation enregistrée avec sa configuration. |
| [`NewAutomation`](/fr/models/ref/python/automations/newautomation/) | Classe utilitaire permettant de créer de nouvelles automatisations.         |

<div id="events-triggers">
  ### Événements (Déclencheurs)
</div>

| Événement                                                                     | Description                                                                                       |
| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [`OnRunMetric`](/fr/models/ref/python/automations/onrunmetric/)               | Se déclenche lorsqu'une métrique de run satisfait une condition définie (seuil, variation, etc.). |
| [`OnCreateArtifact`](/fr/models/ref/python/automations/oncreateartifact/)     | Se déclenche lorsqu'un nouvel artifact est créé dans une collection.                              |
| [`OnLinkArtifact`](/fr/models/ref/python/automations/onlinkartifact/)         | Se déclenche lorsqu'un artifact est lié à un registre.                                            |
| [`OnAddArtifactAlias`](/fr/models/ref/python/automations/onaddartifactalias/) | Se déclenche lorsqu'un alias est ajouté à un artifact.                                            |

<div id="actions">
  ### Actions
</div>

| Action                                                                    | Description                                                      |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [`SendNotification`](/fr/models/ref/python/automations/sendnotification/) | Envoyer des notifications via Slack ou d’autres canaux intégrés. |
| [`SendWebhook`](/fr/models/ref/python/automations/sendwebhook/)           | Envoyer des requêtes webhook HTTP à des services externes.       |
| [`DoNothing`](/fr/models/ref/python/automations/donothing/)               | Action factice pour tester les configurations d’automatisation.  |

<div id="filters">
  ### Filtres
</div>

| Filtre                                                                              | Description                                                                             |
| ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [`MetricThresholdFilter`](/fr/models/ref/python/automations/metricthresholdfilter/) | Filtre les runs en comparant les valeurs des métriques à des seuils.                    |
| [`MetricChangeFilter`](/fr/models/ref/python/automations/metricchangefilter/)       | Filtre les runs en fonction de l’évolution de la valeur d’une métrique au fil du temps. |

<div id="common-use-cases">
  ## Cas d’usage courants
</div>

<div id="model-performance-monitoring">
  ### Surveillance des performances du modèle
</div>

* Déclencher une alerte lorsque l’accuracy du modèle passe sous un seuil
* Notifier l’équipe lorsque la perte d’entraînement plafonne
* Déclencher des pipelines de réentraînement en fonction des métriques de performance

<div id="artifact-management">
  ### Gestion des Artifacts
</div>

* Envoyer des notifications lorsque de nouvelles versions de modèle sont créées
* Déclencher des flux de travail de déploiement lorsque des artifacts sont tagués
* Automatiser les traitements en aval lorsque des jeux de données sont mis à jour

<div id="experiment-tracking">
  ### Suivi des expériences
</div>

* Alertes en cas de runs en échec ou plantés
* Notifications lorsque des expériences de longue durée se terminent
* Envoi de résumés quotidiens des métriques des expériences

<div id="integration-workflows">
  ### Flux de travail d’intégration
</div>

* Mettre à jour des systèmes de suivi externes via des webhooks
* Synchroniser le registre de modèles avec des plateformes de déploiement
* Déclencher des pipelines CI/CD à partir d’événements W\&B

<div id="example-usage">
  ## Exemple d’utilisation
</div>

L’exemple suivant crée une automatisation qui envoie une notification Slack chaque fois qu’une métrique appelée `custom-metric` dépasse 10. La métrique `custom-metric` est censée être enregistrée pendant l’entraînement à l’aide de `wandb.Run.log({"custom-metric": value })`.

```python theme={null}
import wandb
from wandb.automations import OnRunMetric, RunEvent, SendNotification

api = wandb.Api()

project = api.project("<my-project>", entity="<my-team>")

# Utiliser la première intégration Slack pour l'équipe
slack_hook = next(api.slack_integrations(entity="<my-team>"))

# Créer un événement déclencheur
event = OnRunMetric(
     scope=project,
     filter=RunEvent.metric("custom-metric") > 10,
)

# Créer une action qui répond à l'événement
action = SendNotification.from_integration(slack_hook)

# Créer l'automatisation
automation = api.create_automation(
     event >> action,
     name="my-automation",
     description="Envoyer un message Slack chaque fois que 'custom-metric' dépasse 10.",
)
```

Pour en savoir plus sur l’utilisation de l’API Automations, consultez le [guide Automations](/fr/models/automations/).