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

# Événements et portées des Automations

> Découvrez les événements et les portées qui déclenchent les Automations W&B, notamment les changements d’artifact, le statut du run et les conditions sur les métriques.

Une automatisation peut démarrer lorsqu’un événement spécifique se produit dans un projet ou un registre. Cette page décrit les événements pouvant déclencher une automatisation dans chacune de ces portées, afin que vous puissiez choisir le bon déclencheur lors de la configuration d’une automatisation. Pour en savoir plus sur les automatisations, consultez l’[Aperçu des automatisations](/fr/models/automations) ou [Créer une automatisation](/fr/models/automations/create-automations).

<div id="registry">
  ## Registre
</div>

Les sections suivantes décrivent les périmètres et les événements d’une automatisation dans un [registre](/fr/models/registry).

<div id="scopes">
  ### Périmètres
</div>

Une automatisation de [registre](/fr/models/registry) surveille l’événement qui se produit dans n’importe quelle collection d’un registre donné, y compris les collections ajoutées ultérieurement.

### Événements <a id="registry-events" aria-label="Événements du registre" />

Une automatisation du registre peut surveiller ces événements :

* **Une nouvelle version est liée à une collection** : testez et validez de nouveaux modèles ou jeux de données lorsqu'ils sont ajoutés au registre.
* **Un alias d'artifact est ajouté** : déclenchez une étape spécifique de votre flux de travail lorsqu'une nouvelle version d'artifact se voit attribuer un alias spécifique. Par exemple, déployez un modèle lorsque l'alias `production` lui est appliqué.

Lorsque l'automatisation appelle un webhook, elle peut accéder aux mêmes configurations de webhook au niveau de l'équipe et aux [secrets d'équipe](/fr/platform/secrets) que les automatisations limitées au projet.

<div id="project">
  ## Projet
</div>

Les sections suivantes décrivent les périmètres et les événements d’une automatisation dans un [projet](/fr/models/track/project-page).

### Portées

Une automatisation au niveau du projet surveille l’événement qui se produit sur n’importe quelle collection du projet. Selon l’événement que vous spécifiez, vous pouvez encore restreindre le périmètre de l’automatisation.

<div id="artifact-events">
  ### Événements d'artifact
</div>

Cette section décrit les événements liés à un artifact qui peuvent déclencher une automatisation.

* **Une nouvelle version est ajoutée à un artifact** : appliquez des actions récurrentes à chaque version d'un artifact. Par exemple, lancez une tâche d'entraînement lorsqu'une nouvelle version d'un artifact de jeu de données est créée.
* **Un alias d'artifact est ajouté** : déclenchez une étape spécifique de votre flux de travail lorsqu'une nouvelle version d'artifact dans un projet se voit attribuer un alias correspondant à la **regex d'alias** que vous spécifiez. Par exemple, exécutez une série d'étapes de traitement en aval lorsqu'un artifact se voit attribuer l'alias `test-set-quality-check`, ou exécutez un flux de travail chaque fois qu'une nouvelle version d'artifact reçoit l'alias `latest`. Une seule version d'artifact peut avoir un alias donné à un instant donné.
* **Un tag d'artifact est ajouté** : déclenchez une étape spécifique de votre flux de travail lorsqu'une version d'artifact dans un projet se voit attribuer un tag correspondant à la **regex de tag** que vous spécifiez. Par exemple, spécifiez `^europe.*` pour déclencher un flux de travail géospécifique lorsqu'un tag commençant par la chaîne `europe` est ajouté à une version d'artifact. Utilisez les tags d'artifact pour le regroupement et le filtrage. Vous pouvez attribuer le même tag à plusieurs versions d'artifact.

<div id="run-events">
  ### Événements de run
</div>

Les sections suivantes décrivent comment configurer une automatisation qui se déclenche par une modification du [statut d'un run](/fr/models/runs/run-states) ou par une modification de la [valeur d'une métrique d'un run](/fr/models/track/log#what-data-is-logged-with-specific-wb-api-calls).

<div id="run-status-change">
  #### Changement du statut d'un run
</div>

<Note>
  * Disponible actuellement uniquement sur le [Cloud mutualisé de W\&B](/fr/platform/hosting#wb-multi-tenant-cloud) et le [Cloud dédié](/fr/platform/hosting#wb-dedicated-cloud).
  * Un run ayant le statut **Killed** ne peut pas déclencher d'automatisation. Ce statut indique qu'un administrateur a arrêté le run de force.
</Note>

Déclenchez un flux de travail lorsqu'un run change de [statut](/fr/models/runs/run-states) et passe à **Running**, **Finished** ou **Failed**. Vous pouvez également restreindre les runs susceptibles de déclencher une automatisation en spécifiant un filtre sur l'utilisateur ou le nom du run.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/automations/run_status_change.png?fit=max&auto=format&n=wKCrMJZKG3PxyJhv&q=85&s=04192e3409e8306da96f6c7c1716af7e" alt="Capture d'écran montrant une automatisation de changement du statut d'un run" width="434" height="419" data-path="images/automations/run_status_change.png" />
</Frame>

Comme le statut d'un run est une propriété du run dans son ensemble, vous ne pouvez créer une automatisation de statut de run que depuis la page **Automations**, et non depuis un workspace.

<div id="run-metrics-change">
  #### Changement des métriques de run
</div>

<Note>
  Disponible actuellement uniquement sur le [Cloud mutualisé de W\&B](/fr/platform/hosting#wb-multi-tenant-cloud) et le [Cloud dédié](/fr/platform/hosting#wb-dedicated-cloud).
</Note>

Déclenchez un flux de travail en fonction d'une valeur enregistrée pour une métrique, qu'il s'agisse d'une métrique de l'historique d'un run ou d'une [métrique système](/fr/models/ref/python/experiments/system-metrics) telle que `cpu`, qui indique le pourcentage d'utilisation du CPU. W\&B enregistre automatiquement les métriques système toutes les 15 secondes.

Vous pouvez créer une automatisation de métriques de run depuis l'onglet **Automations** du projet ou directement depuis un panneau de graphique linéaire dans un Workspace.

Pour configurer une automatisation de métrique de run, définissez comment comparer la valeur de la métrique au seuil que vous spécifiez. Les options proposées dépendent du type d'événement et des filtres que vous définissez.

Vous pouvez également limiter davantage les runs susceptibles de déclencher une automatisation en spécifiant un filtre sur l'utilisateur ou sur le nom du run.

<div id="threshold">
  ##### Seuil
</div>

Utilisez un événement de seuil pour démarrer une automatisation lorsqu'une métrique franchit une valeur fixe. Pour les événements **Seuil des métriques du run atteint**, vous configurez :

1. La fenêtre des valeurs enregistrées les plus récentes à prendre en compte (5 par défaut).
2. La valeur **Average**, **Min** ou **Max** à évaluer dans la fenêtre.
3. La comparaison à effectuer :
   * Supérieur à
   * Supérieur ou égal à
   * Inférieur à
   * Inférieur ou égal à
   * Différent de
   * Égal à

Par exemple, déclenchez une automation lorsque la moyenne de `accuracy` est supérieure à `0.6`.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/automations/run_metrics_threshold_automation.png?fit=max&auto=format&n=wKCrMJZKG3PxyJhv&q=85&s=d79d48588ba7158fb1324effc617590f" alt="Capture d'écran montrant une automation de seuil des métriques du run" width="434" height="478" data-path="images/automations/run_metrics_threshold_automation.png" />
</Frame>

<div id="change-threshold">
  ##### Seuil de variation
</div>

Utilisez un événement de seuil de variation pour démarrer une automatisation lorsqu’une métrique varie entre deux fenêtres récentes de valeurs. Pour les événements **Seuil de variation des métriques de run atteint**, l’automatisation utilise deux « fenêtres » de valeurs pour déterminer si elle doit se déclencher :

* La *fenêtre actuelle* des valeurs récemment enregistrées à prendre en compte (10 par défaut).
* La *fenêtre précédente* des valeurs récemment enregistrées à prendre en compte (50 par défaut).

Les fenêtres actuelle et précédente sont consécutives et ne se chevauchent pas.

Pour créer l’automatisation, configurez :

1. La fenêtre actuelle des valeurs enregistrées (10 par défaut).
2. La fenêtre précédente des valeurs enregistrées (50 par défaut).
3. Si les valeurs doivent être évaluées de façon relative ou absolue (**Relative** par défaut).
4. La comparaison à effectuer :
   * Augmente d’au moins
   * Diminue d’au moins
   * Augmente ou diminue d’au moins

Par exemple, déclenchez une automatisation lorsque la moyenne de `loss` diminue d’au moins `0.25`.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/wKCrMJZKG3PxyJhv/images/automations/run_metrics_change_threshold_automation.png?fit=max&auto=format&n=wKCrMJZKG3PxyJhv&q=85&s=e49c8069611743fdce42264016c4dc59" alt="Capture d’écran montrant une automatisation de seuil de variation des métriques de run" width="434" height="703" data-path="images/automations/run_metrics_change_threshold_automation.png" />
</Frame>

<div id="run-metrics-z-score-change">
  #### Variation du z-score des métriques de run
</div>

<Note>
  Disponible actuellement uniquement sur le [Cloud mutualisé de W\&B](/fr/platform/hosting#wb-multi-tenant-cloud) et le [Cloud dédié](/fr/platform/hosting#wb-dedicated-cloud).
</Note>

W\&B peut déclencher une automatisation lorsque le z-score (score standard) d’une métrique dépasse un seuil spécifié. Un z-score mesure de combien d’écarts types une valeur s’écarte de la moyenne de cette métrique sur une fenêtre configurable de runs dans le projet (30 runs par défaut).

Pour utiliser un z-score comme déclencheur d’événement, sélectionnez l’événement **Run metrics z-score threshold met**.

Les Automations basées sur le z-score permettent à votre équipe d’être alertée en cas de performances inhabituelles, sans avoir à vérifier des seuils absolus, qui peuvent varier à mesure que votre modèle ou votre processus d’entraînement évolue.

Vous pouvez créer une automatisation de z-score pour les métriques de run depuis l’onglet **Automations** du projet ou directement depuis un panneau de graphique linéaire dans un Workspace.

Pour créer une automatisation de z-score, configurez :

1. Le seuil cible de z-score, exprimé sous forme de valeur flottante positive (par exemple, 2.0).
2. La fenêtre de valeurs enregistrées qui sert à déterminer la moyenne (30 par défaut).
3. La comparaison à effectuer :
   * Au-dessus (se déclenche lorsque les performances sont inhabituellement élevées).
   * En dessous (se déclenche lorsque les performances sont inhabituellement faibles).
   * Au-dessus ou en dessous.

Par exemple, déclenchez une automatisation lorsque `accuracy` a un z-score supérieur à 2, ce qui signifie que le run obtient des performances bien supérieures à celles des autres runs du projet.

Les valeurs de z-score ont les significations suivantes :

* Un z-score de 0 signifie que la métrique est dans la moyenne.
* Un z-score de +2.0 signifie que la métrique se situe à 2 écarts types au-dessus de la moyenne.
* Un z-score de -2.0 signifie que la métrique se situe à 2 écarts types en dessous de la moyenne.
* Les valeurs au-delà de ±2 sont souvent considérées comme des valeurs aberrantes statistiquement significatives.

<div id="run-filters">
  #### Filtres des runs
</div>

Cette section décrit comment l'automatisation sélectionne les runs à évaluer.

Par défaut, n'importe quel run du projet déclenche l'automatisation lorsque l'événement se produit. Vous pouvez limiter les runs qui déclenchent une automatisation en configurant l'un des filtres suivants :

| Filtre                                        | Description                                                                          |
| --------------------------------------------- | ------------------------------------------------------------------------------------ |
| **Filtre sur les runs d'un seul utilisateur** | Inclure uniquement les runs créés par l'utilisateur spécifié.                        |
| **Filtre sur le nom du run**                  | Inclure uniquement les runs dont le nom correspond à l'expression régulière fournie. |

L'automatisation évalue chaque run comme suit :

* Chaque run est considéré individuellement et peut déclencher l'automatisation.
* Les valeurs de chaque run sont placées dans une fenêtre distincte et comparées séparément au seuil.
* Sur une période de 24 heures, une automatisation donnée ne peut se déclencher qu'une seule fois par run.

Pour plus de détails, voir [Créer des automatisations](/fr/models/automations/create-automations).

<div id="next-steps">
  ## Prochaines étapes
</div>

* [Créer une automatisation Slack](/fr/models/automations/create-automations/slack)
* [Créer une automatisation par webhook](/fr/models/automations/create-automations/webhook)