Workflows
Flujos de trabajo
Encadene las herramientas de sus productos Etrebil y sus servicios externos: un desencadenante, pasos dibujados, scripts puros, cada ejecución seguida paso a paso.
Workflows encadena pasos entre los productos Etrebil y servicios externos. Un workflow parte de un desencadenante, a mano, ante un evento de un producto, a una hora fija o mediante una llamada webhook, y después ejecuta sus pasos en orden: herramienta de un producto Etrebil por su punto de acceso MCP, llamada HTTP, script, variables, condición de dos ramas, espera de hasta 30 días, parada en error. El editor dibuja el diagrama y escribe la misma definición JSON que la pestaña JSON. Los datos pasan de un paso a otro mediante plantillas, una simple búsqueda en las variables, nunca código evaluado.
El motor es duradero: cada ejecución conserva la versión con la que arrancó, escribe su posición tras cada paso y se reanuda después de un reinicio o de una larga espera. Los fallos pasajeros se reintentan con un retraso creciente, y cada paso ejecutado se puede revisar con su entrada, su salida y su duración. No hay bucles: una ejecución siempre termina, y una cadena de llamadas entre productos deja de relanzar workflows a partir del tercer eslabón.
Una conexión con un producto usa un token de agente creado en el portal Etrebil: el producto aplica los derechos de la persona que lo creó, Workflows no elude nada. Los secretos están cifrados y no se vuelven a leer nunca, y cada llamada pasa por una protección de red: https, hosts autorizados, ninguna dirección interna. Los scripts son funciones puras, sin red ni disco, limitadas en duración y memoria, y se ejecutan fuera del servidor en producción.
Workflows existe solo en web y todavía no está en línea. Solo algunos productos emiten ya eventos (Field Service, Planning, Manufacturing y el módulo Marketing de CRM), y el editor gráfico aún no se ha probado en un navegador.
Workflows está en preparación. Se incorporará al catálogo de la suscripción Etrebil cuando salga.
Todas las funciones de Workflows
64 funciones en 10 ámbitos
Workflows y editor gráfico
- Describe un workflow como una secuencia ordenada de pasos, con ramas si y si no, guardada en JSON y versionada en cada cambio de definición.
- Dibuja el diagrama de arriba abajo: el desencadenante en cabeza, los pasos enlazados, las dos ramas de una condición una junto a otra, el formulario del paso elegido a la derecha.
- Inserta un paso con un « + » entre dos tarjetas; sube, baja, duplica o elimina el paso elegido con botones.
- Comprueba la definición de forma continua y enumera los puntos que corregir citando el paso; un campo desconocido es un error, no un paso ignorado.
- Pestaña JSON: la misma definición en texto, editable, para revisar, copiar o pegar un workflow entero.
- Muestra, en el panel del paso, los datos disponibles en ese punto; se colocan en un campo con una plantilla entre dobles llaves, una simple búsqueda en las variables, nunca código evaluado.
- Crea un workflow vacío e inactivo; solo se activa si su definición es válida y las conexiones que cita existen.
- Cada ejecución conserva la versión con la que arrancó: modificar un workflow no afecta a las que están en marcha.
- Registro de cada workflow: creación, modificaciones con su número de versión, activación, desactivación, dirección de webhook renovada, con su autor.
Siete tipos de paso
- Herramienta de un producto: llama a una herramienta MCP de otro producto Etrebil mediante su conexión, con argumentos en JSON.
- Llamada HTTP: GET, POST, PUT, PATCH o DELETE hacia un servicio externo, con ruta, parámetros, cuerpo y cabeceras; el secreto de la conexión se añade solo.
- Script: JavaScript que recibe una entrada JSON y devuelve una salida JSON, sin red ni disco, un segundo como máximo; lo que escribe con console.log llena el registro del paso.
- Definir variables a partir de los datos de los pasos anteriores.
- Condición: dos ramas, entonces y si no, según una comparación (igual, distinto, mayor, menor, al menos, como máximo) o según que un dato contenga un texto, exista, esté vacío o no.
- Esperar de 1 minuto a 30 días: la ejecución se aparta y se reanuda sola, incluso tras un reinicio del servidor.
- Detenerse en error, con un mensaje que puede recoger los datos de la ejecución.
- Para cada paso de herramienta, HTTP o script: la variable que guarda el resultado, detenerse o continuar en caso de error, y de 1 a 5 intentos.
- Un workflow tiene 60 pasos como máximo, y sus condiciones se anidan en 4 niveles como máximo.
Desencadenantes
- A mano, desde la lista o la página del workflow, con una entrada JSON opcional; un workflow inactivo también se lanza a mano.
- Evento de un producto Etrebil: la aplicación emisora y un nombre exacto, o un prefijo terminado en asterisco; los datos del evento llegan al workflow.
- Recibe los eventos firmados por cada producto (HMAC-SHA256), comprobados en una ventana de 5 minutos; un evento recibido dos veces lanza una sola ejecución.
- Programado: cada N minutos, de 5 a 10.080, o cada día a una hora UTC; una sola instancia del servidor dispara el vencimiento, y un vencimiento perdido no se recupera.
- Webhook: una dirección secreta mostrada una sola vez, guardada solo como huella, renovable; la cabecera Idempotency-Key evita un doble lanzamiento.
- Corta los bucles entre productos: un evento nacido de una cadena de tres llamadas o más se registra pero ya no lanza nada.
Conexiones con productos y servicios
- Producto Etrebil: el punto de acceso MCP del producto y un token de agente creado en el portal Etrebil; el producto aplica los derechos de la persona que creó el token, Workflows no elude nada.
- Servicio HTTP: una dirección base, los hosts autorizados, la cabecera y el prefijo del secreto.
- Cifra los secretos con una clave guardada fuera de la base de datos; un secreto no se vuelve a leer nunca, ni en pantalla, ni mediante una herramienta MCP, ni en el registro de pasos.
- Botón Probar: enumera las herramientas del producto, o envía un GET al servicio y devuelve su estado.
- Protección de red en cada llamada: https en el puerto 443, hosts enumerados, ninguna dirección privada o interna, cada dirección comprobada al conectar, ninguna redirección seguida.
- Limita cada respuesta a 1 MB y cada llamada a 15 segundos, 30 para una herramienta.
- Se niega a renombrar o eliminar una conexión que un workflow todavía cita.
Ejecuciones y consumo
- Lista de ejecuciones filtrable por estado: en espera, en curso, correcta, con error, cancelada.
- Página de una ejecución: el diagrama de la versión lanzada, cada tarjeta marcada con su resultado, y después cada paso ejecutado con su entrada, su salida, su duración y su número de intento.
- Se actualiza sola mientras la ejecución está en curso o en espera.
- Reintenta los fallos pasajeros (red, errores 5xx, 429) tras 5 s, 20 s, 1 min, 3 min y luego 10 min; los demás errores detienen la ejecución, o se guardan en una variable si el paso lo pide.
- Cancela una ejecución en espera o en curso; relanza una ejecución terminada con la misma definición y la misma entrada.
- Reanuda una ejecución donde se detuvo si la instancia del servidor que la ejecutaba se para; dos instancias nunca ejecutan la misma ejecución a la vez.
- Cuenta por mes las ejecuciones, los pasos ejecutados, las llamadas a herramientas, las llamadas HTTP, el tiempo de script y los lanzamientos rechazados.
- Cuota mensual de ejecuciones, 10.000 por defecto, 0 para ningún límite; por encima, los lanzamientos se rechazan hasta el mes siguiente.
- Conserva las ejecuciones terminadas 30 días por defecto, ajustable de 1 a 365, y después las borra con su registro de pasos.
Roles y acceso
- Inicio de sesión único con su cuenta Etrebil; cada organización ve solo sus datos.
- Miembro: ve los workflows, lanza uno a mano y solo ve sus propias ejecuciones.
- Autor: escribe, modifica y activa los workflows, ve todas las ejecuciones, las cancela y las relanza.
- Administrador: conexiones y secretos, límites, roles, y eliminación de un workflow con su historial.
- Los miembros de la organización Etrebil aparecen en su primera visita; sus propietarios y administradores son administradores de oficio; un administrador suspende o restablece a un colaborador, y siempre queda uno activo.
- Sin licencia, solo consulta; los derechos los comprueba el servidor, no solo se ocultan en pantalla.
Agentes de IA mediante MCP
- Punto de acceso MCP con un token de agente Etrebil: enumerar los workflows, leer un workflow y su definición, enumerar y leer las ejecuciones, leer el consumo del mes.
- Lanzar un workflow y cancelar una ejecución son herramientas de escritura, reservadas a los tokens de lectura y escritura.
- El agente ve lo que ve la persona del token; las conexiones y sus secretos no se exponen.
Tutoriales
- Crear un workflow: nombre, creación, primer paso, diagrama, guardado.
- Enlazar otro producto: una conexión con un token de agente, y después el botón Probar.
En sus dispositivos
- Web: la aplicación completa, con inicio de sesión único, licencia y datos en el servidor.
- Las ejecuciones se realizan en el servidor, incluso con el navegador cerrado.
- Por ahora no hay aplicación de escritorio ni aplicación Android.
Conviene saber
- Sin bucle, sin « para cada » y sin fusión de ramas: una lista se trata con un script o con una herramienta que acepte lotes.
- Una escritura en otro producto cuya respuesta tarda puede rehacerse con un nuevo intento: para una escritura que no debe repetirse, ajuste el paso a un solo intento.
- En producción, los scripts se ejecutan en un ejecutor aparte, sin red; sin ese ejecutor, los pasos de script fallan.
- Solo algunos productos emiten ya eventos: Field Service, Planning, Manufacturing y el módulo Marketing de CRM. Los demás no desencadenan workflows; los que publican herramientas MCP se pilotan igualmente con un paso de herramienta.
- Cada producto que pilotar requiere un token de agente de lectura y escritura, creado en el portal Etrebil, y después una conexión: un paso manual por producto.
- En un paso de herramienta, el nombre de la herramienta se escribe a mano; el botón Probar de la página Conexiones da la lista.
- Un workflow tipo para DataVirt, revisar y después enviar un staging con salvaguardas, está escrito pero aún no se ofrece en pantalla.
- La clave de cifrado de los secretos debe guardarse aparte: perderla obliga a volver a introducir los secretos, y todavía no se puede cambiar.
- Sin exportación ni importación de la organización: una definición se copia desde la pestaña JSON.
- El editor aún no se ha probado en un navegador, ni el servicio se ha desplegado; los tokens de agente reales y la carga no se han puesto a prueba.