Crear una instancia de un flujo de trabajo a partir de una plantilla

En Braidrun, la "creación de instancias a partir de una plantilla" es el método de generación de flujo de trabajo más común: más del 90% de los usuarios no escriben su primer flujo de trabajo desde la pizarra, sino que clonan uno de la plantilla y luego lo ajustan de acuerdo con su propio negocio. Este artículo desglosa el proceso en cada botón.

Descripción completa del proceso

1. Explore la biblioteca de plantillas y seleccione una por categoría/etiqueta/búsqueda
2. Read the template details card to confirm prerequisites and estimated costs
3. Haga clic en "Usar esta plantilla" para clonarla en su espacio de trabajo.
4. Cambie los parámetros comerciales según la descripción de la variable en el editor.
5. Complete la clave en el centro de credenciales.
6. Primero haga un ensayo para verificar la estructura y luego ejecútelo nuevamente
7. Enlazar programación/activadores de webhook bajo demanda

Paso 1 · Explora la galería de plantillas

1.1 Abrir la entrada

La navegación principal a la izquierda es "Biblioteca de plantillas". Estructura de la página:

• Barra de filtro superior: 10 categorías industriales + etiquetas + búsqueda de palabras clave
• Cuadrícula de tarjeta de plantilla: muestra nombre, descripción, etiquetas, duración estimada y complejidad
• "Mi colección" en la esquina superior derecha: las plantillas a largo plazo se pueden recopilar e ingresar directamente la próxima vez

1.2 Estrategias de selección comunes

• Las necesidades son muy específicas. — Busque palabras clave directamente. Por ejemplo, si desea hacer un "recordatorio de vencimiento del certificado de TestFlight", busque el vencimiento del certificado y se bloqueará inmediatamente.
• La demanda es amplia — Convergencia basada en la industria primero. Elija una categoría de industria con la que esté más familiarizado y pase dos o tres páginas para tener una idea aproximada de qué tipos de procesos tenemos.
• Quiere "ver lo que hacen otros en la industria" — Ordene por "complejidad" y elija las más complejas; normalmente representan prácticas maduras de principio a fin.

Paso 2 · Leer los detalles de la plantilla

Haga clic en una tarjeta de plantilla para ingresar a la página de detalles, centrándose en cuatro partes:

2.1 Sección "Descripción"

En dos o tres párrafos te cuento: qué problemas resuelve, para qué escenarios es más adecuado, para qué escenarios no es adecuado y qué preparativos se requieren antes de su uso.

2.2 Lista de "Credenciales requeridas"

Enumere claramente las credenciales necesarias para ejecutar este flujo de trabajo, por ejemplo:

• openai_api_key — Clave API de OpenAI (obligatoria)
• slack_webhook_url — Token de Telegram Bot (para entrega, opcional)
• apple_appstoreconnect — App Store Connect JWT (solo se requiere para plantillas relacionadas con Apple)

Si falta una de las credenciales "requeridas", el flujo de trabajo fallará al llegar al paso correspondiente. Cuando falta "opcional", se omitirá el paso correspondiente según la condición.

2.3 "Tiempo y costo estimado"

Una ejecución completa:

• Tiempo necesario: 2 minutos/15 minutos/1 hora, según la complejidad del flujo de trabajo y la velocidad de respuesta de la dependencia externa
• Uso de token: entrada xxx promedio/salida xxx
• $ Estimado: el valor aproximado calculado en función del precio unitario predeterminado de la plataforma y de OpenAI.

2.4 "Ejemplo de entrada y ejemplo de salida"

Una muestra de entrada específica (puede simplemente copiarla y ejecutarla una vez) + la muestra de salida correspondiente (para que tenga una idea de "probablemente lo que puede obtener").

Paso 3 · Clonar al espacio de trabajo

1. punto de la esquina superior derecha "Usa esta plantilla".
2. Asigne un nombre a su copia en la ventana emergente (el valor predeterminado es nombre de plantilla + marca de tiempo, puede cambiarlo a algo más comercial).
3. Seleccione su equipo objetivo (si está en varios equipos). Esto determina quién puede ver/editar este flujo de trabajo.
4. Haga clic en Aceptar. La plataforma genera una copia para ti copia independiente, sus modificaciones no se propagan a la plantilla, y las actualizaciones posteriores de la plantilla tampoco modifican automáticamente su copia.

Paso 4 · Personalizar los parámetros comerciales

La Sección de variables 4.1 es el único lugar donde debe mirar detenidamente

Cuando se abra el editor, primero desplácese por YAML hasta la sección de variables en la parte superior. Todas las "cosas que deben ajustarse en este flujo de trabajo según su situación empresarial" están aquí, ya comentadas:

variables:
  target_date:
    type: string
    default: yesterday    # ← 改成你要跑哪一天的数据
    description: |
      支持 yesterday / last_7_days / last_30_days /
      或具体日期 2026-04-17

  top_n:
    type: number
    default: 10           # ← 要拉多少条新闻
    description: 抓取的新闻数量上限

  target_channel:
    type: string
    default: "#my_daily_digest"  # ← 改成你的 Slack 频道名或保留默认 webhook 目标
    description: Slack 目标频道或 Incoming Webhook 默认目标

4.2 Cambiar el valor predeterminado según el comentario

El valor predeterminado es solo un "ejemplo", reemplácelo con el valor real de su negocio. Cambiar las variables no destruirá la estructura, así que siéntete libre de cambiarla.

4.3 Es un buen hábito no moverse por pasos

No se recomienda cambiar la estructura de la sección de pasos cuando se ejecuta la plantilla por primera vez; primero ejecútela una vez con el proceso predeterminado, vea el flujo de datos y luego decida si desea cambiarlo.

Paso 5 · Completar el Centro de Credenciales

1. Centro de credenciales abierto.
2. Cree una credencial correspondiente para cada credencial "requerida" que figura en la página de detalles de la plantilla. El nombre debe ser exactamente el mismo que el citado en YAML.
3. Las credenciales "opcionales" se pueden dejar sin crear por ahora; se omitirán los pasos relevantes.

Paso 6 · Ejecute primero en seco y luego ejecute

6.1 El significado del ensayo

ejecución en seco a través del DAG sin costo, omitiendo todos los LLM y los efectos secundarios. Te ayuda a confirmar antes de gastar dinero:

• ¿Están todas las variables completadas correctamente?
• Las variables fluyen entre pasos.
• La rama de condición/clasificador está seleccionada correctamente.
• El nombre de la credencial dependiente se puede resolver para

6.2 Carrera real

Después de que pase el ensayo, desmarque el ensayo y haga clic en "Ejecutar" nuevamente. Esta vez realmente ajustaré el LLM y tendré efectos secundarios reales. El flujo de eventos en tiempo real en el lado derecho de la página le permite ver el progreso de cada paso.

6.3 Qué mirar después de correr

• "Ver detalles de ejecución" - Diagrama de Gantt + entrada/salida de cada paso
• "Columna de producto": la imagen/Markdown/Excel/generada se puede descargar directamente
• "Tokens / costo"——¿Cuánto gastaste esta vez?

Paso 7 · Vincula los activadores según sea necesario

Después de la ejecución manual, el flujo de trabajo está listo para conectarse. Tres métodos de activación comunes:

• Ejecuciones programadas — Diario/semanal/mensual o repetir por intervalo
• Disparador Webhook — Un sistema externo activa el workflow con un POST, autenticándose con API Key (también compatible con firma HMAC)
• Activación por API: su sistema interno usa una API Key para llamar a la REST API e iniciar la ejecución

Actualización de plantillas: seguir las nuevas versiones de la plantilla

La copia clonada no se modifica automáticamente con las actualizaciones de la plantilla. Cuando la plantilla original publique una nueva versión y usted quiera seguirla, use el flujo «Actualizar desde plantilla»: primero vea una vista previa y, tras confirmar, actualice con un solo clic.

Dónde está el punto de acceso

Se puede acceder desde dos lugares: la opción «Actualizar desde plantilla» del menú de la barra de herramientas del editor, o el aviso «Buscar actualización» situado encima de la sección de variables en el panel de configuración del workflow. El cuadro de diálogo que se abre muestra la versión actual y la versión de destino.

Vea la vista previa antes de actualizar

La vista previa clasifica las diferencias de variables en tres tipos y las enumera una por una:

• Reservar — Las variables que ya modificó y que siguen existiendo en la nueva plantilla conservan su valor tras la actualización
• Nuevo — Las variables nuevas que agrega la nueva plantilla se rellenan con el valor predeterminado de la plantilla, y puede ajustarlas según sea necesario tras la actualización
• Eliminar — Las variables que ya no existen en la nueva plantilla se descartan tras la actualización; revise esta lista una por una antes de confirmar

Qué ocurre durante la actualización

• Primero se guarda automáticamente el workflow actual como una instantánea de versión; si se arrepiente, puede revertir desde el menú «Versiones»
• La configuración estructural como el DAG de pasos, los prompts del Agent, el código y los tiempos de espera se sobrescribe según la nueva plantilla
• Los modelos que usted eligió se conservan: la selección de modelo de los Agents con el mismo nombre y las referencias a las credenciales de modelo correspondientes no se sobrescriben con la nueva plantilla
• Sus ajustes propios, como el nombre del workflow, las etiquetas y la concurrencia, no se tocan

¿Un Workflow antiguo no tiene registrada su plantilla de origen?

Los workflows clonados en las primeras versiones pueden no tener registrado su origen; en ese caso, la misma opción del menú del editor aparece como «Vincular plantilla…». Registre de qué plantilla proviene (y, de paso, puede indicar a qué versión corresponde actualmente); después podrá seguir el flujo de actualización con normalidad.

Avanzado: deja que el asistente de IA lo cambie según tu descripción

Después de la clonación, si los requisitos comerciales no son completamente consistentes con la plantilla, puede pedirle al asistente de IA que lo ayude a solucionarlo:

1. FAB en la esquina inferior derecha abre el cajón del asistente de IA
2. Describe tus necesidades, por ejemplo "cambiar paso.entregar de Telegram a Feishu"
3. El asistente te dará una vista previa de las diferencias y podrás aceptarla o rechazarla.
4. Haga clic en "Aplicar" cuando esté satisfecho: la pila de deshacer de 10 niveles lo protege de retroceder en cualquier momento

¿Cuándo debería cambiar a un asistente de IA o a la escritura a mano?

Siguiente paso

• Detalles de clasificación y plantillas típicas. — Los representantes seleccionados de cada categoría de la industria le dirán qué puede hacer cada categoría.
• Editor visual — ¿En qué botones debería hacer clic después de la clonación?
• Asistente de IA — Utilice lenguaje natural para modificar/generar flujos de trabajo