AI 助理 · 先讀這篇
AI 助理總覽
它能做哪些事、在哪開啟、怎麼設定模型，以及不花配額的 Slash 指令與頁面快捷動作。
AI 助理不是一個只會寫 YAML 的產生器。它讀得到你目前頁面的上下文 —— 開啟的工作流程、選取的步驟、正在看的那次執行 —— 所以既能幫你搭流程，也能幫你查錯誤、跑任務、改設定。
在哪裡打開
- 右下角的浮動按鈕，所有主要頁面都有；
- 快捷鍵
Alt + G； - 編輯器的診斷面板、步驟屬性面板上的「交給 AI」入口 —— 從這裡進入會自動帶上目前上下文。
它能做的六類事
| 類別 | 舉例 |
|---|---|
| 編排工作流程 | 從零搭一條流程、改現有流程的某一步、依範本起草、加上驗證後儲存。 |
| 排查執行失敗 | 「這次執行為什麼失敗」、「幫我修好再重跑一次」。 |
| 推薦範本與模組 | 描述你的業務目標，讓它先從現成範本與官方模組裡找，而不是硬造。 |
| 排程與站內動作 | 建立定時任務、啟停排程、執行或驗證目前工作流程、取消執行、重新整理技能、切換介面語言。 |
| 導覽與設定 | 「帶我去排程管理」、「這個設定項在哪改」。純導覽請求不走模型，零成本直達。 |
| 回答平台問題 | 某個欄位怎麼寫、某個能力支不支援、某個 API 怎麼呼叫。 |
先做一次設定
第一次使用前先去 帳號設定 → AI 助手 開啟並選擇模型 provider（OpenRouter、OpenAI、Anthropic、DeepSeek 等），也可以在 Claude Code / Codex 區域設定訂閱模型。金鑰本身放在 憑證管理 → 我的憑證，執行時會依目前帳號自動解析 —— 管理員不需要替一般使用者預先設定。
三種執行身分
助理本體可以是站內引擎 Koog，也可以是 Claude Code 或 Codex 命令列 —— 在「帳號設定 → AI 助理」的第一項「助理身分類型」裡切換。外部身分需要對應的訂閱憑證，而且能否在對話裡直接改工作流程取決於部署設定；只想讓它幫你搭流程時，留在 Koog 最省事。
和工作流程裡的 globalAgent 不是一回事
這裡說的 AI 助理用的是你自己帳號的助理設定，屬於「你和平台對話」；工作流程 YAML 頂層的 globalAgent 欄位是那條工作流程執行時自己的 Agent 設定，兩者互不影響。
Slash 指令與快捷動作
輸入框裡以「/」開頭的指令直接呼叫平台介面、不經過模型，因此即時回應，也不消耗 AI 助理配額：
text
/new 新建工作流
/execute 执行当前工作流（别名 /run）
/validate 校验当前工作流
/export 导出当前工作流 YAML
/undo 撤销 AI 对工作流的上一次修改
/help 列出可用命令輸入框上方還會依你所在的頁面給出快捷按鈕：編輯器上是執行 / 驗證 / 匯出 / 復原，執行詳情頁是診斷 / 重試，工作流程清單是新建 / 從範本建立，執行清單是查看最近失敗的執行。
接著看
- 切換助理身分與模型 — 身分怎麼選、模型在哪換、錯誤怎麼解。
- 用它編排工作流程 — Diff 預覽、復原堆疊、畫布連動、範本與模組檢索。
- 排查執行失敗 — 把一次失敗的執行交給它定位、解釋並修復。
- 工作階段、記憶與背景續跑 — 多工作階段管理、長期記憶、關掉視窗任務照跑。