n8n 工作流程設計：選擇架構模式

用途

根據業務需求，選出最適合的 n8n 架構模式，並產出節點清單、資料流設計、常見陷阱與部署前檢核清單。

何時用

適合：要在 n8n 建新流程但不確定該用 Webhook / 排程 / API 輪詢 / AI Agent / 事件驅動哪種架構時；業務需求明確但技術選型還沒定的早期設計階段。
不要用：已確定架構只需要寫 Code 節點邏輯，請改用「n8n Code 節點 JavaScript 資料轉換」提示語；或者你只是想把現有流程除錯，請用「n8n 工作流程除錯診斷」版本。

Prompt

text

我要在 n8n 建一個新的自動化流程，請幫我選擇最適合的架構模式。

業務流程需求：
{{業務流程需求——用白話描述：觸發條件是什麼、要做什麼處理、輸出到哪裡}}

請從以下 5 種模式選一，並說明理由：
1. Webhook 觸發（外部系統主動推送）
2. 排程觸發（定時跑，如每天早上 8 點）
3. API 輪詢（n8n 主動去外部查新資料）
4. AI Agent（需要決策、工具呼叫、多輪推理）
5. 事件驅動（監聽 Queue/Email/Webhook stream）

輸出格式：
- 推薦模式 + 選擇理由（3-5 句）
- 節點清單（Trigger → 中間處理節點 → Output 節點，每個節點一行）
- 3 個這種模式的常見陷阱（如 Webhook 要取 $json.body 不是 $json）
- 部署前檢核清單（5 項）

範例 / 變體

填好變數：{{業務流程需求}} 填「每天早上 8 點掃 Gmail 未讀信，分類後推到 Slack，下午 3 點再跑一次」→ AI 會選排程觸發，節點清單從 Schedule Trigger 開始。
變體（多流程比較）：描述 2 個候選需求，讓 AI 各選一個模式並說明差異，適合架構評審或客戶提案時用。
變體（含成本估算）：在輸出格式後加「估算這個流程在 n8n cloud 每月執行次數與費用區間」，幫助客戶做預算決策。

🎯 範例輸出（實測）

在 Claude.ai 跑這句、把 {{業務流程需求}} 填成「每天早上 8 點掃 Gmail 未讀信，分類後推到 Slack，下午 3 點再跑一次」的結果：

點開看 AI 實際輸出

推薦模式：排程觸發（Schedule Trigger）

選擇理由：

需求是「定時跑，不依賴外部推送」，Gmail 輪詢由 n8n 主動發起而非 Gmail 推送事件，因此排程比 Webhook 更合適。每天兩次固定時間點（08:00 / 15:00）用 Schedule Trigger 的 Cron 設定即可，不需要 AI 推理決策，排除 AI Agent 模式。

節點清單

text

Schedule Trigger (cron: 0 8,15 * * *)
→ Gmail Node (search: is:unread newer_than:8h)
→ Code Node (分類邏輯：client / newsletter / bill)
→ IF Node (有新信件？)
  → Slack Node (推送分類摘要到 #inbox)
  → NoOp (無新件，結束)

三個常見陷阱

Cron 時區問題：n8n 預設 UTC，台灣時間 08:00 要設成 0 0 * * *（UTC+8 換算）；建議在 n8n 設定把 Instance timezone 改成 Asia/Taipei
Gmail 搜尋範圍重疊：兩次排程間隔 7 小時，用 newer_than:8h 會有 1 小時重疊，加 -label:processed 過濾已處理信件避免重複推送
Slack 推送格式：用 Block Kit 的 Section + Fields 而非純文字，否則 Slack 訊息沒有換行，分類摘要很難讀

部署前檢核清單

[ ] Gmail OAuth2 Token 已設定且測試連線成功
[ ] Slack Bot 已加入目標頻道並有 chat:write 權限
[ ] Cron 時區確認（n8n Instance Timezone = Asia/Taipei）
[ ] 測試執行用「Test Workflow」驗證單次跑通
[ ] 確認 Gmail 搜尋條件不會抓到已讀信件

💡 實測心得：架構選對比節點設定更重要——把排程任務做成 Webhook 等外部推送，會因為 Gmail 沒有 push 機制而卡關；先把業務需求的「誰主動發起」想清楚，模式選擇就自然收斂了。

延伸

你有沒有遇過這種情況？把一個需要 AI 推理的需求做成排程輪詢，結果每次跑都吃掉大量 API quota，或者反過來把簡單的定時任務硬做成 AI Agent，過度設計。架構選對，後面的開發省很多力氣。

選好架構後，下一步用「n8n 需求描述轉規格文件」把節點清單細化成可交工程師執行的規格書。

n8n 工作流程設計：選擇架構模式 ​

用途 ​

何時用 ​

Prompt ​

範例 / 變體 ​

🎯 範例輸出（實測） ​

推薦模式：排程觸發（Schedule Trigger） ​

節點清單 ​

三個常見陷阱 ​

部署前檢核清單 ​

延伸 ​