# Déclencheur d'erreur

Le déclencheur d'erreur exécute un workflow lorsqu'un autre workflow termine en état **failed** ou **dead**. Utilisez-le pour les incidents, les automatisations de secours, le nettoyage et les escalades.

## Ajouter le déclencheur

1. Glissez un nœud **Error Trigger** depuis la palette Déclencheurs.
2. Sélectionnez éventuellement un **workflow source**. Laissez vide pour écouter les échecs des workflows du même workspace.
3. Choisissez les statuts qui doivent déclencher le workflow : **failed**, **dead**, ou les deux.
4. Activez le déclencheur et sauvegardez le workflow.

Le déclencheur est événementiel. Il ne poll pas et n'expose pas d'URL publique.

## Ce que reçoit le workflow

Chaque run reçoit le run en erreur sous forme structurée :

```json
{
  "trigger_kind": "error_trigger",
  "event": {
    "workflow_id": "wf_123",
    "workflow_name": "Lead enrichment",
    "run_id": "run_456",
    "status": "failed",
    "error": "HTTP request failed",
    "failed_node_id": "http_1"
  },
  "input": { ... },
  "last_output": { ... },
  "_error_trigger": {
    "source_attempt": 1,
    "depth": 1
  }
}
```

Utilisez `{event.workflow_name}`, `{event.run_id}`, `{event.error}` ou `{last_output}` dans les nœuds suivants.

## Garde-fous

- Un workflow ne peut pas se déclencher lui-même via Error Trigger.
- Les runs déclenchés par Error Trigger ne déclenchent pas d'autres workflows Error Trigger, ce qui évite les boucles.
- Les déclenchements restent dans le même workspace ou le même scope propriétaire.
- Le même run source/statut/tentative est dédoublonné pour éviter les incidents dupliqués.

## Patterns courants

- Notifier l'équipe ops lorsqu'un workflow de production échoue.
- Créer un ticket avec l'id du run et le texte de l'erreur.
- Lancer un workflow de nettoyage après un timeout passé en **dead**.
- Déclencher un workflow de secours lorsqu'une intégration source échoue.

## Exemple workflow

Utilisez la carte workflow ci-dessous pour créer un workflow Error Trigger qui enregistre le nom du workflow échoué, l'id du run et le message d'erreur.

---

*Source: https://agentbuilder.systalink.sn/docs/trigger-error — human documentation.*
*Other language: [/docs-md/en/trigger-error.md](/docs-md/en/trigger-error.md).*
*Machine-readable index: [/llms.txt](/llms.txt).*