釦子工作流怎麼搭建:入口在哪、節點類型、變量引用、試運行與發佈

釦子工作流怎麼搭建、入口在哪?本文按扣子官方文檔講清兩種做法:新用戶在釦子編程裏用一段話生成工作流,老用戶在舊版低代碼畫布上拖節點;並說明大模型、代碼、選擇器節點的配置要點、變量引用寫法、試運行和官方限制。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-10-11 · 依據官方文檔與公開資料整理 免費帳號 帳號

適用於誰

  • 搜「釦子工作流怎麼搭建」「釦子怎麼創建工作流」「釦子工作流入口」「coze工作流在哪」「釦子工作流教學」的人;
  • 想把「搜資料 → 整理 → 生成文案」這類固定流程做成一鍵運行的人;
  • 工作流跑到一半超時、代碼節點報錯,想知道官方限制的人。

本文根據釦子官方文檔(docs.coze.cn)整理,資料核對於 2026-10-11。登入後的畫布介面沒有逐屏核對,按鈕名稱來自官方文檔,以實際介面為準。

結論先說

  1. 入口有兩個:新用戶在釦子編程(code.coze.cn)首頁點「工作流」,用文字描述讓 AI 生成;老用戶在舊版低代碼的「資源庫」裏新建,自己拖節點。官方文檔寫明低代碼平台不再向新註冊用戶開放。
  2. 每個工作流都從開始節點進、從結束節點出,中間的節點靠「引用上游節點的輸出」連成鏈。
  3. 最常用的三個節點:大模型(寫、改、判斷)、代碼(算、拆、拼)、選擇器(if-else 分支)。
  4. 提示詞裏引用變量的寫法是 {{變量名}},對象和數組可以寫成 {{變量名.子變量名}}、{{變量名[數組索引]}}。
  5. 官方限制要記住幾條:同步運行整體超時 10 分鐘;每個工作流最多 1000 個節點、50 個代碼節點;代碼節點單次最長 60 秒。

步驟

1. 新用戶:在釦子編程裏生成工作流

  1. 打開 code.coze.cn 並登入,首頁輸入框上方點「工作流」;
  2. 寫需求,盡量把功能、業務邏輯和輸入輸出說清楚;
  3. 可選:上載附件、選協作模式(預設 Agent 模式,需求不明確時先用問答模式討論)、添加技能、選編程模型;
  4. 點運行。AI 會寫出工作流的完整代碼,自動生成測試用例並測試,通過後把整體結構和節點關係畫在畫布上。

需求可以這樣寫:

做一個「競品動態週報」工作流。
輸入:競品名稱列表(數組)、時間範圍(預設最近 7 天)。
流程:對每個競品聯網搜尋新聞 → 去重並過濾廣告軟文 → 
按「產品更新 / 融資與合作 / 負面輿情」分類 → 每類寫不超過 3 條摘要並附來源連結。
輸出:一份 Markdown 週報;某個競品沒有新聞時寫「本週無動態」,不要編造。

生成之後怎麼看、怎麼改:

  • 看懂它:點畫布上的節點查看輸入、輸出和配置;框選幾個節點點「解釋」,會得到節點說明、執行邏輯和出錯時的降級策略;
  • 用嘴改:在對話框直接說要改什麼;或框選節點點「引用」,再輸入修改指令;
  • 手動改:在畫布上點加號新增動作、條件或並發節點,然後點右上角「發送並執行變更」。官方提示手動編排本身不會直接更新代碼,要發送之後才生效;
  • 改代碼:點「文件樹」進入代碼編輯器,改完切回預覽刷新畫布;
  • 試運行:點「試運行」,填好參數後再點一次。運行時能看到進度、每個節點的耗時和輸入輸出;
  • 出錯:點「一鍵修復」,或把報錯貼進對話。反覆修不好就回滾到之前正常的版本。

確認無誤後點右上角「部署」,工作流會變成一個可調用的 API 服務。

2. 老用戶:在舊版低代碼裏新建

  1. 登入釦子開發平台(或在釦子編程首頁右上角「回到舊版」),選好工作空間;
  2. 左側進入「資源庫」,右上角點「+資源」選「工作流」;
  3. 填名稱和描述後確認。官方提醒名稱和描述要清晰,因為大模型靠它們理解這個工作流是幹什麼的;
  4. 進入編輯頁,畫布上預設已有「開始」和「結束」兩個節點;
  5. 從底部面板添加節點,按執行順序連線,逐個配置輸入和輸出。

先分清兩種類型:工作流處理功能型請求,按順序執行節點,適合生成報告、海報這類自動化任務;對話流基於對話場景,適合客服、助手這類一問一答的應用。

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. 試運行和發佈(舊版)

  1. 點「試運行」,按提示填輸入。有圖片、影片這類文件參數時,可以上載文件或填文件 URL;
  2. 運行成功的節點邊框會變綠,點節點右上角能看到這次的輸入和輸出,據此定位問題;
  3. 沒問題後點「發佈」,可以選一個儲存過的測試集作為預設測試集,同空間的其他人就能用它試跑。

6. 在智能體裏用上工作流

  1. 進入智能體編排頁,在「工作流」區域點加號;
  2. 在「添加工作流」對話框裏從「我創建的」中選擇;
  3. 在「人設與回覆邏輯」裏寫明什麼情況下調用,並引用工作流的名稱。

如果工作流跑得久,在智能體的工作流設定裏可以開「異步運行」並填一句回覆內容:預設同步運行,超過約 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
需要開通或續費?AI 會員充值與全部商品 →

Nathaniel 的更多內容

  1. 01

    AI 學習路線:零基礎從哪開始,6 個階段、每階段該讀哪幾篇教學(2026)

    AI 學習路線怎麼走?給零基礎的人一條循序漸進的路徑:先選一個助手用順,再學提問,再用進日常工作,按需學做圖做影片,守住私隱與版權,最後進階自動化和編程。每個階段都配了本站對應的教學。

    其他 AI 工具0
  2. 02

    AI 瀏覽器有哪些:Perplexity Comet、Opera Neon、Dia、Brave Leo 與 Edge Copilot 的官方說法對照

    AI 瀏覽器有哪些?按官方頁面整理 Perplexity Comet、Opera Neon、Dia、Brave Leo 和 Edge 裏的 Copilot:官方自述的定位、支持的平台、免費還是訂閱,以及 Gemini、Claude 的 Chrome 方案和已停用的 ChatGPT Atlas。

    其他 AI 工具0
  3. 03

    即夢國際版 Dreamina 是什麼:官方站入口、能生成什麼、免費積分和模型(2026)

    即夢國際版 Dreamina 是什麼?官方站是 dreamina.capcut.com,是一個圖片、影片和數字人一體的 AI 創作平台。按官方首頁和 FAQ 講:能生成什麼、免費用戶每天 120 積分、列出的 Seedance 與 Seedream 模型,以及和國內即夢怎麼區分。

    其他 AI 工具0
  4. 04

    Kimi K3 Coding Plan 是什麼、怎麼用:Kimi Code 會員、模型 ID、套餐價格和額度規則

    Kimi K3 Coding Plan 是什麼?按 Kimi 官方文檔核對:官方現在叫 Kimi Code,是 Kimi 會員權益裏的編程服務,Plus 及以上才有;講 K3 等模型 ID、國內新套餐價格、三種客戶端、第三方工具接入和額度規則。

    Kimi0
  5. 05

    DeepSeek V4 Pro 和 Flash 的區別與 API 價格:官方價格頁逐項對照(高峰與空閒時段)

    DeepSeek V4 Pro 和 Flash 有什麼區別、API 怎麼收費?按 DeepSeek 官方價格頁(2026-10-19 查詢)列出兩個模型的版本、上下文、圖像理解、並發和每百萬 token 價格,說明高峰與空閒時段的計費差別和舊模型名怎麼處理。

    其他 AI 工具0
  6. 06

    GPT-6 Pro(Astra)怎麼用、哪些套餐有:怎麼選到 Pro 檔、用量限制和 Pro 三檔價格

    GPT-6 Pro(Astra)怎麼用、哪些套餐有?按 OpenAI 幫助中心核對:聊天裏 Pro 檔給 Pro 100、Pro 200、Business 和 Enterprise;Plus 在 Work 和 Codex 裏含 Astra。講怎麼選到、用量上限和官方 Pro 價格。

    ChatGPT0

同產品的其他教學

  1. 01

    AI圖片放大與高清修復:Midjourney、ChatGPT、Gemini 怎麼出高解像度圖

    AI 生成的圖不夠清晰,想打印或做大圖怎麼辦?本文按官方文檔講清 Midjourney 的 Subtle / Creative 放大和 HD 直出、Gemini 與 ChatGPT 的解像度選項、Flow 的影片放大,以及「AI 放大會編造細節」的注意事項。

    Gemini其他 AI 工具0
  2. 02

    AI影片運鏡提示詞大全:推拉搖移跟升降、環繞、甩鏡怎麼寫(中英對照)

    AI 影片的運鏡提示詞怎麼寫?本文按 Google 官方影片提示指南整理鏡頭運動、機位角度、鏡頭光學效果三張中英對照表,每個術語配效果說明和例句,並給出組合運鏡的寫法和常見翻車原因,適用於 Veo、即夢、可靈等工具。

    Gemini其他 AI 工具0
  3. 03

    AI 影片翻譯怎麼做:用 ElevenLabs 給影片自動配音翻譯、轉寫並生成字幕

    想把一段影片翻譯成另一種語言並保留原聲音色?本文按 ElevenLabs 官方文檔講清 Dubbing 自動配音翻譯的操作步驟、文件限制、免費檔水印與計費方式,以及用 Speech to Text 轉寫、在字幕編輯器裏調整並導出字幕的流程。

    其他 AI 工具0
  4. 04

    MCP Inspector 怎麼用:安裝、啟動命令、調試 MCP 伺服器與 v2 的變化

    MCP Inspector 是什麼、怎麼安裝和使用?按 MCP 官方文檔講清網頁、命令行、終端介面三種模式的啟動命令,怎麼連本地和遠程伺服器、怎麼傳環境變量,密鑰存在哪,以及 v2 相比舊教學在端口、令牌變量名和 Node 版本上的變化。

    Claude其他 AI 工具0
  5. 05

    MCP 的 stdio、SSE 和 Streamable HTTP 有什麼區別:本地與遠程 MCP 怎麼選

    MCP 配置裏的 stdio、sse、http 到底差在哪?按 MCP 官方規範講清兩種標準傳輸方式的工作原理、Streamable HTTP 與舊的 HTTP+SSE 的關係、會話與斷線續傳、規範對安全的硬性要求,以及本地伺服器和遠程伺服器各適合什麼場景。

    Claude其他 AI 工具0
  6. 06

    Midjourney 可以商用嗎:作品歸屬、商用條件與隱身模式

    Midjourney 生成的圖片和影片能不能商用、版權歸誰、公司用要什麼套餐、作品會不會被別人看到?本文按 Midjourney 服務條款逐條解釋,並補充中美對 AI 生成圖片版權的官方 / 司法觀點。

    其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~