適用於誰
- 搜「釦子工作流怎麼搭建」「釦子怎麼創建工作流」「釦子工作流入口」「coze工作流在哪」「釦子工作流教學」的人;
- 想把「搜資料 → 整理 → 生成文案」這類固定流程做成一鍵運行的人;
- 工作流跑到一半超時、代碼節點報錯,想知道官方限制的人。
本文根據釦子官方文檔(docs.coze.cn)整理,資料核對於 2026-10-11。登入後的畫布介面沒有逐屏核對,按鈕名稱來自官方文檔,以實際介面為準。
結論先說
- 入口有兩個:新用戶在釦子編程(code.coze.cn)首頁點「工作流」,用文字描述讓 AI 生成;老用戶在舊版低代碼的「資源庫」裏新建,自己拖節點。官方文檔寫明低代碼平台不再向新註冊用戶開放。
- 每個工作流都從開始節點進、從結束節點出,中間的節點靠「引用上游節點的輸出」連成鏈。
- 最常用的三個節點:大模型(寫、改、判斷)、代碼(算、拆、拼)、選擇器(if-else 分支)。
- 提示詞裏引用變量的寫法是
{{變量名}},對象和數組可以寫成{{變量名.子變量名}}、{{變量名[數組索引]}}。 - 官方限制要記住幾條:同步運行整體超時 10 分鐘;每個工作流最多 1000 個節點、50 個代碼節點;代碼節點單次最長 60 秒。
步驟
1. 新用戶:在釦子編程裏生成工作流
- 打開 code.coze.cn 並登入,首頁輸入框上方點「工作流」;
- 寫需求,盡量把功能、業務邏輯和輸入輸出說清楚;
- 可選:上載附件、選協作模式(預設 Agent 模式,需求不明確時先用問答模式討論)、添加技能、選編程模型;
- 點運行。AI 會寫出工作流的完整代碼,自動生成測試用例並測試,通過後把整體結構和節點關係畫在畫布上。
需求可以這樣寫:
做一個「競品動態週報」工作流。
輸入:競品名稱列表(數組)、時間範圍(預設最近 7 天)。
流程:對每個競品聯網搜尋新聞 → 去重並過濾廣告軟文 →
按「產品更新 / 融資與合作 / 負面輿情」分類 → 每類寫不超過 3 條摘要並附來源連結。
輸出:一份 Markdown 週報;某個競品沒有新聞時寫「本週無動態」,不要編造。
生成之後怎麼看、怎麼改:
- 看懂它:點畫布上的節點查看輸入、輸出和配置;框選幾個節點點「解釋」,會得到節點說明、執行邏輯和出錯時的降級策略;
- 用嘴改:在對話框直接說要改什麼;或框選節點點「引用」,再輸入修改指令;
- 手動改:在畫布上點加號新增動作、條件或並發節點,然後點右上角「發送並執行變更」。官方提示手動編排本身不會直接更新代碼,要發送之後才生效;
- 改代碼:點「文件樹」進入代碼編輯器,改完切回預覽刷新畫布;
- 試運行:點「試運行」,填好參數後再點一次。運行時能看到進度、每個節點的耗時和輸入輸出;
- 出錯:點「一鍵修復」,或把報錯貼進對話。反覆修不好就回滾到之前正常的版本。
確認無誤後點右上角「部署」,工作流會變成一個可調用的 API 服務。
2. 老用戶:在舊版低代碼裏新建
- 登入釦子開發平台(或在釦子編程首頁右上角「回到舊版」),選好工作空間;
- 左側進入「資源庫」,右上角點「+資源」選「工作流」;
- 填名稱和描述後確認。官方提醒名稱和描述要清晰,因為大模型靠它們理解這個工作流是幹什麼的;
- 進入編輯頁,畫布上預設已有「開始」和「結束」兩個節點;
- 從底部面板添加節點,按執行順序連線,逐個配置輸入和輸出。
先分清兩種類型:工作流處理功能型請求,按順序執行節點,適合生成報告、海報這類自動化任務;對話流基於對話場景,適合客服、助手這類一問一答的應用。
3. 配置開始、結束和變量
- 開始節點:定義啟動工作流需要的輸入參數,比如
topic(主題)、word_count(字數); - 結束節點:定義返回什麼結果;
- 連接方式:下游節點的輸入「引用」上游節點的輸出,畫布上兩者就連起來了;
- 變量類型:官方列出 String、Integer、Number、Boolean、Object、File、Array,節點之間不需要額外轉換。
4. 三個核心節點怎麼配
大模型節點
- 選模型,可調整模型配置;
- 輸入參數:給參數起名,值可以是固定值,也可以引用上游輸出;
- 系統提示詞寫人設和風格,用戶提示詞寫本次任務,兩處都用
{{變量名}}引用輸入參數; - 輸出格式有文本、Markdown、JSON 三種。後面要接代碼節點或選擇器時選 JSON,可以導入一段樣例自動生成結構;
- 技能:可以給這個節點加插件、工作流或知識庫,由模型自己判斷何時調用;
- 超時與異常:整體超時預設 180 秒,可設到 600 秒;預設不重試,可設為重試 1 次並指定備選模型;出錯時可以選擇中斷流程、返回預設內容或走異常分支。
一個用戶提示詞的例子:
請根據以下資料寫一段不超過 {{word_count}} 字的摘要,面向 {{audience}}:
{{search_result}}
只使用資料裏的資訊,不要補充。
代碼節點
- 支持 JavaScript 和 Python;
- 輸入通過
params讀取,結果必須return一個對象,對象裏的字段名和類型要和節點配置的輸出參數完全一致——哪怕只有一個值也要包成對象; - 可用的第三方庫很少:JavaScript 內置 dayjs 和 lodash,Python 內置 requests_async 和 numpy,引入其他依賴不會生效;
- 單次執行最長 60 秒;Python 環境不支持多進程、多線程等模組。
官方給出的 Python 入口形式如下,函數體是本文的示例:
python
async def main(args: Args) -> Output:
text = args.params['text']
lines = [s.strip() for s in text.split('\n') if s.strip()]
return {"lines": lines, "count": len(lines)}
選擇器節點
就是 if-else:滿足「如果」裏的條件走對應分支,否則走「否則」分支。一個分支裏可以加多個條件並用「且」「或」組合;可以加多個分支,拖動調整優先級,按順序逐個判斷,都不成立才走「否則」。
其餘常見節點按官方文檔的分類有:插件、子工作流、循環、批處理、變量與變量聚合、意圖識別、問答、知識庫寫入與檢索、數據庫的增刪改查、圖像生成、影片生成等。
5. 試運行和發佈(舊版)
- 點「試運行」,按提示填輸入。有圖片、影片這類文件參數時,可以上載文件或填文件 URL;
- 運行成功的節點邊框會變綠,點節點右上角能看到這次的輸入和輸出,據此定位問題;
- 沒問題後點「發佈」,可以選一個儲存過的測試集作為預設測試集,同空間的其他人就能用它試跑。
6. 在智能體裏用上工作流
- 進入智能體編排頁,在「工作流」區域點加號;
- 在「添加工作流」對話框裏從「我創建的」中選擇;
- 在「人設與回覆邏輯」裏寫明什麼情況下調用,並引用工作流的名稱。
如果工作流跑得久,在智能體的工作流設定裏可以開「異步運行」並填一句回覆內容:預設同步運行,超過約 10 分鐘對話可能超時;開啟後超時時間延長到 24 小時。官方同時說明異步運行只在調試和商店對話時生效,飛書等渠道暫不支持。
常見問題
Q:新註冊帳號找不到拖拽式的工作流畫布?
官方文檔寫明釦子開發平台(低代碼)不再向新註冊用戶開放。新用戶用釦子編程的「工作流」入口,生成後同樣能在畫布上看到節點結構。
Q:工作流有哪些硬限制?
按官方的使用限制文檔:同步運行整體 10 分鐘、異步 24 小時;每個工作流最多 1000 個節點,一次運行最多執行 1000 個節點(循環次數和子工作流裏的節點都算);代碼節點最多 50 個;節點輸入、輸出上限各 10MB,代碼節點和插件節點的入參上限 2MB。
Q:單個節點超時怎麼辦?
大模型和插件節點預設 3 分鐘、最長可設 10 分鐘;HTTP 節點預設 2 分鐘;代碼、數據庫、意圖識別節點是 1 分鐘。官方建議沒開異步時把整體執行時間控制在 5 分鐘內。超時了優先拆任務:把一次生成很長的內容拆成幾步。
Q:代碼節點想 import 別的庫?
舊版低代碼的代碼節點只能用內置的那幾個庫。需要更多依賴時,釦子編程生成的工作流是完整代碼項目,自帶代碼編輯器和 Web 終端,更適合這種需求。
Q:運行失敗還會扣費嗎?
官方文檔寫明:工作流整體失敗時,已經成功運行的付費節點仍會計費。調試階段先用短輸入試。
Q:做好的工作流怎麼給別人用?
掛到智能體上再發布,渠道和審核見《釦子智能體怎麼發佈》;智能體本身怎麼建見《釦子怎麼創建智能體》。
參考資料
- 釦子文檔:開發工作流(釦子編程) — https://docs.coze.cn/guides_ai_powered_workflow_development
- 釦子文檔:低代碼工作流介紹 — https://docs.coze.cn/guides_workflow
- 釦子文檔:使用低代碼工作流 — https://docs.coze.cn/guides_use_workflow
- 釦子文檔:低代碼工作流使用限制 — https://docs.coze.cn/guides_workflow_limits
- 釦子文檔:大模型節點 — https://docs.coze.cn/guides_llm_node
- 釦子文檔:代碼節點 — https://docs.coze.cn/guides_code_node
- 釦子文檔:選擇器節點 — https://docs.coze.cn/guides_condition_node
0 條評論
還沒有評論,來搶沙發~