Glossaire

Tous les noms propres, abréviations et termes courants sur la plateforme en anglais et en chinois. Trier par première lettre. Si vous avez des doutes à la lecture d’autres documents, revenez les vérifier.

A

agent_based

Un type d'étape. Un agent orchestrateur lit la description de la tâche et décide dynamiquement à quel agent de travail attribuer la sous-tâche. Il convient aux scénarios dans lesquels les tâches ont plusieurs branches et chaque branche nécessite un jugement LLM.

Agent

Une entité qui encapsule une session LLM et ses outils disponibles. Les agents dans Braidrun sont déclarés par préréglage et remplacés selon les besoins. Ce n'est pas une étape en soi - un certain type d'étape (single / group_chat / classifier, etc.) fera référence à l'agent.

API Key

Clé d'authentification émise par le fournisseur LLM. Il est stocké comme identifiant dans la plateforme et est toujours crypté et n'apparaît jamais dans le journal.

Artifact（Livrable）

Fichiers générés lors de l'exécution de l'étape (Markdown, Excel, images, JSON, etc.). Enregistrez-le dans le répertoire produit de la plateforme et peut être téléchargé à partir de la page des détails d'exécution.

Journaux d’audit / Audit Log

Journaux structurés de toutes les « actions utilisateur + événements système » au sein de la plateforme. Il peut être vérifié par l'administrateur en arrière-plan et est conservé indéfiniment par défaut.

B

point d'arrêt / Breakpoint

Positions de pause configurables dans le débogueur, au nombre de 9 : avant une étape, après une étape, en cas d'erreur d'étape, état de la machine à états, tour de group chat, élément d'itération, répartition agent_based, entrée de sous-workflow, sortie de sous-workflow. Un point d'arrêt peut être assorti d'une expression conditionnelle ; une fois atteint, l'execution se met en pause et vous pouvez inspecter et modifier les variables.

BYOK

Bring Your Own Key。Les utilisateurs apportent leur propre clé API de fournisseur LLM, et le coût du jeton est facturé sur le propre compte de l'utilisateur et ne tient pas compte du quota de la plateforme.

C

classifier

Un type d'étape. LLM attribue une étiquette de catégorie à l'entrée et la sortie peut être transmise {{classifier.category}} Utilisé comme conditions de routage dans les étapes suivantes.

code

Un type d'étape. Les scripts Python/Bash/TypeScript sont exécutés dans un bac à sable isolé, préféré pour les scénarios déterministes > LLM.

Condition

Expression booléenne au niveau des étapes. Lorsqu'elle est fausse, l'étape est marquée comme SKIPPED et l'exécution est ignorée. Peut être utilisé en aval {{steps.x.status}} Vérifiez si ignoré.

Credential（Informations d'identification）

AES-256-GCM chiffre la clé externe stockée. Résolu par l'espace de noms à trois niveaux utilisateur/équipe/système. N'apparaît jamais dans les journaux ou les exportations YAML.

cron

Un type de déclencheur planifié. Accepte l'expression cron standard à 5 champs (minute heure jour mois jour-de-semaine). Chaque entrée de planification possède son propre réglage de fuseau horaire ; dans un déploiement multi-instances, un verrou distribué garantit qu'un même instant ne déclenche qu'une seule fois.

D

DAG

Directed Acyclic Graph。Vue de modélisation visuelle de la plateforme. Chaque nœud est une étape et les bords représentent la dépendance séquence d'exécution/données. Synchronisation bidirectionnelle avec le niveau d'octet YAML.

DTO

Data Transfer Object。Le format de charge utile de l'API JSON utilise camelCase ; le YAML correspondant utilise Snake_case. Conversion bidirectionnelle automatique lorsque la plateforme est en cours d'exécution.

Dry-run

Une option lors de l'exécution. Parcourir le flux de données, remplir des variables et exécuter des étapes sans effets secondaires (LLM/envoi réel de messages) sont ignorés. Utilisé pour vérifier la connectivité DAG.

E

Exécuter / Execution

Une instance en cours d’exécution spécifique d’un flux de travail. Machine à états : EN ATTENTE → RUNNING → (TERMINÉ / ÉCHEC / ANNULÉ / INTERRUPTÉ / TIMED_OUT).

extract

champ d'étape. Utilisez JSONPath pour sélectionner plusieurs champs dans la sortie originale de l'étape et enregistrez-les dans le sous-nœud .data pour une référence précise en aval.

F-G

FeatureGate

Un service qui contrôle la disponibilité des fonctionnalités et les quotas de ressources par plan d'abonnement (Free/Pro/Team/Enterprise). Déterminez le nombre de flux de travail, le nombre de planifications que vous pouvez créer et si vous pouvez utiliser le débogueur.

group_chat

Un type d'étape. Plusieurs agents parlent à tour de rôle et se réfèrent au contexte de chacun. Convient pour le brainstorming et l'examen critique.

H-I

HMAC

Webhook 触发的兼容认证方式。外部调用方用共享密钥对 raw body 算 HMAC-SHA256，以 sha256=<hex> 格式放进 X-Webhook-Signature 头。新接入建议直接用带 WEBHOOK_TRIGGER 范围的 API Key。

idempotent

champ d'étape. Promesse "même entrée → même sortie, pas d'effets secondaires". Lorsque la reprise automatique est activée, les étapes idempotentes terminées peuvent être ignorées et ne pas être refaites.

M

manual_approval

Un type d'étape (également disponible en tant qu'amélioration de n'importe quelle étape). Le flux d'exécution est bloqué ici en attente de l'approbation/refus de l'administrateur. Canal de notification configurable et liste d’approbateurs.

MCP

Model Context Protocol。Protocoles standard entre les outils. Braidrun peut être utilisé comme un outil permettant au client MCP de consommer un serveur MCP externe, et il peut également exposer ses capacités au monde extérieur en mode serveur MCP.

modules / Module

Un workflow qui implémente WorkflowModuleContract. Il peut être appelé comme une boîte noire par d'autres workflows via une step sub_workflow. Le marché propose plus de 120 modules installables.

Migration de données

Le processus de migration de la structure des données est automatiquement exécuté lors de la mise à niveau de la plateforme ; des verrous distribués sont utilisés sur toutes les instances pour garantir qu'un seul nœud s'exécute.

P

Preset

Modèle d'agent. Packagez "modèle + ensemble d'outils par défaut + invite système + max_iterations + stratégie" dans un modèle nommé. La plate-forme intègre un universel/codeur/chercheur/écrivain/planificateur/réviseur, etc.

Provider

Prestataire de services LLM. OpenAI / Anthropic / DeepSeek / Kimi / OpenRouter etc. Un fournisseur peut être lié à plusieurs clés API (informations d'identification).

R

RAG

Retrieval-Augmented Generation。Un type d'ensemble d'outils d'agent qui effectue une récupération vectorielle sur la base de connaissances intégrée. La plateforme insère automatiquement les résultats de la recherche dans le contexte de l'Agent.

Recovery Policy

Options de stratégie pour la poursuite automatique : ABORT (ne continue pas) / RESUME_FROM_LAST_INCOMPLETE (reprise de l'étape interrompue) / RESUME_FROM_START (redémarrage depuis le début).

Round-trip（Synchronisation bidirectionnelle）

YAML → DAG → YAML maintient intacte l'équivalence au niveau des octets. Aucun commentaire, ordre ou formatage n'est perdu.

S

single

Un type d'étape. Un seul Agent + une description de tâche. La primitive d'appel LLM la plus légère.

Sandbox（bac à sable）

L'environnement d'exécution de l'étape de code. Utilisez un bac à sable d'isolation unique en production, moindres privilèges / racine en lecture seule / réseau sortant.

Schedule

Un élément qui déclenche régulièrement un certain flux de travail. Prend en charge trois catégories : cron / intervalle / unique. Chaque programme peut être prédéfini avec des paramètres d'entrée + un fuseau horaire.

Skill

Outils pouvant être appelés par l'agent. Rag / Web / fichier / shell intégré ou outils définis par l'utilisateur enregistrés à partir du serveur MCP.

SSE

Server-Sent Events。Protocole de streaming d'événements en temps réel de l'exécution, l'EventSource du navigateur s'abonne directement. Chaque événement est une ligne de JSON structuré.

Step

La plus petite unité d'exécution du workflow. Chaque étape ne peut sélectionner qu'un seul mode principal (single/group_chat/agent_based/code/classifier/state_machine/sub_workflow/manual_approval), et peut être superposée avec des améliorations telles que condition/retry/extrait/agrégat/idempotent/on_success/on_failure.

state_machine

Un type d'étape. Intégré à plusieurs états + conditions de transition d'état, il convient à plusieurs itérations ou workflows contenant de petits processus.

sub_workflow

Un type d'étape. Appelez un autre workflow (ou module intégré) sous forme de boîte noire. Avec vérification du contrat, détection de boucle et isolation variable.

T-U

Team

Une collection d'utilisateurs. Espace de noms d’informations d’identification partagé et quota de planification partagé. L'administrateur de l'équipe peut gérer les membres + les informations d'identification.

Tool

Fonctions que l'agent peut appeler lors de l'inférence LLM. Extension intégrée + MCP.

TPM

Tokens Per Minute。L'indicateur limitant actuel du fournisseur LLM. Il y a un TPM autolimité à l’intérieur de la plateforme pour éviter de faire exploser l’amont.

V-W

Variable Reference

{{...}} Grammaire. Quatre sources peuvent être référencées : var:*/steps.id.*/classifier.*/credentials.*.

Webhook

Un endpoint permettant à un système externe de déclencher l'exécution d'un workflow par requête POST. L'authentification par API Key est le mode principal, la signature HMAC servant de compatibilité. Les champs de premier niveau du corps de requête sont par défaut mappés automatiquement vers les variables du workflow ; ils peuvent aussi être spécifiés explicitement via variableMapping.

Workflow

Un ensemble d'étapes organisées par DAG. Peut être déclenché manuellement par /cron/webhook/API. Utilisez YAML pour conserver le stockage.

Y

YAML

Le format de persistance du workflow de la plateforme. Les champs vont Snake_case (automatiquement mappés avec camelCase de DTO). Il peut être exécuté directement dans la CLI (braidrun-agent), et le même YAML peut également être modifié dans l'interface utilisateur Web.