产品总览

跟着一条真实的工作流，走一遍整个平台

Braidrun 用来搭建和运行带人工审批的 AI 工作流。右边这条增长日报每天在生产环境跑：cron 到点触发，拉取 Apple Search Ads 与 Google Ads 的花费和订阅收入，AI 写点评，生成 xlsx 发进 Slack。顺着它，平台的每个部分都会出场一次。

免费开始看真实案例 →

生产模板 v2.0.74定时触发，无人值守每步日志与成本留档

daily-growth-reportcron 0 8 * * *

fetch_ads_spend

拉取 Apple Search Ads 与 Google Ads 昨日花费

fetch_revenue

拉取订阅收入，和花费对到同一天

ai_commentary

AI 写当天点评：环比、周同比、月同比

build_xlsx

生成 xlsx 报表附件

deliver_slack

表格和点评发进团队 Slack 频道

template v2.0.74无人值守

01搭建工作流

画布和 YAML 是同一份定义

这条日报最初就是在编辑器里搭的：左边画布、右边 YAML，改任何一边另一边立即同步；说不清楚怎么改的时候，直接把需求告诉 AI 助手。

画布 ⇄ YAML 双向同步：运营看画布，工程师审 YAML，是同一份定义
内置诊断：变量引用错误、配置缺失，保存前就被标出来
版本历史带 diff，改坏了回滚到上一个能跑的版本
AI 助手对话搭建，改动一律等你点保存才生效

看编辑器与 AI 助手 →

Braidrun 工作流编辑器截图 — 可视化编辑器：画布与 YAML 同屏编辑

02编排步骤

8 种步骤类型，拼装更复杂的流程

日报用到的只有代码步骤和单 Agent 点评。步骤类型一共 8 种：要让几个 Agent 互相挑错、按状态推进，或把整条工作流当一个步骤复用时，换个 type 就够了。

single一个 Agent 按指令完成一步，日报里的 AI 点评就是它
代码沙箱里跑脚本：拉数、清洗、生成文件
分类器按输入内容把执行分流到不同分支
group_chat几个 Agent 围绕同一个问题讨论若干轮，得出结论
agent_based协调者 Agent 动态决定调用哪些工具和子任务
state_machine用显式状态和转移描述多阶段流程
sub_workflow把另一条工作流当作一个步骤来调用
workflow_output_read读取其他工作流的执行结果接着处理

daily-growth-report.yamlyaml

steps:
  - name: pull_spend
    type: sub_workflow      # 复用另一条取数工作流
    workflow: ads-spend-fetcher

  - name: review_numbers
    type: group_chat        # 几个 Agent 对着数据互相挑错
    agents: [analyst, skeptic]
    rounds: 2

  - name: plan_actions
    type: agent_based       # 协调者 Agent 按需调用工具

  - name: apply_changes
    type: code
    manual_approval: true   # 人批准了才执行

03触发与运行

cron 到点就跑，脚本进沙箱执行

这条日报由一条 5 段 cron 表达式触发，时区可配，多实例部署时分布式锁保证只触发一次；拉数和生成表格的脚本，生产环境跑在 Docker 沙箱里，变量以 WF_VAR_* 环境变量注入。

定时：5 段 cron + 时区，分布式锁防止多实例重复触发
Webhook：你的系统发一次 POST，JSON 顶层字段自动映射成变量
手动与 API：页面上点运行，或从外部系统调 v1 API 触发
链式：一条工作流完成后隔 N 秒，自动触发下一条
代码步骤支持 python、javascript、typescript、bash、ruby、lua、cli 七种语言，默认 30 秒超时

看触发与集成 →

triggerscron · webhook · api · chain

# 定时：每天早上 8 点，时区可配
schedule: "0 8 * * *"

# 或者由你的系统发一次 POST 触发
curl -X POST \
  https://braidrun.com/api/webhooks/{id}/trigger \
  -H "X-API-Key: <your-key>" \
  -d '{"channel": "#growth-daily"}'

04观测与排查