Automatizaciones — Referencia Técnica
Esta página describe cómo funcionan las automatizaciones por debajo del constructor, en términos técnicos, para desarrolladores y usuarios con perfil técnico. Se centra en el comportamiento observable y en el modelo que siguen las automatizaciones, no en detalles de implementación.
Modelo de arquitectura
Una automatización es un grafo de pasos que arranca desde un disparador. Se mantienen dos aspectos separados:
- Diseño — construir la automatización (con el diseñador de IA o el editor manual). Esto produce una definición en borrador.
- Ejecución — correr la automatización de verdad. Esto ocurre como un trabajo aparte (ver más abajo).
Cada automatización tiene una definición (sus pasos y su disparador), y cada vez que corre produce un registro de ejecución.
Modelo de pasos
Una definición es un conjunto ordenado de nodos. Cada nodo tiene un índice, el o los nodos a los que sigue, un tipo y campos específicos del tipo.
| Tipo de nodo | Qué hace | Campos clave |
|---|---|---|
| Disparador (autogenerado, índice 0) | Marca cómo arranca la automatización | tipo de disparador + su configuración |
| Paso de agente | Ejecuta uno de tus agentes con una instrucción, opcionalmente escribiendo la salida en un archivo | el agente, una instrucción de entrada, un archivo de salida, notas de éxito/fallo |
| Paso de router | Bifurca el flujo según una condición | un conjunto de rutas, cada una con una condición y el siguiente paso al que ir |
- La salida de un paso puede escribirse en un archivo que pasos posteriores leen, de modo que los datos fluyen por la cadena.
- Consolidación de pasos: cuando el mismo agente realiza varias acciones consecutivas, se combinan en un solo paso con una instrucción detallada, en lugar de muchos pasos pequeños. Se usan pasos separados para agentes distintos, bifurcaciones o trabajo en paralelo.
Disparadores
| Disparador | Inicia la automatización cuando… | Notas |
|---|---|---|
| Programado | Se alcanza una hora/recurrencia | Se define como una expresión cron con una zona horaria |
| Webhook | Un servicio externo envía una solicitud HTTP | Protegido por una clave secreta que debe acompañar cada solicitud |
| Manual | Lo ejecutas a demanda | — |
Por qué el diseño y la ejecución están separados
El diseñador conversacional corre dentro de un límite de tiempo, y una automatización completa puede tardar más que eso (puede llamar a varios agentes, cada uno haciendo trabajo real). Por eso el diseñador nunca ejecuta la automatización él mismo — produce un borrador verificado, y la ejecución corre como un trabajo aparte que no está atado al límite del diseñador.
Por eso el flujo es diseñar → probar → activar: pruebas el borrador terminado (una ejecución real que puedes mirar paso a paso) y luego lo activas para que corra con su disparador.
Modelo de ejecución
- Los pasos corren en orden; un paso de router envía el flujo por una de sus ramas según el resultado.
- Cada ejecución se guarda como un registro de ejecución que almacena, por paso: el estado, un resumen del resultado, los archivos de salida y qué herramientas se usaron.
- Una ejecución pasa por estos estados:
- Las ejecuciones de prueba y las de producción se registran de la misma forma; una ejecución de prueba te permite verificar la automatización antes de activarla.
- Mientras una ejecución está en curso, su estado se consulta periódicamente para que la interfaz muestre el progreso paso a paso en vivo.
Modos de ejecución
Cada automatización corre en uno de dos modos:
| Modo | Compromiso |
|---|---|
| Agile | Más rápido y eficiente en costo — bueno para la mayoría de las automatizaciones |
| Intensive | Análisis más exhaustivo por paso — para trabajo complejo |
Límites y garantías
- Los pasos se ejecutan de forma secuencial; los routers son el único mecanismo de bifurcación.
- Cada ejecución queda registrada con resultados por paso que puedes revisar después.
- Cada conversación de diseño es una sesión aislada; una sesión puede diseñar varias automatizaciones.
- Los disparadores de webhook requieren una clave secreta — las solicitudes sin ella se rechazan.
- El uso se mide como créditos por ejecución.
Qué sigue
- Elegir un disparador — programado, webhook o manual
- Pasos de agente y routers — configura qué hace cada paso
- Pruebas y ejecuciones — prueba, activa y monitorea las ejecuciones