Inicio rápido

Este artículo lo lleva desde "simplemente abrir el sitio web" hasta "ejecutar un flujo de trabajo real" sin escribir código ni instalar nada en el medio. Siga las instrucciones y reconocerá casi todos los conceptos más utilizados en Braidrun Workflow.

Vista previa panorámica: qué esperar de este

A continuación se muestra el camino que tomaremos en orden. Cada paso explicará "por qué haces esto", no un manual de operación seco:

1. Registrar una cuenta → Iniciar sesión
2. Vaya a la página "Workflow" para conocer la consola principal
3. Clonar un flujo de trabajo ya preparado desde la biblioteca de plantillas
4. Comprueba su estructura con un ensayo en seco.
5. Vincule su clave LLM (BYOK)
6. Ejecútelo una vez y comprenda el flujo de eventos en tiempo real.
7. Cuelga un cron y deja que se ejecute automáticamente todos los días.

Paso 1 · Registra una cuenta

1.1 Abrir la página de registro

Haga clic en "Iniciar sesión" en la esquina superior derecha de la página de inicio, haga clic en "Crear cuenta" en la parte inferior de la página de inicio de sesión o visite directamente /register.

1.2 Código de invitación o inscripción abierta

Braidrun se encuentra actualmente en la etapa beta cerrada solo por invitación, lo que significa:

• Necesita un código de invitación para completar el registro;
• If you don't have an invitation code, please leave your email address in the "Apply for Invitation Code" form on the homepage. Nos comunicaremos contigo primero cuando se abra el cupo.

Después de obtener el código de invitación, simplemente complete el correo electrónico + contraseña + código de invitación. También puede utilizar Google/GitHub OAuth para iniciar sesión con un solo clic (este método no requiere un código de invitación, pero aún debe esperar la aprobación del administrador). Para conocer los procedimientos detallados, consulte Registro e inicio de sesión.

1.3 Verificación y activación de correo electrónico

Después de enviar el formulario, recibirá un correo electrónico de verificación. Haga clic en el enlace interior para activar su cuenta. Antes de la activación, puede navegar por la página, pero no puede crear/guardar/ejecutar flujos de trabajo; habrá un banner recordatorio naranja en la parte superior.

Paso 2 · Ingrese a la consola de flujo de trabajo

2.1 Navegación principal izquierda

Después de iniciar sesión, llegará a la página de inicio. A la izquierda hay una barra de navegación fija, que definitivamente usarás:

• Flujos — Tu principal campo de batalla. Todos los flujos de trabajo se enumeran aquí.
• Plantillas — Más de 240 workflows preconfigurados, listos para clonar y usar.
• Módulos — Más de 120 módulos reutilizables + los módulos que usted mismo promocione.
• Historial — Lista de todas las ejecuciones recientes.
• Programaciones — Entradas de activación de sincronización/webhook.
• Aprobaciones — Cuando el flujo de trabajo se encuentra en el paso "Aprobación manual", el aprobador aprueba desde aquí.
• Credenciales — Todas las claves API se colocan aquí y se almacenan cifradas.

2.2 Tres entradas rápidas a la página de inicio

La página de inicio no es un espacio vacío. Proporciona tres puntos de partida:

1. Crear un nuevo flujo de trabajo en blanco — Comience con un lienzo en blanco. Se recomienda elegir esto después de que ya esté familiarizado con la plataforma.
2. Clonar desde plantilla — Esta guía sigue este camino. Empiece rápidamente.
3. Deja que el asistente de IA genere — El FAB en la esquina inferior derecha abre el asistente de IA lateral. Utilice un lenguaje natural para describir lo que quiere hacer y obtendrá un primer borrador.

Paso 3 · Clonar desde la biblioteca de plantillas

3.1 Elija la plantilla que más se acerque a su negocio

abierto a la izquierda Plantillas. Hay filtros de clasificación en la esquina superior izquierda (automatización de operaciones, entrega de publicidad, análisis de datos, desarrollo de iOS, creación de contenido, revisión de cumplimiento...); hay cuadros de búsqueda y filtros de etiquetas en la esquina superior derecha.

Se recomienda elegir por primera vez una de estas dos categorías:

• "Resumen diario de noticias" — La lógica es simple, los pasos son pocos y se puede ver el flujo de datos completo.
• "Informe Semanal ASA" — Escenario empresarial real, utilizando programación + subflujo de trabajo + entrega de Slack.

3.2 Lectura de tarjetas de plantilla

Haga clic para ver:

• "Descripción": qué hace
• "Credenciales requeridas": ¿qué claves se deben completar al ejecutar?
• "Ejemplo de entrada/salida": representativo de resultados típicos
• "Duración/coste estimado": ¿Aproximadamente cuántos minutos y cuántos dólares costará una ejecución?

3.3 Clonar al espacio de trabajo

Haga clic en la esquina superior derecha "Usa esta plantilla". Después de la confirmación, la plataforma /workflows Se generará una copia independiente a continuación; no importa cómo la cambie más adelante, no afectará la plantilla original.

Paso 4 · Utilice el ensayo para observar por primera vez la estructura

4.1 ¿Por qué es necesario realizar un funcionamiento en seco?

El valor principal del ensayo es el "coste cero": pasará por el DAG completo, pero reemplazará todas las llamadas de LLM y los efectos secundarios externos (envío de mensajes, redacción de bases de datos, deducción de pagos, etc.) con operaciones no operativas seguras. Puedes ver:

• ¿A dónde fluye la variable? - citado {{...}} ¿Hay algún error ortográfico?
• ¿Qué pasos se omiten por condición?
• De qué credenciales depende la plantilla: sepa de antemano qué configurar en el Centro de credenciales

4.2 Iniciar el simulacro en el editor

1. En la parte superior del editor de flujo de trabajo, haga clic en "Ejecución".
2. Marque "ejecución en seco (no ajustar LLM/no generar efectos secundarios)" en el cuadro de diálogo.
3. Complete algunos parámetros necesarios de acuerdo con las indicaciones de la plantilla y deje el resto como predeterminado.
4. Haga clic en "Iniciar ejecución". El editor cambiará automáticamente a la vista de detalles de ejecución.

Paso 5 · Configurar una clave LLM (BYOK)

5.1 ¿Qué es BYOK?

"Traiga su propia llave". Puede obtener una clave API de un proveedor como OpenAI/Anthropic y agregarla a Braidrun para que pueda llamarla en su nombre. Beneficios:

• El consumo de tokens se registra directamente en su propia cuenta LLM y la plataforma no aumenta el precio.
• Puede utilizar los modelos avanzados de su propia cuenta, como Claude Opus, GPT-5, sin la garantía unificada de la plataforma.
• Rotar/revocar claves depende totalmente de usted.

5.2 Obtener una clave

Los más comunes:

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

5.3 Guárdelo en credenciales

1. Abrir Credenciales.
2. Haga clic en "Nuevas credenciales".
3. Seleccione api_key como tipo; Elija un nombre reconocible, como openai_main、anthropic_personal;El valor pega la clave que obtuvo del proveedor.
4. Guardar. La plataforma utilizará inmediatamente AES-256-GCM para cifrar la base de datos; después de eso, este campo solo se puede sobrescribir y no se puede volver a leer.

Para obtener una explicación más completa (espacio de nombres de tercer nivel, enlace de proveedor, proceso de rotación), consulte Credenciales y BYOK · usa tu propia LLM Key.

Paso 6 · Haz una carrera real

6.1 Iniciar ejecución

1. Regrese al editor de flujo de trabajo y haga clic en "Ejecutar" en la parte superior.
2. Esta vez en el cuadro de diálogo. Cancelar Compruebe el funcionamiento en seco.
3. Vuelva a rellenar los parámetros necesarios, normalmente los mismos que para el ensayo en seco la primera vez.
4. Haga clic en "Iniciar ejecución".

6.2 Comprender el flujo de eventos en tiempo real a la derecha

En el lado derecho de la página hay un flujo de eventos que se envía en tiempo real por WebSocket. Cada línea es un evento y se puede filtrar por categoría:

• Intervención del Agent — la salida intermedia del Agent, muy habitual en los pasos group_chat;
• Llamada al LLM — el resumen de cada llamada al modelo, con el número de tokens de entrada / salida;
• Llamada a herramienta — a qué herramienta llamó el Agent; al desplegarla se ven los parámetros y el valor devuelto;
• Mensaje externo — el registro de los mensajes que el workflow envía a canales como Slack / Telegram.

La explicación de más categorías de eventos está en Monitoreo y registro de ejecución.

6.3 Mira los resultados y productos

Después de ejecutar, haga clic en "Ver detalles de ejecución" en la parte superior:

• Cada barra verde del diagrama de Gantt es un paso exitoso; Pase el mouse para ver cuánto tiempo tomó.
• Haga clic en un paso para ver su instantánea de entrada/salida/registro/variable.
• Puede obtener una vista previa o descargar Markdown / Excel / capturas de pantalla, etc. en la columna del producto.

Paso 7 · Cuelga un cron y deja que se ejecute automáticamente

7.1 Crear un nuevo horario

1. "Gestión de programación" a la izquierda → "Nueva programación".
2. Como flujo de trabajo de destino, seleccione el que acaba de ejecutar.
3. Seleccione cron como tipo; completa la expresión 0 8 * * *(8:00 a. m. todos los días); seleccione Asia/Shanghai como zona horaria.
4. Si el flujo de trabajo tiene variables, complete los valores predeterminados para este lote de programaciones en "Parámetro predeterminado" (cada activador programado comenzará con estos valores).
5. Guardar. Hay un elemento más en la lista y el "próximo momento de activación" se calcula y se muestra en tiempo real.

7.2 Cómo garantizar que no haya duplicaciones en la programación

La plataforma realiza automáticamente bloqueos distribuidos en implementaciones de múltiples instancias: el mismo programa solo se activará en una máquina en el mismo minuto. No necesita preocuparse por las ejecuciones repetidas.

La programación de tiempos también se puede configurar en modo de intervalo/único. Para más detalles, consulte Ejecuciones programadas.

Después de hacer esto, ya sabes cómo

• Proceso completo de registro/inicio de sesión/verificación de correo electrónico
• Clon de biblioteca de plantillas → Ejecución en seco del editor → Bucle básico de ejecución real
• El papel del Centro de Credenciales y la importancia de BYOK
• Capacidad de leer el flujo de eventos en tiempo real + la página de detalle de la ejecución
• Cuelgue el flujo de trabajo en la entrada de ejecución automática de cron

Qué ver a continuación

• Conceptos centrales — The relationship between workflow / step / agent / module / execution / credential is clearly explained in a picture.
• Combate práctico: el primer flujo de trabajo. — Escriba un flujo de trabajo empresarial real paso a paso, con todos los conceptos unidos
• Editor visual — Explique el lienzo/YAML/barra de herramientas/bloqueo de colaboración/instantánea de versión uno por uno
• Mejores practicas — No vuelvas a pisar los hoyos que has pisado