Éditeur visuel

L'éditeur de workflow est la page sur laquelle vous passez le plus de temps chaque jour. Cet article parle de chaque zone et de chaque bouton, vous savez donc où cliquer si vous souhaitez faire X.

Disposition générale

L'éditeur est une disposition typique à trois colonnes :

• Barre d'outils supérieure — Opérations de base telles que sauvegarder/vérifier/exécuter/importer/exporter/historique des versions, etc.
• toile de la colonne de gauche — Visualisation DAG, avec nœuds glisser-déposer, connexions, zoom et mini-cartes
• Colonne de droite YAML — Monaco Editor édite directement les sources YAML avec des invites de coloration syntaxique/auto-complétion/erreur
• barre d'état inférieure — Enregistrer l'état, modifier le titulaire du verrou, la position du curseur du collaborateur, l'heure de la dernière vérification
• Tiroir droit — Assistant IA, panneau de point d'arrêt, instantané variable (ouvert à la demande)

Canvas vs YAML : synchronisation bidirectionnelle au niveau des octets

C'est la différence la plus évidente entre Braidrun et les autres marques. Un graphique DAG et un YAML sont équivalents au niveau octet :

• Vous modifiez une ligne dans YAML et le nœud correspondant sur le canevas est mis à jour instantanément ;
• Vous faites glisser une ligne de connexion sur le canevas et le champ depend_on correspondant dans YAML apparaît simultanément ;
• Les commentaires/lignes vierges/ordre des champs ne sont pas perdus - le YAML exporté est exactement le même que celui que vous voyez dans l'éditeur.

Barre d'outils supérieure

Enregistrer

Par défaut, il sera automatiquement enregistré une fois après que vous ayez arrêté de taper pendant 5 secondes ; il peut également être déclenché manuellement en appuyant sur Ctrl/Cmd + S. Chaque sauvegarde créera un instantané de la version(Pas un simple remplacement).

Annuler / Rétablir

La barre d'outils comporte deux boutons Annuler / Rétablir, avec les raccourcis Ctrl / Cmd + Z et Ctrl / Cmd + Shift + Z. Il s'agit d'une pile d'historique au niveau de l'éditeur : le glisser-déposer sur le canevas, les modifications YAML et chaque étape construite progressivement par l'assistant IA entrent dans le même historique — une « étape ratée par l'IA » peut donc aussi être annulée en un clic. Une saisie continue est fusionnée en un seul enregistrement, et l'horodatage réécrit par l'enregistrement automatique ne crée pas d'historique superflu ; les 50 derniers instantanés au maximum sont conservés, et l'historique est réinitialisé lorsque vous passez à un autre workflow.

Vérifier

Appelez l'analyseur de plateforme pour effectuer un aller-retour :

1. YAML → Objet WorkflowDefinition (couche de syntaxe)
2. WorkflowDefinition → Vérification sémantique (si la référence de variable peut être analysée, si le préréglage peut être trouvé, s'il y a des boucles dans les dépendances)
3. WorkflowDefinition → Aller-retour YAML (une erreur sera signalée en cas d'écart)

Les erreurs sont signalées par un soulignement ondulé rouge au niveau de la ligne YAML ; un clic amène à la ligne concernée. Les résultats de la validation approfondie sont également intégrés au panneau de diagnostic des problèmes décrit ci-dessous. Corrigez entièrement avant d'enregistrer et de mettre en production.

Exécuter

En cliquant sur ce bouton, une boîte de dialogue apparaîtra, vous permettant de :

• Remplissez les variables du workflow (les valeurs par défaut seront pré-remplies)
• Vérifier / Annuler dry-run (coché par défaut - fortement recommandé pour la première exécution)
• Sélectionnez la source de déclenchement (manuelle/programmée-simulation)

Après avoir cliqué sur « Démarrer l'exécution », l'éditeur ouvrira automatiquement un tiroir sur la droite pour afficher le flux d'événements en temps réel, et ouvrira en même temps les détails de l'exécution dans l'onglet actuel.

Importer/Exporter

• Importer YAML - Charge YAML à partir d'un fichier/d'un presse-papier/d'une URL en écrasant le contenu actuel.
• Exporter YAML - Téléchargez le YAML actuel dans un fichier local. Convient au contrôle de version git.
• Importez des formats externes tels que Dify/Langflow - Pro ou package supérieur requis, la plateforme se convertit automatiquement en Braidrun YAML.

Historique des versions

Chaque sauvegarde crée un instantané et conserve 100 versions par défaut (aucune limite pour Enterprise). Vous pouvez :

• Répertoriez tous les instantanés (y compris l'heure, l'économiseur, le nombre de lignes modifiées)
• Comparer avec la version actuelle
• Revenir à n'importe quelle version historique (la restauration créera un nouvel instantané et n'écrasera pas réellement l'historique)

Promote to module / Demote from module

Sélectionnez plusieurs étapes consécutives sur le canevas et cliquez sur "Promouvoir vers le module" pour extraire ces étapes dans un module sub_workflow indépendant, et la position d'origine devient un appel de module. Rétrograder l'opération inverse. Voir les détails Modularisation et réutilisation.

Opérations sur le canevas de la colonne de gauche

Ajouter un nouveau nœud

• Le bouton "+" dans le coin inférieur gauche ouvre le sélecteur de type d'étape et sélectionne un mode principal.
• Il peut également être ajouté en faisant glisser le « fragment de modèle d'étape » de la colonne de droite vers le canevas.

Se Connecter

Faites glisser le point de terminaison de sortie d'un nœud vers le point de terminaison d'entrée d'un autre nœud pour ajouter automatiquement la relation depend_on dans YAML. La plate-forme ne vous permet pas de dessiner des bords qui forment des boucles - vous serez rebondi et grillé si vous essayez de dessiner une boucle.

Menu contextuel du nœud

• Modifier : ouvrez l'extrait YAML de cette étape pour une modification partielle.
• Copier - clonez une copie de l'étape en cours (l'identifiant est automatiquement suffixé).
• Supprimer - un avertissement sera émis s'il y a des références en aval lors de la suppression.
• Définir comme début/fin : marque l'entrée/sortie explicite du flux de travail (obligatoire uniquement pour state_machine).

Zoom et mini-carte

Il y a une mini-carte dans le coin inférieur droit, qui vous permet de sauter rapidement lorsqu'un flux de travail complexe dépasse la taille du canevas. Ctrl/Cmd + molette de défilement pour zoomer ; Espace + faites glisser pour effectuer un panoramique.

Colonne de droite YAML

Saisie semi-automatique

Sur la base du schéma JSON, les noms de champs communs, les noms prédéfinis et les identifiants d'étape existants peuvent être complétés. Ctrl / Cmd + Réveil de la Force Spatiale.

Fold / Unfold

Cliquez sur la flèche à côté du numéro de ligne sur la gauche pour réduire toute l'étape. Touche de raccourci Ctrl / Cmd + Maj + [ / ].

Rechercher et remplacer

Ctrl / Cmd + F Rechercher, Ctrl / Cmd + H Remplacer. Supporte la régularité. Cela n’affectera que le flux de travail actuel – cela n’affectera pas les autres flux de travail.

Diagnostic et panneau des problèmes

L'éditeur comporte deux niveaux de lint, qui partagent le même jeu de codes de règles :

• Diagnostic instantané côté client — Recalculé localement immédiatement après chaque édition (règles structurelles telles que cycles de dépendances, références orphelines, suggestions de step id à l'orthographe proche), il alimente sans latence le panneau des problèmes, les badges de nœuds et le badge de la barre d'outils.
• Validation approfondie côté serveur — Appelée lorsque vous cliquez sur « Valider » dans la barre d'outils POST /api/workflows/lint, elle récupère tous les problèmes en une fois (la validation à l'enregistrement s'arrête à la première erreur, contrairement au lint) et complète avec des règles nécessitant des données serveur, comme les presets d'agent et les contrats de module.

Le badge de la barre d'outils affiche en temps réel le nombre d'erreurs / d'avertissements (rouge en présence d'erreurs, jaune s'il n'y a que des avertissements) ; un clic déclenche une validation approfondie et ouvre le panneau des problèmes. Dans ce panneau, chaque problème est accompagné d'une puce de localisation d'étape (un clic amène au nœud correspondant) et de suggestions de correction ; vous pouvez aussi « confier à l'IA la correction » d'un problème ou de tous — l'éditeur assemble alors les problèmes en un prompt structuré envoyé à l'assistant IA.

Tiroir droit

AI Assistante

Cliquez sur l'icône « AI Assistant » au milieu de la colonne de droite pour développer. Prise en charge :

• Utilisez un langage naturel pour décrire un élément de logique à modifier, et l'assistant donnera un aperçu des différences ;
• Commandes slash : /execute, /validate, /export, /new, /undo, /help ;
• /undo annule les modifications de l'assistant (10 étapes au maximum) ; le Ctrl / Cmd + Z propre à l'éditeur permet lui aussi d'annuler pas à pas les modifications de l'IA.

Voir les fonctionnalités complètes Orchestrer à l’aide d’assistants IA.

Panneau Points d'arrêt

Ce panneau s'allume lorsque l'exécution est en mode débogage. Vous pouvez ajouter/supprimer des points d'arrêt, afficher l'historique des accès et modifier des variables pendant une pause. Voir les détails Débogage des points d'arrêt.

Instantané variable

Lorsque vous cliquez sur une étape, toutes les variables disponibles avant l'exécution de l'étape - y compris var:* / steps.*.data / classifier.* / credentials.* (les valeurs des informations d'identification seront affichées sans sensibilité).

Verrouillage de l'édition collaborative

Une seule personne à la fois peut modifier le même flux de travail : celui qui entre en premier obtient le verrou. Lorsque d'autres personnes y accèdent, il est en mode lecture seule et la barre d'état affichera « xxx est en cours d'édition ». Le verrou est automatiquement libéré après 5 minutes d'inactivité ou est forcé à être déverrouillé par l'administrateur.

Touches de raccourci couramment utilisées

Certains des plus couramment utilisés dans l'éditeur - voir la liste complète Raccourcis clavier.

• Ctrl / Cmd + S — Enregistrer
• Ctrl / Cmd + E — Exécuter (ouvrir la boîte de dialogue)
• Ctrl / Cmd + Shift + V — Vérifier
• Ctrl / Cmd + Z — Annuler (applicable à la fois à l'éditeur YAML et à l'assistant AI)
• Ctrl / Cmd + Shift + Z — Rétablir
• Alt + A — Changer le tiroir de l'assistant IA
• Alt + B — Panneau de point d'arrêt du commutateur

Étape suivante

• 8 Types d'étapes — La référence faisant autorité sur la façon d'écrire chaque étape
• Référence de syntaxe YAML — Une référence de terrain plus approfondie
• Assistant IA — Utiliser le langage naturel pour modifier le flux de travail