Editor y guardado

El editor combina el encabezado del workflow, el canvas de nodos, el panel de configuración y los controles de prueba. Los cambios visibles en el canvas no deben considerarse persistidos hasta que el estado de guardado lo confirme.

Encabezado del editor

En la parte superior encontrás:

• Abrir otro workflow: vuelve al listado de workflows guardados.
• Título: identifica el flujo abierto.
• Estado: permite trabajar como Borrador, activar o pausar según la configuración válida.
• selector Editar / Probar: alterna entre construcción y chat de prueba.
• botón con varita: abre Modificar workflow con IA.
• botón Guardar: persiste manualmente el workflow y permite controlar el guardado automático.
• menú de tres puntos: agrupa monitoreo, archivo y acciones sobre el canvas.

Guardado manual y automático

Un clic normal en Guardar intenta persistir el título, estado, nodos, conexiones y configuración del workflow.

El borde y el estado visual del botón indican si existen cambios, si se están guardando, si ya quedaron guardados o si ocurrió un error. No cierres el editor mientras el guardado esté en curso.

Para activar o desactivar el guardado automático:

1. Hacé clic derecho sobre Guardar; o
2. enfocá el botón y presioná Shift+F10.

El guardado automático actualiza el mismo workflow. No crea nuevos workflows. Si un cambio preparado por IA se aplica al canvas, primero revisalo y luego esperá la confirmación del guardado automático o hacé clic en Guardar.

Precaución

Un cambio visible y un cambio guardado no son lo mismo. Ante un error de red, el canvas puede conservar la edición local pero la versión persistida seguirá siendo la anterior.

Menú de tres puntos

El menú secundario organiza las acciones por finalidad:

Monitoreo

• Ejecuciones: abre el historial y el detalle técnico de ejecuciones.
• Validar workflow: crea y ejecuta escenarios repetibles con resultados esperados.

Archivo

• Descargar workflow: guarda un archivo con el grafo y su configuración.
• Importar desde archivo: carga un archivo compatible sobre el editor actual para revisarlo y guardarlo.

Acción sobre el canvas

• Limpiar canvas: reemplaza los nodos y conexiones por un canvas inicial. Requiere confirmación y debe tratarse como una acción destructiva sobre el workflow abierto.

Agregar y configurar nodos

Presioná el botón + del canvas para abrir Agregar paso. Primero elegí una categoría y luego un nodo. El buscador del selector permite encontrarlo por nombre o función.

Al seleccionar un nodo se abre su panel de configuración. Los campos dependen del tipo: prompt, mensaje, reglas, datos requeridos, request, credenciales, acción de Nexus, manejo de errores o modo de continuidad.

Al finalizar este paso

Los nodos ejecutables pueden incluir una sección colapsada llamada Al finalizar este paso. Son acciones opcionales que se aplican después de que el nodo terminó correctamente su trabajo.

• Próximo turno empieza en: aparece cuando el nodo no tiene una salida normal conectada. Permite responder en este paso y hacer que el próximo mensaje del usuario continúe desde otro nodo del workflow.
• Limpiar memoria: borra valores guardados en facts para volver a pedirlos o evitar reutilizar datos de una búsqueda anterior.

Usá Próximo turno empieza en para fallbacks conversacionales como “no hay disponibilidad, elegí otro profesional o fecha”. No reemplaza una conexión del canvas: si el nodo tiene una salida conectada, el workflow sigue esa conexión.

En Limpiar memoria, seleccioná las claves desde el selector de variables cuando estén disponibles. Una clave borrada deja de tener valor capturado, pero si está definida por un nodo Pedir datos o Variables puede seguir apareciendo como variable disponible para volver a completarla.

Mover y conectar

• Arrastrá el cuerpo del nodo para moverlo.
• Iniciá una conexión desde un punto de salida y terminala en la entrada del nodo destino.
• Las decisiones muestran una salida por rama con su etiqueta.
• Seleccioná una conexión para eliminarla.
• Si al borrar una conexión quedan nodos inalcanzables, revisá la advertencia antes de confirmar.
• Inicio solo tiene salida y un nodo secuencial normal recibe una entrada.
• Un sub-agente se relaciona como herramienta de un nodo de IA, no como paso normal desde Inicio.

Conectá siempre los caminos que puedan ocurrir: default, error, dato faltante, rechazo, vencimiento u origen desconocido.

Variables y blackboard

Los campos compatibles permiten abrir Insertar variable. El selector muestra valores globales del workflow, resultados de nodos y facts individuales como {{facts.email}}, además del objeto completo {{facts}} cuando necesitás pasar toda la memoria.

Los nodos Code y Google Sheets permiten usar Try para registrar una muestra de su salida. Después de una prueba exitosa, el selector también muestra las propiedades anidadas descubiertas en esa respuesta. La muestra sirve para configurar el workflow; durante una ejecución se usa siempre el resultado real del nodo.

Las variables se muestran agrupadas por origen y ordenadas según su aparición/captura dentro del workflow. Los campos declarados por Pedir datos también aparecen aunque todavía no tengan valor en una ejecución: eso indica dónde se guardará el dato cuando sea recolectado.

El Blackboard del modo de prueba muestra los registros acumulados por el runtime. Si un fact fue limpiado, no debe interpretarse como dato capturado; la definición puede seguir disponible en el editor para usarla en placeholders o para recolectarla nuevamente.

Consejo

Preferí insertar {{facts.nombre}} antes que {{facts}} cuando un nodo necesita un dato puntual. Es más fácil de auditar y evita enviar memoria innecesaria a integraciones o mensajes.

Orden visual recomendado

Un workflow legible también es más fácil de mantener:

• mantené el avance principal por niveles consistentes;
• ubicá ramas paralelas en el mismo nivel y separadas horizontalmente aproximadamente por el ancho de dos nodos;
• evitá cruces largos y superposiciones;
• colocá Variables inmediatamente encima de Inicio;
• agregá junto a Variables una nota breve que explique cada clave;
• colocá cada Mock al lado del HTTP Request que lo consume;
• colocá cada Nota al lado del nodo específico que explica;
• no uses notas como documentación general aislada por el canvas;
• mantené cerca las confirmaciones y los fallbacks de la rama a la que pertenecen.

Las notas adaptan su alto al texto. Aun así, deben ser cortas y accionables: “Conectá la credencial del CRM”, “Revisá los campos requeridos” o “Personalizá el mensaje de fallback”.

Controles de vista

La barra inferior del canvas incluye el porcentaje de zoom. Al desplegarlo aparecen:

• Alejar;
• Acercar;
• Centrar vista;
• Pantalla completa.

Usá Centrar vista después de importar un workflow o cuando los nodos queden fuera del área visible.

Estados

• Borrador: editable y apropiado para construcción y pruebas.
• Activo: disponible para conversaciones reales.
• Pausado: se conserva pero no se ejecuta.

Antes de activar, guardá, validá todas las conexiones y completá credenciales, destinatarios de intervención humana y configuraciones marcadas por notas.