Una receta maneja una tarea. Un flujo de trabajo encadena tareas. Pero algunas automatizaciones son más grandes que un solo flujo de trabajo — se ejecutan durante minutos u horas, coordinan múltiples flujos de trabajo paralelos y necesitan sobrevivir a las fallas con gracia.
Los playbooks son la respuesta de JieGou a esto. Ejecutan flujos de trabajo como agentes asíncronos en segundo plano con checkpointing incorporado, recuperación ante crashes y control de concurrencia.
Qué hace diferentes a los playbooks
La ejecución estándar de flujos de trabajo se ejecuta de forma síncrona. El cliente espera el resultado. Esto funciona bien para flujos de trabajo que se completan en segundos a pocos minutos. Pero para una automatización de 30 pasos que procesa un lote de documentos, enriquece datos de tres fuentes externas, espera una aprobación y genera un informe final — la ejecución síncrona alcanza límites prácticos.
La ejecución de playbooks es asíncrona. Usted inicia el playbook y obtiene un ID de ejecución inmediatamente. La ejecución continúa en segundo plano. Puede verificar el progreso en cualquier momento, y el sistema le notifica cuando se completa.
Checkpointing a nivel de nodo
La diferencia arquitectónica clave es el checkpointing. Después de que cada paso se completa exitosamente, el playbook persiste su estado — todas las salidas de pasos, la posición actual en el grafo de ejecución y cualquier contexto de bucle o rama.
Si un playbook se cae a mitad de ejecución — un reinicio del servidor, una falla transitoria de infraestructura, un timeout en un servicio externo — no reinicia desde cero. Se reanuda desde el último checkpoint, retomando donde lo dejó. Los pasos que ya se completaron no se re-ejecutan.
Esto importa para automatizaciones de larga duración donde re-ejecutar pasos completados desperdicia tiempo y dinero (las llamadas LLM no son gratuitas) y puede causar efectos secundarios (no quiere enviar el mismo correo dos veces).
Control de concurrencia
Los playbooks manejan ramas paralelas de forma segura. Cuando un playbook llega a un paso paralelo, cada rama se ejecuta independientemente con gestión de concurrencia adecuada. Los bloqueos de recursos previenen operaciones conflictivas, y el playbook rastrea qué ramas han completado para asegurar que el paso paralelo solo termine cuando todas las ramas estén completas.
Streaming de progreso
Mientras un playbook se ejecuta en segundo plano, la UI transmite actualizaciones de progreso en tiempo real. Puede ver:
- Qué paso se está ejecutando actualmente
- Qué pasos se han completado (con previsualizaciones de salida)
- Qué pasos están pendientes
- Tiempo restante estimado basado en datos históricos de ejecución
Esta es la misma vista de progreso usada para flujos de trabajo síncronos, pero se actualiza asincrónicamente vía polling en lugar de una conexión de larga duración.
Reintentar y reanudar
Cuando un paso de playbook falla, el sistema aplica la estrategia estándar de reintento (backoff exponencial, máximo de intentos configurable). Si los reintentos se agotan y el paso falla permanentemente, el playbook se pausa con un estado de error.
Desde el estado pausado, tiene tres opciones:
- Reintentar el paso fallido (después de arreglar el problema subyacente, como una clave API revocada)
- Omitir el paso fallido y continuar desde el siguiente
- Cancelar el playbook completamente
La capacidad de reanudar después de una falla — en lugar de reiniciar desde el principio — es lo que hace a los playbooks prácticos para automatizaciones complejas de múltiples pasos.
Cuándo usar playbooks vs. flujos de trabajo
Use flujos de trabajo estándar cuando:
- La ejecución se completa en menos de 5 minutos
- Necesita el resultado inmediatamente (respuesta síncrona)
- El flujo de trabajo es activado por una acción del usuario y están esperando la salida
Use playbooks cuando:
- La ejecución toma más de unos minutos
- La automatización involucra muchos pasos o grandes volúmenes de datos
- La recuperación ante crashes importa (el costo de reiniciar es alto)
- La automatización se ejecuta en segundo plano (programada, activada o tipo disparar-y-olvidar)
Compartir y analíticas
Las ejecuciones de playbooks soportan el mismo modelo de compartir que las ejecuciones de flujos de trabajo — visibilidad privada, departamental, de cuenta o de grupo. Los miembros del equipo pueden ver el progreso, inspeccionar salidas de pasos y revisar ejecuciones completadas basándose en su nivel de acceso.
Las analíticas de playbooks muestran frecuencia de ejecución, tasas de éxito, duración promedio y costo por ejecución. Estas le ayudan a identificar qué playbooks son más valiosos y cuáles necesitan optimización.
Los playbooks están disponibles en planes Enterprise. Conozca más sobre playbooks o contáctenos para acceso Enterprise.