Constructor de workflows
Un workflow ejecuta sus pasos por sí solo: se inicia con un horario, desde una llamada API, con un mensaje WebSocket o a mano, y luego lee y escribe datos, aplica tus reglas, llama a otros servicios y devuelve un resultado. Lo construyes en un lienzo visual, a mano o pidiéndoselo a Vira.
Abrir el constructor
- Studio - haz clic en Start a workflow en la tarjeta Workflow.
- Un workflow que ya existe - ábrelo desde Studio. Los workflows que Qira y Vira crearon para una web app también están ahí.
- Import a flow - ¿ya tienes un workflow en JSON? Haz clic en Import a flow debajo de las tarjetas de Studio.
El lienzo
| Zona | Qué hace |
|---|---|
| Arriba a la izquierda | El nombre del workflow (haz clic en el lápiz para cambiarlo) |
| Lienzo | Los nodos y las líneas que los unen. Los datos fluyen desde el trigger de arriba a través de cada nodo, uno tras otro |
| Deshacer, rehacer y zoom | Arriba a la derecha del lienzo, con un botón que encaja todo el workflow en la pantalla |
| Minimapa | Abajo a la derecha. Arrástralo para moverte por workflows grandes |
| Active | Activa o desactiva el workflow. Un workflow inactivo no responde en su dirección de API ni se ejecuta según su horario |
| History | Versiones anteriores del workflow. Abre una para verla o volver a ella |
| Publish | Pone tus cambios en vivo |
| Ask Vira | Abajo a la izquierda. El chat donde Vira construye y cambia el workflow por ti |
Haz clic en cualquier nodo para abrir su configuración. Haz doble clic en el lienzo para añadir un nodo: el diálogo Add Node te permite buscar por nombre o recorrer los 32 nodos en cinco grupos: Flow Control, AI & Models, Data, Code & Transform e Integrations & I/O. Cada uno tiene su propia página en la parte de Workflows de esta documentación.
Triggers
Todo workflow empieza con un trigger:
| Trigger | Inicia el workflow cuando |
|---|---|
| Manual | Haces clic en Run en el editor |
| Schedule | Llega la hora que has fijado: cada mañana, cada viernes a las 17:00, cada 5 minutos |
| API | Algo llama a su dirección. Tú defines los métodos permitidos, la autenticación, el límite de peticiones, el tiempo de espera, la lista de IP permitidas y CORS |
| WebSocket | Llega un mensaje por una conexión WebSocket |
Los agentes empiezan con un Chat trigger. Consulta Constructor de agentes.
Construir con Vira
Haz clic en Ask Vira para abrir su panel. Describe lo que debe hacer el workflow como se lo explicarías a un compañero, y Vira elige los nodos, los configura y los conecta en el lienzo delante de ti.
Junto al cuadro de mensaje:
- @ - señala a Vira algo de tu espacio de trabajo, como una tabla
- Upload - adjunta un archivo, por ejemplo una petición de ejemplo o una especificación
- Micrófono - habla en lugar de escribir
- Papelera - borra la conversación
- Selector de modelo - el modelo de IA que usa Vira. Debajo ves los créditos que te quedan
El icono del reloj en la parte superior del panel abre tus conversaciones anteriores con Vira.
Cambiar un workflow
Vira trabaja sobre el workflow que tienes abierto, así que puedes pedirle cambios además de workflows nuevos:
- "Añade un paso que me envíe un email cuando el total del pedido supere los 500 €"
- "Si no se encuentra el cliente, devuelve un 404 en lugar de una lista vacía"
- "Envuelve la llamada de pago en un try/catch y registra el error en la tabla errors"
Cada cambio aparece en el lienzo, y History guarda la versión de antes.
Ejemplos de peticiones
Resumen diario
"Cada mañana a las 8, lee los nuevos registros de ayer en la tabla users y envíame una lista por email."
Trigger: Schedule. Después Query Data, Code para dar formato a la lista y Mail.
Endpoint para un formulario de contacto
"Un endpoint de API que recibe nombre, email y mensaje, comprueba que el email es válido, lo guarda en una tabla contacts y devuelve 201."
Trigger: API. Después Data Validator, Write Data y Simple Output.
Aviso de pedidos
"Cuando entre un pedido por la API, consulta el stock en la tabla products. Si es menor que 5, publica un mensaje en nuestro Slack."
Trigger: API. Después Query Data, Condition y un nodo MCP Server conectado a Slack. Consulta Apps.
Probar y seguir las ejecuciones
Ejecuta el workflow desde el editor para probarlo. Cada ejecución, desde el editor o en vivo, aparece en Activity con su estado, duración, entrada y salida, y sus registros de ejecución paso a paso.
Próximos pasos
- Cómo funcionan los workflows - nodos, conexiones y variables
- Triggers - todas las formas en que puede empezar un workflow
- Referencia de la API - llama a tus workflows desde tu propio código