Auto-Fix

Récupération automatique des erreurs pour les étapes de flux de travail ayant échoué. Lorsqu'une étape échoue, AgentLed analyse l'erreur, applique un correctif et réessaye, réduisant ainsi les interventions manuelles.


Comment fonctionne Auto-Fix

Lorsqu'une étape échoue, AgentLed exécute une récupération two-phase avant de marquer l'exécution comme ayant échoué.

Phase 1Nouvelle tentative automatique — Réexécution déterministe de la même étape avec la même configuration. Jusqu'à 3 tentatives avec intervalle exponentiel. Gère les erreurs passagères: délais d'attente du réseau, pannes temporaires API, pauses rate-limit.

Phase 2Auto-Fix — diagnostic AI. Le système lit l'erreur, inspecte la configuration de l'étape et les données en amont, et propose un correctif. En fonction de votre autonomyLevel, soit il applique le correctif automatiquement, soit il attend votre approbation.

Phase 3Échec — Les deux phases sont épuisées ou désactivées. L'étape est marquée comme ayant échoué. Utiliser retry_execution manuellement re-run après avoir corrigé la cause première.


Configuration

{
  // Phase 1: deterministic retry (default: disabled)
  autoRetry: {
    enabled: true,
    maxAttempts: 3    // 1–3
  },

  // Phase 2: AI diagnosis and patching
  autoFix: {
    enabled: true,
    maxAttempts: 2,   // 1–5
    autonomyLevel: "suggest"   // "suggest" | "auto-fix"
  }
}

niveau d'autonomie: "suggérer" — AI propose un correctif. L'exécution s'interrompt avec un statut « en attente ». Vous examinez le diagnostic et approuvez ou rejetez.

Niveau d'autonomie: "auto-fix" — AI applique le patch immédiatement et re-executes. Le compteur de nouvelles tentatives se réinitialise afin que le budget total des nouvelles tentatives s'applique à la configuration corrigée.


Ce que Auto-Fix peut et ne peut pas corriger

Réparable automatiquementNécessite un examen humain
Réponses API mal forméesQuota API épuisé
Erreurs de validation d'entréeÉchecs d'authentification (mauvaise clé API)
Champs facultatifs manquantsInadéquations de logique métier
Incompatibilités entre les formats d'invite et de sortieProblèmes de qualité des données en amont

Auto-Fix ne peut pas modifier les champs structurels: étape id, type, le routage (next), la configuration de la boucle ou la configuration Auto-Fix elle-même. Il corrige uniquement les entrées, les invites et les mappages de sortie.


Piste d'audit

Chaque tentative Auto-Fix est enregistrée dans la chronologie d'exécution. Vous pouvez voir:

  • Quel numéro de tentative a déclenché le diagnostic AI
  • Analyse root-cause et score de confiance du AI (0-1)
  • La différence de configuration exacte qui a été appliquée ou proposée
  • Si l'étape corrigée a réussi ou échoué à nouveau

Auto-Fix et nouvelle tentative manuelle

Utiliser retry_execution lorsque vous souhaitez re-run une exécution échouée après avoir corrigé vous-même la cause première (mise à jour d'une clé API, correction des données d'entrée, ajustement d'une invite). La nouvelle tentative manuelle s'exécute toujours avec la configuration actuellement enregistrée et vous donne un contrôle total. Auto-Fix est destiné à la récupération hands-off des erreurs transitoires ou diagnosticables par AI.


Prochaines étapes

  • Human-in-the-Loop — Portes d'approbation pour les étapes high-stakes
  • Validation — Détectez les problèmes de qualité des données avant qu'ils ne provoquent des pannes
  • Traitement par lots — Politiques de nouvelle tentative par élément pour les tâches parallèles importantes