使用 AI 助理編排

Braidrun 的 AI 助手不是一個外掛工具條 —— 它直接理解當前頁面的 YAML、DAG、運行狀態，能改 workflow、能觸發執行、能安裝 skill、能切語言。下面是上手與日常用法。

在哪裡打開

• 右下角浮動按鈕（所有主頁面可用）
• 快捷鍵 Alt + G

抽屜內是一個流式對話面板，支持 Markdown / 代碼高亮（12 種語言）和 slash 命令。

可以讓它做什麼

• 創建 / 修改 / 驗證 / 執行 workflow
• 創建、啟用、停用 schedule
• 刷新或安裝 skill
• 切換界面語言
• 回答 "這個系統支持什麼 / 某個配置怎麼寫 / 某個 API 怎麼用" 這類系統性問題

Slash 命令

/execute               # run the current workflow (alias: /run)
/validate              # validate YAML without running
/export                # download workflow YAML
/new                   # start a fresh workflow
/undo                  # roll back the last assistant change (up to 10)
/help                  # list all slash commands

在輸入框裡以 "/" 開頭即可觸發。slash 命令優先度高於自由文字，而且直接呼叫平台介面、不經過模型 —— 不占用 AI 助理的每日配額。在編輯器 / 工作流列表等頁面，輸入框上方還會出現對應的快捷按鈕。

Diff 預覽與撤銷棧

所有對 workflow / schedule / credential 等資源的變更都會先給你 Diff 預覽：

• 新增的步驟 / 字段標綠
• 修改的字段標黃
• 刪除的步驟 / 字段標紅

確認後可隨時用 /undo 回退，最多保留最近 10 步修改。會話本身也可以一鍵導出為 Markdown。

與編輯器的聯動

• 在編輯器裡讓助理搭建 / 修改工作流時，畫布會按操作順序逐步呈現每一處改動：新增節點、連線一步一步出現，你能看著工作流長出來；改動依然要你點儲存才落庫。
• 編輯器的診斷問題面板可以把單條或全部問題「交給 AI 修復」，步驟屬性面板也有入口帶著目前步驟的上下文直接開啟助理 —— 不用自己複製貼上 YAML。
• 助理改的每一步也會進編輯器自己的復原 / 重做歷史，Ctrl / Cmd + Z 可以逐步回退。

編輯器各區域的完整說明見 視覺化編輯器。

準備：配置你的 AI 助手

第一次用之前先去 帳號設定 → AI 助手 開啟並選擇模型 provider（例如 OpenRouter、OpenAI、Anthropic、DeepSeek），或在 Claude Code / Codex 區域配置訂閱模型。真正的 secret 放在 憑證管理 → 我的憑證 維護，運行時會依照目前帳號自動解析。管理員不需要為一般使用者預先配置 AI 助理。

Claude Code / Codex 模型

如果你希望 AI 助手呼叫 Claude Code 或 Codex，請在「帳號設定 → AI 助手 → Claude Code / Codex」裡選擇認證方式：

• Claude Code：可使用 Anthropic API Key，也可使用 Claude 訂閱 Token（provider=claude_code_oauth）。
• Codex：可使用 OpenAI API Key，也可使用 Codex 訂閱 auth.json（provider=codex_subscription）。
• 訂閱模式不會把 token/auth.json 寫入 AI 助理設定；只會從你的個人憑證或團隊憑證讀取。

文檔知識庫

要讓 AI 助手回答系統文檔問題（例如 "manual_approval 的 timeout 默認多少"），去 設置 → 平臺持久化存儲 → AI 助手文檔知識庫 確認它已經啟用。默認會索引內置 guides、項目主文檔和精選 reference docs，並默認啟用啟動時自動構建；同一頁面可以查看狀態並手動點擊 "重建知識庫"。

"思考過程" 流式（Reasoning Streaming）

當所選模型支援 reasoning（Claude Sonnet 4.5 / 4.6 / 4.7、DeepSeek-R1、GPT-o1 / o3 系列、Gemini Thinking 等），AI 助手抽屜會先顯示一個折疊的"AI 助手的思考過程"卡片，模型先把最終推理流到這裡，然後再生成一個推理摘要：

• reasoning_delta 事件被客戶端折疊，不會刷螢幕（避免每個重渲染）
• 完整推理只在 reasoning_complete 時以 thinking 子分類渲染
• 點選思考卡可以展開 / 收起；預設收起，避免佔據視野
• 思考內容也會跟著 /undo 一起被記到撤銷堆疊裡，方便複盤

不支援 reasoning 的模型不會顯示任何額外卡片，行為與先前一致。

長期記憶（Long-Term Memory）

AI 助理預設每個會話獨立。如果你希望它"記住"你的偏好（"我喜歡中文回答 + 簡短 markdown"、"我的 ASA 工作流程總是凌晨跑"），可以在 AI 助手配置裡開啟 Long-Term Memory：

• 開啟後使用者訊息和助理回覆會被向量化存入跨會話的 ltm:<user_id>:* 命名空間
• 下一輪對話開始時，會自動檢索 top-K 相關記憶作為脈絡注入
• AI 助手側邊欄右上角有"清除長期記憶"按鈕，POST /api/global-agent/memory/clear 一鍵清空當前用戶的所有 namespace；適合換設備 / 切團隊時使用

小提示

• 如果你希望 AI 生成 YAML：顯式要求它輸出 snake_case YAML
• 分支流：優先讓它生成 classifier + condition 的結構
• 大段改動：用自然語言描述意圖，然後讓它拆成多步 Diff
• 結合 調試器 ：把 AI 改完的 workflow 先啟用 debug 跑一次 dry-run 再上線
• 選支援 reasoning 的模型時，能直接看到"思考過程"，調試 prompt 設計很有用