Errores y self-healing

Cuando un flow falla, tu agente no recibe un error genérico y silencioso — recibe un payload estructurado pensado para que pueda auto-corregirse: reintentar con otro enfoque o explicarte exactamente qué pasó.

Dos familias de error

Validación de input fallida (no reintentable): lo que le pediste al flow no encaja con lo que espera — trae la lista exacta de campos que no validaron, para que el agente ajuste los argumentos y lo intente de nuevo.

Fallo en un paso del flow (reintentable por defecto): algo salió mal durante la ejecución — un selector roto, la web caída, un timeout. El agente recibe el paso exacto donde falló, la URL, y normalmente un resumen del DOM en ese momento.

Forma del payload

{
  code, message, flow, profile?, step?, url?, retryable,
  suggestedAction?, domSnapshot?, validationErrors?
}

El resumen del DOM

Cuando el fallo ocurre en pleno navegador, el worker captura automáticamente un resumen de la página en ese instante — suficiente contexto para que el agente re-derive un selector roto sin que tú tengas que abrir el navegador a mano. El resumen tiene un tamaño acotado, así que siempre llega completo al agente sin desbordar el contexto.

Qué hace tu agente con esto

Con este contexto, el agente puede decidir por sí mismo: reintentar con un enfoque distinto, avisarte con el detalle exacto del fallo, o probar un flow alternativo — nunca se queda colgado en silencio sin explicación.