Démarrage rapide

Cet article vous emmène de « simplement ouvrir le site Web » à « exécuter un véritable flux de travail » sans écrire de code ni installer quoi que ce soit au milieu. Suivez-nous et vous reconnaîtrez presque tous les concepts les plus couramment utilisés dans Braidrun Workflow.

Aperçu panoramique : à quoi s'attendre dans celui-ci

Vous trouverez ci-dessous le chemin que nous emprunterons dans l’ordre. Chaque étape expliquera « pourquoi vous faites cela », et non un manuel d'utilisation sec :

1. Créer un compte → Se connecter
2. Rendez-vous sur la page "Workflow" pour découvrir la console principale
3. Cloner un flux de travail prêt à l'emploi à partir de la bibliothèque de modèles
4. Vérifiez sa structure avec un essai à sec
5. Liez votre clé LLM (BYOK)
6. Exécutez-le une fois et comprenez le flux d'événements en temps réel
7. Raccrochez un cron et laissez-le s'exécuter automatiquement tous les jours

Étape 1 · Créez un compte

1.1 Ouvrir la page d'inscription

Cliquez sur « Connexion » dans le coin supérieur droit de la page d'accueil, cliquez sur « Créer un compte » en bas de la page de connexion ou visitez directement /register.

1.2 Code d'invitation ou inscription ouverte

Braidrun est actuellement en phase bêta fermée sur invitation uniquement, ce qui signifie :

• Vous avez besoin d'un code d'invitation pour finaliser votre inscription ;
• Si vous n'avez pas de code d'invitation, veuillez laisser votre adresse e-mail dans le formulaire « Demander un code d'invitation » sur la page d'accueil. Nous vous contacterons en premier lorsque le quota sera ouvert.

Après avoir obtenu le code d'invitation, remplissez simplement l'email + le mot de passe + le code d'invitation. Vous pouvez également utiliser Google/GitHub OAuth pour vous connecter en un seul clic (cette méthode ne nécessite pas de code d'invitation mais doit quand même attendre l'approbation de l'administrateur). Pour les procédures détaillées, voir Inscription et connexion.

1.3 Vérification et activation des e-mails

Après avoir soumis le formulaire, vous recevrez un e-mail de vérification. Cliquez sur le lien à l'intérieur pour activer votre compte. Avant l'activation, vous pouvez parcourir la page mais vous ne pouvez pas créer/enregistrer/exécuter des workflows - il y aura une bannière de rappel orange en haut.

Étape 2 · Accédez à la console de workflow

2.1 Navigation principale gauche

Après vous être connecté, vous arrivez sur la page d'accueil. Sur la gauche se trouve une barre de navigation fixe, que vous utiliserez certainement :

• Workflows — Votre champ de bataille principal. Tous les flux de travail sont répertoriés ici.
• Modèles — 240+ workflows préconfigurés, utilisables par simple clonage.
• Modules — 120+ modules réutilisables + les modules que vous promouvez vous-même.
• Historique — Liste de toutes les exécutions récentes.
• Planifications — Entrées de déclenchement de synchronisation/Webhook.
• Approbations — Lorsque le flux de travail se trouve à l'étape « Approbation manuelle », l'approbateur approuve à partir d'ici.
• Identifiants — Toutes les clés API sont placées ici et stockées cryptées.

2.2 Trois accès rapides à la page d'accueil

La page d'accueil n'est pas un espace vide. Il propose trois points de départ :

1. Créer un nouveau workflow vierge — Commencez avec une toile vierge. Il est recommandé de choisir cette option une fois que vous êtes déjà familiarisé avec la plateforme.
2. Cloner à partir d'un modèle — Ce guide suit ce chemin. Commencez vite.
3. Laissez l'assistant IA générer — Le FAB dans le coin inférieur droit ouvre l’assistant IA latéral. Utilisez un langage naturel pour décrire ce que vous voulez faire, et cela vous donnera une première ébauche.

Étape 3 · Cloner à partir de la bibliothèque de modèles

3.1 Choisissez un modèle le plus proche de votre entreprise

ouvert à gauche Modèles. Il y a des filtres de classification dans le coin supérieur gauche (automatisation des opérations, diffusion de la publicité, analyse des données, développement iOS, création de contenu, vérification de la conformité...) ; il y a des champs de recherche et des filtres de balises dans le coin supérieur droit.

Il est recommandé de choisir pour la première fois une de ces deux catégories :

• "Résumé quotidien de l'actualité" — La logique est simple, les étapes sont peu nombreuses et le flux de données complet est visible.
• "Rapport hebdomadaire ASA" — Scénario commercial réel, utilisant la planification + le sous-workflow + la livraison Slack.

3.2 Lecture des fiches modèles

Cliquez pour voir :

• "Description" - ce qu'il fait
• « Informations d'identification requises » – Quelles clés doivent être renseignées lors de l'exécution ?
• "Exemple d'entrée/sortie" - représentatif de résultats typiques
• « Durée/coût estimé » – Combien de minutes et combien de dollars environ coûtera une exécution ?

3.3 Cloner vers l'espace de travail

Cliquez sur le coin supérieur droit "Utilisez ce modèle". Après confirmation, la plateforme /workflows Une copie indépendante sera générée pour vous ci-dessous - peu importe la manière dont vous la modifierez ultérieurement, cela n'affectera pas le modèle d'origine.

Étape 4 · Utilisez un essai à sec pour examiner d'abord la structure

4.1 Pourquoi est-il nécessaire d'effectuer un essai à sec ?

La valeur fondamentale du test à sec est le « coût nul » : il passera par le DAG complet, mais remplacera tous les appels LLM et les effets secondaires externes (envoi de messages, écriture de bases de données, déduction de paiements, etc.) par des non-opérations sécurisées. Vous pouvez voir :

• Où va la variable - citée {{...}} Y a-t-il des fautes d'orthographe ?
• Quelles étapes sont ignorées par condition
• De quelles informations d'identification dépend le modèle - sachez à l'avance ce qu'il faut configurer dans le Credential Center

4.2 Lancer le test à sec dans l'éditeur

1. En haut de l'éditeur de workflow, cliquez sur "Exécution".
2. Cochez « essai à sec (ne pas ajuster le LLM/ne pas générer d’effets secondaires) » dans la boîte de dialogue.
3. Remplissez certains paramètres nécessaires selon les invites du modèle et laissez le reste par défaut.
4. Cliquez sur "Démarrer l'exécution". L'éditeur passera automatiquement à la vue des détails d'exécution.

Étape 5 · Configurer une clé LLM (BYOK)

5.1 Qu'est-ce que BYOK

"Apportez votre propre clé". Vous pouvez obtenir une clé API auprès d'un fournisseur tel qu'OpenAI / Anthropic et l'ajouter à Braidrun afin qu'elle puisse être appelée en votre nom. Avantages :

• La consommation de tokens est directement enregistrée sur votre propre compte LLM, et la plateforme n'augmente pas le prix.
• Vous pouvez utiliser les modèles avancés de votre propre compte - comme Claude Opus, GPT-5 - sans la garantie unifiée de la plateforme.
• La rotation/la révocation des clés dépend entièrement de vous.

5.2 Obtenir une clé

Les plus courants :

• OpenAI — platform.openai.com/api-keys
• Anthropic — console.anthropic.com
• DeepSeek — platform.deepseek.com
• Kimi — platform.moonshot.cn

5.3 Stockez-le dans les informations d'identification

1. Ouvrir Identifiants.
2. Cliquez sur « Nouvelles informations d'identification ».
3. Sélectionnez api_key comme type ; choisissez un nom reconnaissable, tel que openai_main、anthropic_personal;Value colle la clé que vous avez obtenue du fournisseur.
4. Enregistrez. La plate-forme utilisera immédiatement AES-256-GCM pour chiffrer la base de données. Après cela, ce champ ne pourra qu'être écrasé et ne pourra plus être relu.

Pour une explication plus complète (espace de noms de troisième niveau, liaison de fournisseur, processus de rotation), voir Identifiants et BYOK · utilisez votre propre LLM Key.

Étape 6 · Faites une vraie course

6.1 Démarrer l'exécution

1. Revenez à l'éditeur de workflow et cliquez sur "Exécuter" en haut.
2. Cette fois dans la boîte de dialogue Annuler Vérifiez le fonctionnement à sec.
3. Remplissez à nouveau les paramètres nécessaires - généralement les mêmes que pour le premier essai à sec.
4. Cliquez sur "Démarrer l'exécution".

6.2 Comprendre le flux d'événements en temps réel à droite

La partie droite de la page présente un flux d'événements poussé en temps réel via WebSocket. Chaque ligne est un événement, filtrable par catégorie :

• Prise de parole de l'Agent — sortie intermédiaire de l'Agent, la plus fréquente dans les étapes group_chat ;
• Appel LLM — résumé de chaque appel de modèle, avec le nombre de token d'entrée / sortie ;
• Appel d'outil — quel outil l'Agent a appelé ; l'expansion permet de voir les paramètres et la valeur de retour ;
• Message externe — enregistrement des messages émis par le workflow vers des canaux tels que Slack / Telegram.

Pour l'explication d'autres catégories d'événements, voir Surveillance et journalisation de l'exécution.

6.3 Regardez les résultats et les produits

Après l'exécution, cliquez sur « Afficher les détails de l'exécution » en haut :

• Chaque barre verte du diagramme de Gantt représente une étape réussie ; passez la souris pour voir combien de temps cela a pris.
• Cliquez sur une étape pour voir son instantané d'entrée/sortie/journal/variable.
• Vous pouvez prévisualiser ou télécharger Markdown / Excel / captures d'écran, etc. dans la colonne produit.

Étape 7 · Raccrochez un cron et laissez-le s'exécuter automatiquement

7.1 Créer un nouvel horaire

1. "Gestion des plannings" à gauche → "Nouveau planning".
2. Comme flux de travail cible, sélectionnez celui que vous venez de parcourir.
3. Sélectionnez cron comme type ; remplissez l'expression 0 8 * * *(8h00 tous les jours); sélectionnez Asie/Shanghai comme fuseau horaire.
4. Si le workflow comporte des variables, renseignez les valeurs par défaut de ce lot de plannings dans « Paramètre par défaut » (chaque déclencheur planifié démarrera avec ces valeurs).
5. Enregistrez. Il y a un élément supplémentaire dans la liste et le « prochain temps de déclenchement » est calculé et affiché en temps réel.

7.2 Comment garantir l'absence de duplication dans la planification

La plateforme effectue automatiquement des verrouillages distribués en cas de déploiement multi-instance : le même planning ne sera déclenché que sur une machine à la même minute. Vous n’avez pas à vous soucier des répétitions.

La planification du temps peut également être configurée en mode intervalle/ponctuel. Pour plus de détails, voir Exécutions planifiées.

Après avoir fait cela, vous savez déjà comment

• Processus complet d’inscription/connexion/vérification de l’e-mail
• Clonage de la bibliothèque de modèles → Exécution à sec de l'éditeur → Boucle de base de l'exécution réelle
• Le rôle du Credential Center et l’importance du BYOK
• Capacité de lire le flux d'événements en temps réel et la page de détails d'exécution
• Accrochez le flux de travail à l'entrée d'exécution automatique cron

Que regarder ensuite

• Concepts de base — La relation entre workflow / étape / agent / module / exécution / informations d'identification est clairement expliquée dans une image.
• Combat pratique : le premier workflow — Écrivez étape par étape un véritable flux de travail commercial, avec tous les concepts liés ensemble
• Éditeur visuel — Expliquez le canevas/YAML/barre d'outils/verrouillage de collaboration/instantané de version un par un
• Meilleures pratiques — Ne marchez pas sur les fosses sur lesquelles vous avez encore marché