Glosario

Todos los nombres propios, abreviaturas y términos comunes de la plataforma en inglés y chino. Ordenar por primera letra. Si tienes dudas al leer otros documentos, vuelve y compruébalos.

A

agent_based

Un tipo de paso. Un agente orquestador lee la descripción de la tarea y decide dinámicamente a qué agente trabajador asignar la subtarea. Es adecuado para escenarios donde las tareas tienen múltiples ramas y cada rama requiere juicio de LLM.

Agent

Una entidad que encapsula una sesión de LLM y sus herramientas disponibles. Los agentes en Braidrun se declaran mediante ajustes preestablecidos y se anulan según sea necesario. No es un paso en sí: algún tipo de paso (único/grupo_chat/clasificador, etc.) se referirá al Agente.

API Key

Clave de autenticación emitida por el proveedor de LLM. Se almacena como Credencial en la plataforma y siempre está encriptada y nunca aparece en el registro.

Artifact（Artefacto）

Archivos generados durante la ejecución del paso (Markdown, Excel, imágenes, JSON, etc.). Guárdelo en el directorio de productos de la plataforma y puede descargarlo desde la página de detalles de ejecución.

Logs de auditoría / Audit Log

Registros estructurados de todas las "acciones del usuario + eventos del sistema" dentro de la plataforma. El administrador puede comprobarlo en segundo plano y se conserva indefinidamente de forma predeterminada.

B

punto de interrupción / Breakpoint

Posiciones de pausa que se pueden fijar en el depurador, 9 tipos en total: antes del paso, después del paso, error del paso, estado de la máquina de estados, ronda de group chat, elemento de iteración, despacho agent_based, entrada al sub-workflow, salida del sub-workflow. Los puntos de interrupción pueden llevar una expresión de condición; al cumplirse, la execution se pausa y se pueden inspeccionar + editar variables.

BYOK

Bring Your Own Key。Los usuarios traen la clave API de su propio proveedor de LLM y el costo del token se carga a la cuenta del usuario y no representa la cuota de la plataforma.

C

classifier

Un tipo de paso. LLM asigna una etiqueta de categoría a la entrada y la salida se puede pasar {{classifier.category}} Se utiliza como condiciones de enrutamiento en pasos posteriores.

code

Un tipo de paso. Los scripts de Python/Bash/TypeScript se ejecutan en un entorno aislado, preferido para escenarios deterministas > LLM.

Condition

Expresión booleana a nivel de paso. Cuando es falso, el paso se marca como SKIPPED y se omite la ejecución. Se puede utilizar aguas abajo {{steps.x.status}} Compruebe si se omitió.

Credential（Credenciales）

AES-256-GCM cifra la clave externa almacenada. Resuelto por el espacio de nombres de tres niveles de usuario/equipo/sistema. Nunca aparece en registros o exportaciones YAML.

cron

Un tipo de disparador programado. Acepta la expresión cron estándar de 5 segmentos (minuto hora día mes semana). Cada entrada de programación tiene su propia configuración de zona horaria; en despliegues con varias instancias, un bloqueo distribuido garantiza que se dispare una sola vez en cada momento.

D

DAG

Directed Acyclic Graph。Vista de modelado visual de la plataforma. Cada nodo es un paso y los bordes representan la secuencia de ejecución/dependencia de datos. Bidirectional synchronization with YAML byte level.

DTO

Data Transfer Object。El formato de carga útil de la API JSON utiliza camelCase; el YAML correspondiente usa Snake_case. Conversión bidireccional automática cuando la plataforma está en ejecución.

Dry-run

Una opción durante la ejecución. Se omite recorrer el flujo de datos, completar variables y ejecutar pasos sin efectos secundarios (LLM/envío real de mensajes). Se utiliza para verificar la conectividad DAG.

E

Ejecutar / Execution

Una instancia en ejecución específica de un flujo de trabajo. Máquina de estado: PENDIENTE → EN EJECUCIÓN → (COMPLETADO / FALLADO / CANCELADO / INTERRUMPIDO / TIEMPO DE FUERA).

extract

campo de paso. Utilice JSONPath para seleccionar varios campos de la salida original del paso y guárdelos en el subnodo .data para obtener una referencia posterior precisa.

F-G

FeatureGate

Un servicio que controla la disponibilidad de funciones y las cuotas de recursos por plan de suscripción (Gratis/Pro/Team/Enterprise). Determine cuántos flujos de trabajo, cuántas programaciones puede crear y si puede utilizar el depurador.

group_chat

Un tipo de paso. Varios agentes hablan por turnos y se refieren al contexto de cada uno. Adecuado para lluvia de ideas y revisión crítica.

H-I

HMAC

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

idempotent

campo de paso. Promesa "misma entrada → misma salida, sin efectos secundarios". Cuando la reanudación automática está activada, los pasos idempotentes completados no se pueden rehacer.

M

manual_approval

Un tipo de paso (también disponible como mejora de cualquier paso). El flujo de ejecución está bloqueado aquí esperando la aprobación/rechazo del administrador. Canal de notificación configurable y lista de aprobadores.

MCP

Model Context Protocol。Protocolos estándar entre herramientas. Braidrun se puede utilizar como una herramienta para que el Cliente MCP consuma un Servidor MCP externo y también puede exponer sus capacidades al mundo exterior en el modo Servidor MCP.

módulo / Module

Un workflow que implementa WorkflowModuleContract. Puede ser invocado por otros workflows como una caja negra mediante el step sub_workflow. En el marketplace hay más de 120 módulos instalables.

Migración de datos

El proceso de migración de la estructura de datos se ejecuta automáticamente cuando se actualiza la plataforma; Los bloqueos distribuidos se utilizan entre instancias para garantizar que solo se ejecute un nodo.

P

Preset

Plantilla de agente. Empaquete "modelo + conjunto de herramientas predeterminado + indicador del sistema + max_iterations + estrategia" en una plantilla con nombre. La plataforma tiene incorporado universal/codificador/investigador/escritor/planificador/revisor, etc.

Provider

Proveedor de servicios de LLM. OpenAI / Anthropic / DeepSeek / Kimi / OpenRouter, etc. Un proveedor puede estar vinculado a múltiples claves API (credenciales).

R

RAG

Retrieval-Augmented Generation。Un tipo de conjunto de herramientas del Agente que realiza la recuperación de vectores en la base de conocimientos integrada. La plataforma inserta automáticamente los resultados de la búsqueda en el contexto del Agente.

Recovery Policy

Opciones de estrategia para continuación automática: ABORT (sin continuar) / RESUME_FROM_LAST_INCOMPLETE (continuando desde el paso interrumpido) / RESUME_FROM_START (reiniciando desde el principio).

Round-trip（Sincronización bidireccional）

YAML → DAG → YAML mantiene intacta la equivalencia a nivel de bytes. No se pierden comentarios, orden ni formato.

S

single

Un tipo de paso. Un único Agente + una descripción de la tarea. La primitiva de llamadas LLM más ligera.

Sandbox（caja de arena）

El entorno de ejecución del paso del código. Utilice un entorno limitado de aislamiento único en producción, privilegios mínimos/raíz de solo lectura/red saliente.

Schedule

Un elemento que desencadena un determinado flujo de trabajo con regularidad. Admite tres categorías: cron / intervalo / única. Cada horario se puede preestablecer con parámetros de entrada + zona horaria.

Skill

Herramientas a las que puede llamar el Agente. Rag / web / file / shell integrados o herramientas definidas por el usuario registradas desde el servidor MCP.

SSE

Server-Sent Events。El protocolo de transmisión de eventos en tiempo real de ejecución, el EventSource del navegador se suscribe directamente. Cada evento es una línea de JSON estructurado.

Step

La unidad de ejecución más pequeña de flujo de trabajo. Cada paso solo puede seleccionar 1 modo principal (único / chat_grupo / basado en agente / código / clasificador / máquina_estado / sub_flujo de trabajo / aprobación_manual) y se puede superponer con mejoras como condición / reintento / extracción / agregado / idempotente / on_success / on_failure.

state_machine

Un tipo de paso. Integrado con múltiples estados + condiciones de transición de estado, es adecuado para múltiples iteraciones o flujos de trabajo que contienen procesos pequeños.

sub_workflow

Un tipo de paso. Llame a otro flujo de trabajo (o módulo integrado) como un cuadro negro. Con verificación de contrato, detección de bucles y aislamiento de variables.

T-U

Team

Una colección de usuarios. Espacio de nombres de credenciales compartido y cuota de programación compartida. El administrador del equipo puede administrar miembros + credenciales.

Tool

Funciones que el Agente puede llamar durante la inferencia LLM. Incorporado + extensión MCP.

TPM

Tokens Per Minute。El indicador limitante actual del proveedor de LLM. Hay un TPM autolimitado dentro de la plataforma para evitar explotar el flujo ascendente.

V-W

Variable Reference

{{...}} Gramática. Se pueden hacer referencia a cuatro fuentes: var:* / pasos.id.* / clasificador.* / credenciales.*.

Webhook

Endpoint que dispara la ejecución de un workflow mediante POST desde un sistema externo. La autenticación es principalmente por API Key, con la firma HMAC como método de compatibilidad. Los campos de nivel superior del cuerpo de la solicitud se mapean automáticamente a variables del workflow por defecto, y también se pueden indicar explícitamente con variableMapping.

Workflow

Una colección de pasos organizados por DAG. Puede activarse manualmente mediante /cron/webhook/API. Utilice YAML para conservar el almacenamiento.

Y

YAML

El formato de persistencia del flujo de trabajo de la plataforma. Los campos van a Snake_case (asignados automáticamente con camelCase de DTO). Se puede ejecutar directamente en la CLI (braidrun-agent) y el mismo YAML también se puede editar en la interfaz de usuario web.