Docs · La doctrine · Section 09
Résilience d'exécution
Un système agentique compose des dépendances non déterministes et faillibles : modèle, sidecars, services externes. La résilience se conçoit par défaut, pas après l'incident.
Qualifier l'erreur avant de réagir
Chaque échec est d'abord qualifié, car la bonne réponse dépend du type d'erreur. On distingue les erreurs transitoires, les erreurs de validation, et les erreurs métier.
| Type d'erreur | Stratégie |
|---|---|
| Transitoire (réseau, délai, surcharge) | Réessai avec recul exponentiel borné. |
| Validation (sortie non conforme au contrat) | Réessai unique avec le diagnostic réinjecté dans le contexte. |
| Métier (ressource manquante, action impossible) | Délégation à une étape de diagnostic, ou remontée pour revue humaine. |
| Fournisseur de modèle indisponible | Bascule automatique vers un fournisseur de repli, derrière le même port. |
| Service non critique indisponible | Mode dégradé, l'application continue sans la fonction concernée. |
1 Fail-open pour le non critique, fail-closed pour le sensible
Une dépendance non critique qui tombe ne doit pas faire tomber le système : cache, observabilité, enrichissement passent en mode dégradé silencieux. À l'inverse, une action sensible (mutation, écriture, push externe) échoue de manière fermée et explicite plutôt que de s'exécuter dans le doute. La règle : dégrader la lecture, jamais l'action.
2 Détection de fonctionnalités et déploiement bimodal
Au démarrage, le système détecte les services réellement disponibles selon la configuration. Une dépendance absente désactive proprement la fonction associée, sans planter. Il en résulte un déploiement bimodal : un mode minimal qui tourne avec le strict nécessaire, et un mode complet quand toutes les dépendances sont présentes. L'interface signale ce qui est actif plutôt que d'échouer silencieusement.