logo
AgentLed

Auto-Fix

Recuperación automática de errores para pasos fallidos del flujo de trabajo. Cuando falla un paso, AgentLed analiza el error, aplica una solución y vuelve a intentarlo, lo que reduce la intervención manual.

Cómo funciona Auto-Fix

Cuando falla un paso, AgentLed ejecuta una recuperación two-phase antes de marcar la ejecución como fallida.

Fase 1Reintento automático — Determinista re-execution del mismo paso con la misma configuración. Hasta 3 intentos con retroceso exponencial. Maneja errores transitorios: tiempos de espera de red, interrupciones temporales de API, pausas de rate-limit.

Fase 2Auto-Fix — diagnóstico AI. El sistema lee el error, inspecciona la configuración del paso y los datos ascendentes y propone un parche. Dependiendo de tu autonomyLevel, aplica el parche automáticamente o espera su aprobación.

Fase 3Falla — Ambas fases agotadas o inhabilitadas. El paso está marcado como fallido. Usar retry_execution re-run manualmente después de solucionar la causa raíz.

Configuración

{
  // 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"
  }
}

autonomíaNivel: "sugerir" - AI propone una solución. La ejecución se detiene con un estado "pendiente". Revisas el diagnóstico y lo apruebas o lo rechazas.

Nivel de autonomía: "auto-fix" — AI aplica el parche inmediatamente y re-executes. El contador de reintentos se reinicia para que el presupuesto de reintentos completo se aplique a la configuración corregida.

Lo que Auto-Fix puede y no puede parchear

Auto-reparableRequiere revisión humana
Respuestas API mal formadasCuota API agotada
Errores de validación de entradaFallos de autenticación (clave API incorrecta)
Faltan campos opcionalesDesajustes en la lógica empresarial
El formato de mensaje/salida no coincideProblemas de calidad de datos ascendentes

Auto-Fix no puede modificar campos estructurales: paso id, type, enrutamiento (next), configuración de bucle o la configuración Auto-Fix en sí. Solo parchea entradas, mensajes y asignaciones de salida.

Pista de auditoría

Cada intento de Auto-Fix se registra en la línea de tiempo de ejecución. Puedes ver:

  • •¿Qué número de intento desencadenó el diagnóstico AI?
  • •Análisis root-cause y puntuación de confianza del AI (0–1)
  • •La diferencia de configuración exacta que se aplicó o propuso
  • •Si el paso parcheado tuvo éxito o volvió a fallar

Auto-Fix frente a reintento manual

Usar retry_execution cuando desea re-run una ejecución fallida después de solucionar la causa raíz usted mismo (se actualizó una clave API, se corrigieron los datos de entrada, se ajustó un mensaje). El reintento manual siempre se ejecuta con la configuración guardada actual y le brinda control total. Auto-Fix es para la recuperación hands-off de errores transitorios o diagnosticables AI.

Próximos pasos