Editor visual

El editor de flujo de trabajo es la página en la que pasa más tiempo todos los días. Este artículo habla de cada área y cada botón, para que sepas dónde hacer clic si quieres hacer X.

Diseño general

El editor tiene un diseño típico de tres columnas:

• Barra de herramientas superior — Operaciones principales como guardar/verificar/ejecutar/importar/exportar/historial de versiones, etc.
• lienzo de la columna izquierda — Visualización DAG, con nodos, conexiones, zoom y minimapas de arrastrar y soltar
• Columna derecha YAML — Monaco Editor edita directamente fuentes YAML con resaltado de sintaxis/completado automático/indicaciones de error
• barra de estado inferior — Guardar estado, editar titular de bloqueo, posición del cursor del colaborador, hora de la última verificación
• Cajón derecho — Asistente de IA, panel de puntos de interrupción, instantánea variable (abierta bajo demanda)

Canvas vs YAML: sincronización bidireccional a nivel de bytes

Ésta es la diferencia más obvia entre Braidrun y otras marcas. Un gráfico DAG y un YAML son equivalentes a nivel de bytes:

• Cambia una línea en YAML y el nodo correspondiente en el lienzo se actualiza instantáneamente;
• Arrastra una línea de conexión en el lienzo y el campo depend_on correspondiente en YAML aparece simultáneamente;
• Los comentarios/líneas en blanco/orden de campos no se pierden: el YAML exportado es exactamente el mismo que se ve en el editor.

Barra de herramientas superior

Guardar

De forma predeterminada, se guardará automáticamente una vez que dejes de escribir durante 5 segundos; también se puede activar manualmente presionando Ctrl / Cmd + S. Cada guardado creará un instantánea de la versión(No es una simple anulación).

Deshacer / rehacer

La barra de herramientas tiene dos botones de deshacer / rehacer, con los atajos Ctrl / Cmd + Z y Ctrl / Cmd + Shift + Z. Se trata de una pila de historial a nivel de editor: cada paso de arrastre en el lienzo, de modificación del YAML y de construcción incremental por el asistente de IA entra en el mismo historial — «la IA metió la pata en un paso» también se puede revertir con un clic. Las pulsaciones continuas se combinan en un solo registro, y las marcas de tiempo del reescrito por autoguardado no generan historial extra; se conservan como máximo las últimas 50 instantáneas, y al cambiar a otro workflow el historial se reinicia.

Verificar

Llame al analizador de plataforma para realizar un viaje de ida y vuelta:

1. YAML → Objeto WorkflowDefinition (capa de sintaxis)
2. WorkflowDefinition → Verificación semántica (si se puede analizar la referencia de la variable, si se puede encontrar el valor preestablecido, si hay bucles en las dependencias)
3. WorkflowDefinition → YAML ida y vuelta (se informará un error si hay alguna desviación)

Los errores se marcan con un subrayado ondulado rojo a nivel de línea del YAML; al pulsar, salta a la línea concreta. El resultado de la validación en profundidad también se combina con el panel de problemas de diagnóstico que se describe más abajo. Corríjalo del todo antes de guardar y publicar.

Ejecutar

Al hacer clic en este botón aparecerá un cuadro de diálogo que le permitirá:

• Complete las variables del flujo de trabajo (los valores predeterminados se completarán previamente)
• Verificar / Cancelar dry-run (marcado de forma predeterminada; muy recomendable para la primera ejecución)
• Seleccionar fuente de activación (manual/simulación de programación)

Después de hacer clic en "Iniciar ejecución", el editor abrirá automáticamente un cajón a la derecha para mostrar el flujo de eventos en tiempo real y, al mismo tiempo, abrirá los detalles de ejecución en la pestaña actual.

Importar/Exportar

• Importar YAML: carga YAML desde un archivo/cartón/una URL sobrescribiendo el contenido actual.
• Exportar YAML: descargue el YAML actual a un archivo local. Adecuado para el control de versiones de git.
• Importe formatos externos como Dify/Langflow: se requiere paquete Pro o superior, la plataforma convierte automáticamente a Braidrun YAML.

Historial de versiones

Cada guardado crea una instantánea y conserva 100 versiones de forma predeterminada (sin límite para Enterprise). Puedes:

• Enumere todas las instantáneas (incluido el tiempo, el ahorro y el número de líneas modificadas)
• Comparar con la versión actual diff
• Revertir a cualquier versión histórica (revertir creará una nueva instantánea y en realidad no sobrescribirá el historial)

Promote to module / Demote from module

Seleccione varios pasos consecutivos en el lienzo y haga clic en "Promocionar a módulo" para extraer estos pasos en un módulo sub_workflow independiente, y la posición original se convierte en una llamada de módulo. Degradar la operación inversa. Ver detalles Modularización y reutilización.

Operaciones de lienzo de la columna izquierda

Agregar nuevo nodo

• El botón "+" en la esquina inferior izquierda abre el selector de tipo de paso y selecciona un modo principal.
• También se puede agregar arrastrando el "fragmento de plantilla de pasos" desde la columna derecha al lienzo.

Conectar

Arrastre el punto final de salida de un nodo al punto final de entrada de otro nodo para agregar automáticamente la relación depend_on en YAML. La plataforma no te permite dibujar bordes que formen bucles; rebotarás y te quemarás si intentas dibujar un bucle.

Menú contextual del nodo

• Editar: abra el fragmento YAML de este paso para realizar una edición parcial.
• Copiar: clonar una copia del paso actual (la identificación tiene el sufijo automáticamente).
• Eliminar: se mostrará una advertencia si hay referencias posteriores al eliminar.
• Establecer como inicio/fin: marca la entrada/salida explícita del flujo de trabajo (obligatorio solo para state_machine).

Zoom y minimapa

Hay un minimapa en la esquina inferior derecha, que le permite saltar rápidamente cuando un flujo de trabajo complejo excede el tamaño del lienzo. Ctrl / Cmd + rueda de desplazamiento para hacer zoom; Espacio + arrastrar para desplazarse.

Columna derecha YAML

Autocompletar

Based on JSON Schema, common field names, preset names, and existing step ids can be completed. Ctrl / Cmd + Despertar de la Fuerza Espacial.

Fold / Unfold

Haga clic en la flecha junto al número de línea a la izquierda para contraer todo el paso. Tecla de acceso directo Ctrl / Cmd + Shift + [ / ].

Buscar y reemplazar

Ctrl / Cmd + F Buscar, Ctrl / Cmd + H Reemplazar. Regularidad de apoyo. Solo afectará al flujo de trabajo actual, no afectará a otros flujos de trabajo.

Panel de diagnóstico y problemas

El editor tiene dos capas de lint que comparten el mismo conjunto de códigos de regla:

• Diagnóstico instantáneo en el cliente — Se recalcula localmente de inmediato tras cada edición (reglas estructurales como ciclos de dependencia, referencias colgantes o sugerencias de step id con nombres parecidos), y alimenta con latencia cero el panel de problemas, las insignias de nodo y la insignia de la barra de herramientas.
• Validación en profundidad en el servidor — Al pulsar «Validar» en la barra de herramientas se llama a POST /api/workflows/lint, que devuelve todos los problemas de una vez (la validación de guardado se detiene en el primer error; el lint no), y añade reglas que requieren datos del servidor, como los presets de agent y los contratos de módulo.

La insignia de la barra de herramientas muestra en tiempo real el número de errores / advertencias (roja si hay errores, amarilla si solo hay advertencias); al pulsarla se dispara una validación en profundidad y se abre el panel de problemas. Cada problema del panel lleva un chip de localización del paso (al pulsarlo salta al nodo correspondiente) y una sugerencia de reparación; también se puede «pasar a la IA para su reparación» uno o todos — el editor arma los problemas en un prompt estructurado y lo envía al asistente de IA.

Cajón derecho

AI Asistente

Haga clic en el icono "Asistente AI" en el medio de la columna derecha para expandirlo. Soporte:

• Utilice lenguaje natural para describir una parte de la lógica que se va a cambiar y el asistente le dará una vista previa de las diferencias;
• Comandos slash: /execute, /validate, /export, /new, /undo, /help;
• /undo revierte los cambios del asistente (hasta 10 pasos); el propio Ctrl / Cmd + Z del editor también permite deshacer los cambios de la IA paso a paso.

Ver capacidades completas Orqueste utilizando asistentes de IA.

Panel de puntos de interrupción

Este panel se ilumina cuando la ejecución se ejecuta en modo de depuración. Puede agregar/eliminar puntos de interrupción, ver el historial de visitas y editar variables durante la pausa. Ver detalles Depuración de puntos de interrupción.

Instantánea variable

Cuando hace clic en un paso, se ejecutan todas las variables disponibles antes de que se ejecute el paso, incluida var:* / pasos.*.data / classifier.* / credenciales.* (los valores de las credenciales se mostrarán insensibles).

Bloqueo de edición colaborativa

Solo una persona puede editar el mismo flujo de trabajo a la vez; el que entre primero obtendrá el candado. Cuando otras personas acceden a él, está en modo de solo lectura y la barra de estado mostrará "xxx está editando". El bloqueo se libera automáticamente después de 5 minutos de inactividad o el administrador lo fuerza a desbloquearlo.

Teclas de acceso directo de uso común

Algunos de los más utilizados en el editor: consulte la lista completa Atajos de teclado.

• Ctrl / Cmd + S — Guardar
• Ctrl / Cmd + E — Ejecutar (abrir cuadro de diálogo)
• Ctrl / Cmd + Shift + V — Verificar
• Ctrl / Cmd + Z — Deshacer (aplicable tanto al editor YAML como al asistente AI)
• Ctrl / Cmd + Shift + Z — Rehacer
• Alt + A — Cambiar el cajón del asistente de IA
• Alt + B — Cambiar panel de punto de interrupción

Siguiente paso

• 8 Tipos de pasos — La referencia autorizada sobre cómo escribir cada paso.
• Referencia de sintaxis YAML — Una referencia de campo más profunda
• Asistente de IA — Utilice lenguaje natural para cambiar el flujo de trabajo