產品總覽

跟著一條真實的工作流，走一遍整個平台

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 就夠了。

單身的一個 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觀測與排查