Solución de problemas
Una ejecución fallida
Cómo encontrar una ejecución fallida en el Historial, leer su error y corregir las causas habituales.
Una ejecución falla cuando un paso no puede terminar: una herramienta da error, una app no está conectada, el espacio de trabajo no tiene créditos o el plan no permite un paso. Cada ejecución se guarda, así que puedes consultar lo que ocurrió a posteriori.
Síntomas#
- El agente se detiene a medias o da una respuesta vacía o genérica.
- Un flujo de trabajo termina antes de tiempo, o una fila de un lote muestra Failed.
- Una ejecución programada no hizo nada.
- Ves un aviso de error después de hacer clic en publicar, como “Validation failed. Please fix the errors highlighted on the components.”
Encontrar la ejecución en el Historial#
- Haz clic en History en la barra lateral.
- Activa el filtro Error messages para listar solo las sesiones que contenían un error. También puedes filtrar por Agent or workflow y por chatbot.
- Abre una sesión. Usa Plain o Verbose para cambiar la cantidad de detalle que ves.
- Lee los eventos hacia abajo. Están etiquetados como User message, Chatbot output, System message, Chat hook, Tool Call y Agent Query. Fíjate en los eventos de Tool Call para encontrar el que informa del error.
El panel de métricas situado encima de la tabla (Show metrics) representa Total errors a lo largo del tiempo. Tu plan limita hasta dónde se remonta el historial. Consulta planes y límites. En las ejecuciones por lotes, la tabla tiene las columnas Status y Error, y Re-run Failed o Retry row vuelven a ejecutar las filas fallidas.
Errores comunes y soluciones#
| Lo que ves | Causa | Solución |
|---|---|---|
| “Insufficient credits to perform this action. Please recharge your credits.” | El saldo está vacío | Sin créditos |
| “Workspace credit limit reached” | Un límite de gasto del espacio de trabajo | Auméntalo en Settings → Credits |
| “NAME is not configured. Please set up the integration first.” | El paso necesita una app que no está conectada | Conéctala en Integrations |
| “…is connected but is missing the permissions it requires. Please reconnect the integration and grant the additional permissions.” | A la conexión le falta un permiso | Vuelve a conectarla y acepta todos los permisos |
| “…requires re-authorization. The refresh token is expired or revoked. Please reconnect the integration.” | El inicio de sesión caducó o se revocó | Vuelve a conectar la cuenta |
| “Component NAME can only be used with … plan” | El paso no está en tu plan | Sustituye el paso o mejora tu plan |
| “Allowed limit of … reached. Please upgrade your plan.” | Alcanzaste un tope del plan mientras creabas algo | Elimina uno o mejora tu plan |
| “Validation failed. Please fix the errors highlighted on the components.” | A un paso le faltan ajustes obligatorios | Corrige los pasos resaltados y vuelve a publicar |
Ejecuciones programadas#
Si el espacio de trabajo se quedó sin créditos, el sistema desactiva la programación en lugar de reintentar indefinidamente. Ábrela y vuelve a activarla cuando tengas créditos. Consulta programaciones.
Solucionarlo#
- Encuentra la sesión fallida y copia el error exacto.
- Compáralo con la tabla, aplica la solución y vuelve a ejecutar la misma entrada.
- Si el error proviene de un servicio externo y no sabes por qué, prueba el paso por separado desde el lienzo. Consulta pruebas y registros de ejecución.
Consulta cuánto costó una ejecución
Revisa Transactions si no tienes claro cuánto gastó una ejecución. Cada cargo aparece listado con su tipo y su contexto. Consulta créditos.