快速開始

這一篇帶你從"剛打開網站"到"跑通一條真實工作流"，中間不用寫代碼、不用裝任何東西。跟著走一遍，你會認識 Braidrun Workflow 裡幾乎所有最常用的概念。

全景預覽：這一篇會發生什麼

下面是我們會按順序走的路徑。每一步都會解釋"為什麼要這樣做"，不是乾巴巴的操作手冊：

1. 註冊賬號 → 登錄進來
2. 到「工作流」頁認識主控臺
3. 從模板庫克隆一條現成工作流
4. 用 dry-run 檢查它的結構
5. 綁定你的 LLM Key（BYOK）
6. 真跑一次，讀懂實時事件流
7. 掛一個 cron 讓它每天自動跑

第 1 步 · 註冊賬號

1.1 打開註冊頁

首頁右上角點「登錄」，在登錄頁底部點「創建賬號」，或者直接訪問 /register。

1.2 邀請碼或開放註冊

Braidrun 目前處於邀請制內測階段，意思是：

• 你需要一個邀請碼才能完成註冊；
• 沒有邀請碼的話，在首頁「申請邀請碼」表單留下你的郵箱，我們開放名額時會優先聯繫你。

拿到邀請碼後，填郵箱 + 密碼 + 邀請碼即可。也可以用 Google / GitHub OAuth 一鍵登錄（這種方式不需要邀請碼但仍需等待管理員批准）。詳細流程見 註冊與登入。

1.3 郵箱驗證與激活

提交表單後會收到一封驗證郵件，點擊裡面的鏈接激活賬號。激活前你能瀏覽頁面但不能創建 / 保存 / 執行工作流 —— 頂部會有一條橙色提示橫幅。

第 2 步 · 進入工作流控制檯

2.1 左側主導航

登錄後你落在首頁。左側是一條固定的導航欄，這幾個你一定會用到：

• 工作流程 — 你的主戰場。所有工作流都在這裡列出。
• 模板庫 — 240+ 條預置工作流，複製即用。
• 模組庫 — 120+ 個可重複使用模組 + 你自己 Promote 的模組。
• 執行歷史 — 最近的所有 execution 列表。
• 調度管理 — 定時 / Webhook 觸發條目。
• 審批管理 — 工作流掛在「人工審批」步驟時，審批人從這裡批准。
• 憑據管理 — 所有 API Key 放這裡，加密存儲。

2.2 首頁的三個快捷入口

首頁不是一張空地。它提供三種起點：

1. 新建空白工作流 — 從一張白畫布開始。推薦已經對平臺熟悉之後再選這個。
2. 從模板克隆 — 本指南採用這一條路徑。最快上手。
3. 讓 AI 助手生成 — 右下角的 FAB 打開側邊 AI 助手，用自然語言描述你要幹什麼，它會給出一個初稿。

第 3 步 · 從模板庫克隆

3.1 挑一個最貼近你業務的模板

打開左側 模板庫。左上角有分類篩選（運營自動化、廣告投放、數據分析、iOS 開發、內容創作、合規審查 …）；右上角有搜索框和標籤過濾。

建議第一次選這兩類之一：

• 「每日新聞摘要」 — 邏輯簡單，步驟少，看得到完整數據流。
• 「ASA 週報」 — 真實業務場景，用到調度 + 子工作流程 + Slack 投遞。

3.2 閱讀模板卡片

點進去看：

• 「描述」—— 它是幹什麼的
• 「所需憑據」—— 跑起來要填哪些 key
• 「示例輸入 / 輸出」—— 能代表典型結果
• 「預估時長 / 成本」—— 跑一次大概多少分鐘、多少美元

3.3 克隆到工作區

點右上角 「使用此模板」。確認後平臺會在 /workflows 下為你生成一份獨立的副本 —— 之後你怎麼改都不會影響原模板。

第 4 步 · 用 dry-run 先看結構

4.1 為什麼非要 dry-run？

dry-run 的核心價值是"零成本"：它會走完一遍完整的 DAG，但把所有 LLM 調用和外部副作用（發消息、寫數據庫、扣款等）替換成安全的 no-op。你能看到：

• 變量到底流到了哪裡 —— 引用的 {{...}} 有沒有拼錯
• 哪些 step 被 condition 跳過了
• 模板對哪些憑據有依賴 —— 提前知道要在憑據中心配什麼

4.2 在編輯器裡啟動 dry-run

1. 在工作流編輯器頂部點 「執行」。
2. 對話框裡勾選「dry-run（不調 LLM / 不發副作用）」。
3. 按模板提示填若干必要參數，剩下的留默認即可。
4. 點「開始執行」。編輯器會自動切到執行詳情視圖。

第 5 步 · 配置一把 LLM Key（BYOK）

5.1 什麼是 BYOK

"Bring Your Own Key"。你自己去 OpenAI / Anthropic 等 provider 拿一把 API Key，配在 Braidrun 裡讓它代你調用。好處：

• Token 消耗直接記在你自己的 LLM 賬戶上，平臺不加價。
• 你可以用自己賬戶的高級模型 —— 比如 Claude Opus、GPT-5 —— 而不用平臺統一兜底。
• 輪換 / 吊銷 Key 完全由你掌握。

5.2 拿一把 Key

最常見的幾家：

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

5.3 在憑據中心存它

1. 開啟 憑據管理。
2. 點「新建憑據」。
3. 類型選 api_key；名字起一個有辨識度的，比如 openai_main、anthropic_personal；值粘貼你從 provider 拿到的 key。
4. 保存。平臺會立刻用 AES-256-GCM 加密落庫 —— 之後這個字段只能覆蓋，不能讀回。

更完整的解釋（三級命名空間、provider 綁定、輪換流程）見 憑據管理 和 BYOK · 自帶 LLM Key。

第 6 步 · 真跑一次

6.1 啟動執行

1. 回到工作流編輯器，頂部點「執行」。
2. 對話框裡這次 取消 勾選 dry-run。
3. 再次填必要參數 —— 通常第一次會和 dry-run 填一樣。
4. 點「開始執行」。

6.2 讀懂右側實時事件流

頁面右側是一條透過 WebSocket 即時推送的事件流。每一列是一個事件，可以按類別篩選：

• Agent 發言 —— Agent 的中間輸出，group_chat 步驟裡最常見；
• LLM 呼叫 —— 每次模型呼叫的摘要，帶輸入 / 輸出 token 數；
• 工具呼叫 —— Agent 呼叫了哪個工具，展開可以看參數與回傳值；
• 對外訊息 —— 工作流向 Slack / Telegram 等通道發出的訊息記錄。

更多事件類別的解釋見 執行監控與日誌。

6.3 看結果與產物

跑完後頂部點「查看執行詳情」：

• 甘特圖裡每個綠色橫條是成功的 step；鼠標懸停看耗時。
• 點某個 step 看它的輸入 / 輸出 / 日誌 / 變量快照。
• 產物欄裡可以預覽或下載 Markdown / Excel / 截圖等。

第 7 步 · 掛一個 cron 讓它自動跑

7.1 新建調度

1. 左側「調度管理」→「新建調度」。
2. 目標工作流選你剛才跑通的那條。
3. 類型選 cron；表達式填 0 8 * * *（每天早上 8:00）；時區選 Asia/Shanghai。
4. 如果工作流有變量，在「參數預設」裡填這批調度默認用的值（每次定時觸發都會帶著這些值啟動）。
5. 保存。列表裡就多了一條，「下次觸發時間」實時計算顯示。

7.2 調度如何保證不重複

多實例部署下平臺自動做分佈式鎖：同一個調度同一分鐘只會在一臺機器上被觸發。你不需要擔心重複跑。

定時調度還能按 interval / one-time 方式配，詳見 定時調度。

做完這些，你已經會的

• 註冊 / 登錄 / 郵箱驗證的完整流程
• 模板庫克隆 → 編輯器 dry-run → 真跑的基本循環
• 憑據中心的角色以及 BYOK 的意義
• 讀即時事件流 + 執行詳情頁的能力
• 把工作流掛到 cron 自動跑的入口

接下來看什麼

• 核心概念 — workflow / step / agent / module / execution / credential 之間的關係一張圖講清楚
• 實戰：第一條工作流程 — 手把手寫一條真實業務工作流，所有概念串在一起
• 視覺化編輯器 — 把畫布 / YAML / 工具欄 / 協作鎖 / 版本快照一個一個講清楚
• 最佳實踐 — 踩過的坑別再踩一遍