Orchestrer à l’aide d’assistants IA

L'assistant IA de Braidrun n'est pas une barre d'outils de plug-in : il comprend directement le YAML, le DAG et l'état d'exécution de la page actuelle, peut modifier le flux de travail, déclencher l'exécution, installer des compétences et changer de langue. Voici comment démarrer et l’utiliser quotidiennement.

Où ouvrir

• Bouton flottant dans le coin inférieur droit (disponible sur toutes les pages principales)
• Touches de raccourciAlt + G

À l'intérieur du tiroir se trouve un panneau de conversation en streaming qui prend en charge la mise en surbrillance Markdown/code (12 langues) et les commandes slash.

Que peut-on faire ?

• Create/modify/verify/execute workflow
• Créer, activer et désactiver des planifications
• Actualiser ou installer la compétence
• Changer la langue de l'interface
• Répondez à des questions systémiques telles que « Que prend en charge ce système/Comment écrire une certaine configuration/Comment utiliser une certaine API »

Commande barre oblique

/execute               # run the current workflow (alias: /run)
/validate              # validate YAML without running
/export                # download workflow YAML
/new                   # start a fresh workflow
/undo                  # roll back the last assistant change (up to 10)
/help                  # list all slash commands

Il suffit de commencer la saisie par « / » dans le champ de texte pour le déclencher. Les commandes slash sont prioritaires sur le texte libre et appellent directement l'API de la plateforme sans passer par le modèle — elles ne consomment pas le quota quotidien de l'assistant IA. Sur des pages comme l'éditeur ou la liste des workflows, les boutons de raccourci correspondants apparaissent en outre au-dessus du champ de texte.

Aperçu différentiel et annulation de la pile

Toutes les modifications apportées aux ressources telles que le flux de travail/le calendrier/les informations d'identification vous donneront d'abord un aperçu Diff :

• Les nouvelles étapes/champs sont surlignés en vert
• Les champs modifiés sont marqués en jaune
• Les étapes/champs supprimés sont surlignés en rouge

Après confirmation, vous pouvez utiliser /undo pour revenir en arrière à tout moment, en conservant jusqu'aux 10 dernières modifications. La session elle-même peut également être exportée vers Markdown en un seul clic.

Interaction avec l'éditeur

• Lorsque vous demandez à l'assistant de construire / modifier un workflow dans l'éditeur, le canevas présente chaque modification progressivement, dans l'ordre des opérations : les nouveaux nœuds et les liaisons apparaissent un à un et vous voyez le workflow prendre forme ; les modifications ne sont enregistrées qu'après que vous ayez cliqué sur Enregistrer.
• Le panneau de diagnostic des problèmes de l'éditeur permet de « confier à l'IA la correction » d'un problème ou de tous ; le panneau des propriétés d'étape offre également un point d'entrée qui ouvre directement l'assistant avec le contexte de l'étape courante — sans avoir à copier-coller vous-même le YAML.
• Chaque modification apportée par l'assistant entre aussi dans l'historique d'annulation / rétablissement propre à l'éditeur ; Ctrl / Cmd + Z permet de revenir en arrière pas à pas.

Pour une description complète de chaque zone de l'éditeur, voir Éditeur visuel.

Préparation : Configurez votre assistant IA

Allez-y avant de l'utiliser pour la première fois Paramètres du compte → Assistant IA Ouvrez et sélectionnez un fournisseur de modèle (par exemple OpenRouter, OpenAI, Anthropic, DeepSeek), ou configurez le modèle d'abonnement dans la zone Claude Code / Codex. Le vrai secret est placé dans Gestion des informations d'identification → Mes informations d'identification Maintenance, elle sera automatiquement résolue en fonction du compte courant lors de l'exécution. Les administrateurs n'ont pas besoin de préconfigurer l'assistant AI pour les utilisateurs réguliers.

Modèle Claude Code / Codex

Si vous souhaitez que l’assistant IA appelle Claude Code ou Codex, choisissez la méthode d’authentification dans Paramètres du compte → Assistant IA → Claude Code / Codex :

• Code Claude : vous pouvez utiliser la clé API Anthropic ou le jeton d'abonnement Claude (provider=claude_code_oauth).
• Codex : vous pouvez utiliser la clé API OpenAI ou utiliser le Codex pour vous abonner à auth.json (provider=codex_subscription).
• Le mode d'abonnement n'écrit pas le jeton/auth.json dans la configuration de l'assistant AI ; il le lit uniquement à partir de vos informations d'identification personnelles ou d'équipe.

Base de connaissances documentaire

Pour que l'assistant AI réponde à une question de documentation du système (par exemple « Quel est le délai d'expiration par défaut pour manual_approval »), accédez à Paramètres → Stockage persistant de la plateforme → Base de connaissances de la documentation AI Assistant Confirmez qu'il est activé. Les guides intégrés, les documents maîtres du projet et les documents de référence sélectionnés sont indexés par défaut et la création automatique au démarrage est activée par défaut ; vous pouvez afficher l'état et cliquer manuellement sur "Reconstruire la base de connaissances" sur la même page.

"Processus de réflexion" Raisonnement en streaming

Lorsque le modèle sélectionné prend en charge le raisonnement (Claude Sonnet 4.5 / 4.6 / 4.7, DeepSeek-R1, séries GPT-o1 / o3, Gemini Thinking, etc.), le tiroir de l'assistant AI affichera d'abord une carte pliée « Processus de réflexion de l'Assistant AI ». Le modèle présente d'abord le résumé du raisonnement ici, puis génère la réponse finale :

• L'événement Reasoning_delta est réduit par le client et ne rafraîchira pas l'écran (en évitant de restituer chaque image)
• Le raisonnement complet n'est rendu qu'avec la sous-catégorie réflexion lorsque Reasoning_complete
• Cliquez sur la carte de réflexion pour l'agrandir/la réduire ; il est réduit par défaut pour éviter d'occuper le champ de vision
• Le contenu de la réflexion sera également enregistré dans la pile d'annulation avec /undo pour faciliter la révision.

Les modèles qui ne prennent pas en charge le raisonnement n'afficheront aucune carte supplémentaire et se comporteront comme avant.

Mémoire à long terme

L'assistant IA est indépendant par session par défaut. Si vous souhaitez qu'il « mémorise » vos préférences (« J'aime les réponses chinoises + démarque courte », « Mon flux de travail ASA s'exécute toujours tôt le matin »), vous pouvez activer la mémoire à long terme dans la configuration de AI Assistant :

• Après activation, les messages utilisateur et les réponses de l'assistant seront vectorisés et stockés dans l'espace de noms inter-session ltm:<user_id>:*.
• Lorsque le prochain cycle de dialogue commencera, les mémoires pertinentes les plus importantes seront automatiquement récupérées sous forme d'injection de contexte.
• Il y a un bouton « Effacer la mémoire à long terme » dans le coin supérieur droit de la barre latérale de l'Assistant AI. POST /api/global-agent/memory/clear efface tous les espaces de noms de l'utilisateur actuel en un seul clic ; convient pour une utilisation lors du changement d'appareil/de changement d'équipe.

Conseils

• Si vous souhaitez que l'IA génère YAML : demandez-lui explicitement de générer Snake_case YAML
• Flux de branchement : donner la priorité à la génération de la structure du classificateur + condition
• Grand changement : utilisez un langage naturel pour décrire l'intention, puis divisez-la en Diff en plusieurs étapes
• combiner débogueur : Une fois la modification de l'IA terminée, activez le débogage et exécutez le flux de travail à sec avant de le mettre en ligne.
• Lors de la sélection d'un modèle prenant en charge le raisonnement, vous pouvez voir directement le « processus de réflexion » et la conception de l'invite de débogage est très utile.