# Audit Event

Audit Event écrit un événement métier structuré et persistant dans le journal d’audit. Utilisez-le pour conserver la preuve d’une action importante, comme la qualification d’un prospect, la validation d’une commande, une décision de paiement, l’export d’un document ou une approbation humaine.

## Configuration

### Nom de l’événement

Saisissez un nom métier stable décrivant ce qui s’est produit :

```text
lead.qualified
order.approved
document.exported
```

### Cible métier

La cible identifie l’objet métier concerné par l’événement.

- **Automatique (recommandé) :** aucune valeur technique n’est demandée. Le workflow et le nœud sont automatiquement associés à l’enregistrement d’audit.
- **Cible métier personnalisée :** utilisez un identifiant lisible comme `client:{input.email}`, `commande:{item.id}` ou `document:{state.document_id}`.

La valeur interne `workflow:{_workflow_ref}:node:{_active_node_id}` est un identifiant système. L’utilisateur n’a pas besoin de la saisir ni de la comprendre.

### Détails de l’événement

Ajoutez les informations métier à conserver sous forme d’objet JSON :

```json
{
  "email": "{state.customer.email}",
  "score": "{state.customer.score}",
  "decision": "qualified"
}
```

Le payload doit être un objet JSON et ne peut pas dépasser 64 Ko après son rendu.

## Sécurité et fiabilité

- Les clés et valeurs sensibles comme les tokens, mots de passe, clés API, en-têtes d’autorisation, cookies et signatures sont automatiquement masquées.
- Rejouer le même nœud pendant le même run ne crée pas une deuxième ligne d’audit.
- Le workflow, le run, le nœud, l’utilisateur, la surface d’exécution et la date sont enregistrés automatiquement.

## Sortie d’exécution

```json
{
  "audit_id": 123,
  "event_name": "lead.qualified",
  "action": "lead.qualified",
  "target": "client:awa@example.com"
}
```

Le résultat est disponible dans `last_output_parsed` et `{outputs.<node_id>.parsed}`.

## Exemple de workflow

La carte ci-dessous charge un client de démonstration avec Set State, puis enregistre un événement d’audit `lead.qualified`.

---

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