JieGou has evolved.
Since this post was published, JieGou has pivoted from an AI automation platform to an AI-powered operations company delivering managed marketing and operations services. Learn about our managed services →
本指南將引導你完成從 n8n 工作流程遷移到 JieGou 的每個步驟。無論你有 5 個還是 500 個工作流程，流程都相同 — 而且大部分都是自動化的。
預估時間： 典型的 20-50 個工作流程部署需要 1-2 小時。
先決條件
開始之前：
- n8n 存取權限 — 你需要管理員存取權限來匯出工作流程（自架或雲端）
- JieGou 帳戶 — 免費註冊或部署 Docker Compose 入門套件用於氣隙環境
- 整合憑證 — 你的 n8n 工作流程連接的任何服務的 API 金鑰或 OAuth token（Slack、Gmail、GitHub 等）
步驟 1：匯出你的 n8n 工作流程
選項 A：匯出所有工作流程（推薦）
- 開啟你的 n8n 實例
- 前往設定 → 匯出所有工作流程
- 下載 JSON 檔案 — 它包含你實例中的每個工作流程
匯出的檔案看起來像這樣：
[
{
"name": "Lead Enrichment Pipeline",
"nodes": [
{ "name": "Webhook", "type": "n8n-nodes-base.webhook", ... },
{ "name": "HTTP Request", "type": "n8n-nodes-base.httpRequest", ... },
{ "name": "Set", "type": "n8n-nodes-base.set", ... }
],
"connections": { ... }
},
...
]選項 B：匯出個別工作流程
- 開啟你想遷移的工作流程
- 點擊 ⋮ 選單 → 下載
- 儲存 JSON 檔案
你可以一次匯入一個工作流程或批次匯入。
匯出內容
| 包含 | 不包含 | |------|--------| | 工作流程名稱和結構 | 憑證值（API 金鑰、token） | | 節點類型和設定 | 執行歷史 | | 節點間的連接 | 環境變數 | | 標籤和註解 | 自訂節點套件 | | 靜態參數 | |
重要： n8n 基於安全考量從不匯出憑證值。你將在 JieGou 中以 MCP 伺服器連接的方式設定新憑證。
步驟 2：註冊 JieGou
雲端（最快）
- 前往 console.jiegou.ai
- 使用 Google、GitHub 或電子郵件註冊
- 選擇你的部門（匯入工具在任何部門都可使用）
- 你會到達儀表板 — 導航至整合 → 遷移
自架（Docker Compose）
適用於需要資料留在本地的受監管環境：
# 複製入門套件
git clone https://github.com/JieGouAI/self-hosted.git
cd self-hosted
# 設定
cp .env.example .env
# 編輯 .env 填入你的 Firebase 憑證和 LLM API 金鑰
# 啟動
docker compose up -d控制台將在 http://localhost:3000 提供服務。
混合 VPC 部署（企業版）
適用於需要雲端便利性並同時在本地處理資料的團隊：
- 聯繫 sales@jiegou.ai 進行 VPC 代理設定
- 控制平面（控制台、排程、監控）在 JieGou 雲端運行
- 工作流程執行在你的 VPC 內進行 — 資料永不離開你的網路
- 查看我們的混合部署文章了解架構詳情
步驟 3：使用匯入精靈
- 在你的 JieGou 控制台中導航至
/migrations/n8n - 你會看到 n8n 匯入精靈 — 一個三步驟流程
上傳
- 直接將你的 n8n 工作流程 JSON 貼上到文字區域，或
- 使用檔案選擇器上傳
.json檔案
點擊預覽轉換來分析工作流程。
分析過程
匯入工具：
- 解析 n8n 工作流程 JSON（驗證結構、提取節點和連接）
- 對應每個 n8n 節點類型到最接近的 JieGou 步驟類型
- 偵測觸發節點（webhook、排程、手動觸發）並轉換為工作流程輸入
- 識別整合節點並建議匹配的 MCP 伺服器
- 建構連接圖（保留執行順序和分支邏輯）
- 生成轉換報告，標註需要手動處理的項目
步驟 4：審查和調整對應
分析完成後，你會看到詳細的轉換報告。
摘要卡片
報告頂部顯示四個指標：
- 總節點數 — 工作流程中有多少 n8n 節點
- 已對應 — 完全轉換為 JieGou 步驟類型的節點
- 已跳過 — 不需要轉換的節點（例如 NoOp、StickyNote）
- 警告 — 需要你注意的項目
節點對應表
每個 n8n 節點都顯示其轉換狀態：
| 狀態 | 含義 | 需要操作 | |------|------|----------| | 已對應 | 完全轉換為 JieGou 步驟 | 無 — 確認步驟看起來正確 | | 部分 | 已轉換但某些參數需要手動審查 | 檢查步驟設定 | | 手動 | 無法自動轉換 | 手動建構等效步驟 | | 已跳過 | 節點類型不需要轉換 | 無 |
n8n 節點如何對應到 JieGou 步驟
| n8n 節點 | JieGou 步驟 | 說明 |
|----------|-------------|------|
| Set / Code / Function | LLM 步驟 | AI 執行轉換而非程式碼 |
| IF / Switch / Filter | 條件步驟 | 直接對應 — 相同分支邏輯 |
| SplitInBatches | 迴圈步驟 | 直接對應 — 迭代陣列輸入 |
| Merge / Aggregate | 聚合器步驟 | 合併平行分支的輸出 |
| HTTP Request | LLM 步驟 + MCP 工具 | 使用 HTTP MCP 伺服器進行 API 呼叫 |
| Slack / Gmail / GitHub | LLM 步驟 + MCP 伺服器 | 使用匹配的 MCP 伺服器整合 |
| Webhook（觸發） | 工作流程輸入 | 成為工作流程的輸入架構 |
| Schedule Trigger | 排程 | 在 JieGou 排程中另行設定 |
| OpenAI / LangChain Agent | LLM 步驟 | 多供應商 BYOK — 自帶金鑰 |
| Postgres / MySQL | LLM 步驟 + MCP 伺服器 | 使用資料庫 MCP 伺服器 |
| Google Sheets | LLM 步驟 + MCP 伺服器 | 使用 Google Sheets MCP 伺服器 |
理解警告
警告分為三類：
- 🔴 錯誤 — 無法自動轉換。例如：「自訂函式節點使用了 JieGou 中不可用的 npm 套件」
- 🟡 警告 — 轉換成功但需要驗證。例如：「偵測到 Slack 節點 — 請設定 Slack MCP 伺服器以使用此整合」
- 🔵 資訊 — 有用的背景。例如：「Webhook 觸發已轉換為工作流程輸入架構」
常見警告及解決方法：
| 警告 | 解決方法 |
|------|----------|
| 「設定 [X] MCP 伺服器」 | 前往整合 → 市集，安裝 MCP 伺服器並連接你的憑證 |
| 「複雜表達式可能需要調整」 | 審查步驟的提示/設定 — n8n 表達式如 {{$json.field}} 已轉換為輸入對應 |
| 「自訂程式碼節點」 | 審查生成的 LLM 提示 — 它描述了程式碼的功能，LLM 將執行相同任務 |
| 「不支援的節點類型」 | 手動建構等效步驟或檢查是否有 MCP 伺服器提供該功能 |
步驟 5：設定你的 MCP 伺服器
MCP（模型上下文協定）伺服器取代 n8n 的內建整合節點。每個 MCP 伺服器提供 LLM 步驟可使用的工具。
安裝 MCP 伺服器
- 前往整合 → 市集
- 搜尋你需要的整合（例如「Slack」、「GitHub」、「PostgreSQL」）
- 點擊安裝將其新增到你的帳戶
- 使用你的 API 金鑰或 OAuth 憑證連接
將 n8n 憑證對應到 MCP 伺服器
| n8n 憑證 | JieGou MCP 伺服器 | 連接方法 | |----------|-------------------|----------| | Slack OAuth | Slack MCP 伺服器 | OAuth 2.0（透過 Klavis） | | Gmail API | Gmail MCP 伺服器 | OAuth 2.0（透過 Klavis） | | GitHub Token | GitHub MCP 伺服器 | 個人存取 Token | | Postgres 連接 | PostgreSQL MCP 伺服器 | 連接字串 | | HTTP Header 驗證 | HTTP MCP 伺服器 | API 金鑰 / Bearer token | | OpenAI API 金鑰 | 帳戶 BYOK 設定 | 金鑰保管庫中的 API 金鑰 | | AWS 憑證 | AWS MCP 伺服器 | 存取金鑰 + 密鑰 | | Google Sheets OAuth | Google Sheets MCP 伺服器 | 服務帳戶或 OAuth |
驗證工具存取
安裝 MCP 伺服器後：
- 開啟匯入的工作流程
- 檢查每個使用 MCP 工具的 LLM 步驟
- 確認選擇了正確的 MCP 伺服器
- 透過快速手動運行測試連接
步驟 6：用效能比拼測試
上線之前，並排運行你的 n8n 工作流程和 JieGou 工作流程以比較輸出品質。
建立效能比拼
- 前往效能比拼 → 新增效能比拼
- 選擇工作流程對比工作流程模式
- 將你的 JieGou 工作流程新增為 A 組
- B 組有兩個選項：
- 分別運行你的 n8n 工作流程並貼上輸出
- 建立另一個具有不同 LLM 設定的 JieGou 工作流程變體
生成測試輸入
- 點擊生成輸入 — JieGou 建立匹配你工作流程輸入架構的合成測試資料
- 或從你的 n8n 執行歷史提供真實輸入
- 我們建議 5-10 個多樣化輸入以進行有意義的比較
審查結果
效能比拼在每個輸入上運行兩組並提供：
- LLM 評審評估 — AI 評估者對每個輸出的準確性、完整性和相關性進行評分
- 統計信心度 — 標準差和 95% 信賴區間
- 並排比較 — 並排查看輸出以進行手動審查
注意事項
- 輸出格式 — JieGou 工作流程是否以你下游系統預期的格式產生輸出？
- 資料完整性 — 所有欄位都已填充嗎？有遺漏的資訊嗎？
- 邊界情況 — 兩者如何處理空輸入、大型負載或不尋常的資料？
- 錯誤處理 — API 呼叫失敗時會發生什麼？
步驟 7：上線
一旦你對轉換有信心：
逐步切換
- 從低風險工作流程開始 — 內部通知、報告生成、資料同步
- 監控 48 小時 — 在 JieGou 的運行歷史中檢查執行日誌
- 遷移關鍵工作流程 — 面向客戶的整合、支付處理、資料管線
- 停用 n8n — 一旦所有工作流程都已驗證，關閉你的 n8n 實例
設定排程
如果你的 n8n 工作流程使用了排程觸發：
- 前往自動化 → 排程
- 為每個工作流程建立新排程
- 設定 cron 表達式（JieGou 支援與 n8n 相同的 cron 語法）
- 設定時區和輸入參數
設定 webhook 觸發
如果你的 n8n 工作流程使用了 webhook 觸發：
- 前往自動化 → 觸發器
- 建立新的 webhook 觸發
- 複製新的 webhook URL
- 在你的上游系統（例如 Stripe、GitHub、Slack）中更新 webhook URL
啟用監控
- 執行警報 — 設定失敗運行的通知
- 稽核日誌 — 所有工作流程執行都自動記錄 30 種操作類型
- SOC 2 證據 — 從合規儀表板匯出合規證據
疑難排解
上傳時出現「無效 JSON」錯誤
- 驗證檔案是有效的 JSON（嘗試貼上到 jsonlint.com）
- 如果你匯出了多個工作流程，檔案是 JSON 陣列 — 匯入工具處理單一工作流程和陣列
- 檢查 BOM 字元或編碼問題（儲存為 UTF-8）
節點標記為「需要手動」
這表示匯入工具無法自動轉換此節點類型。常見情況：
- 自訂函式節點具有複雜的 npm 依賴 → 將邏輯改寫為 LLM 提示或使用 HTTP MCP 伺服器呼叫外部 API
- FTP / SFTP 節點 → 使用檔案系統 MCP 伺服器或基於 HTTP 的檔案傳輸服務
- XML 節點 → LLM 步驟原生處理 XML 解析 — 在提示中描述轉換
匯入後工作流程執行失敗
- 檢查運行詳情頁面的具體錯誤
- 常見原因：
- MCP 伺服器未設定（從市集安裝）
- 輸入架構不匹配（檢查工作流程的輸入設定）
- LLM 供應商缺少 BYOK 金鑰（在帳戶設定 → API 金鑰中新增）
效能差異
JieGou 工作流程是 AI 原生的 — 而非在 VM 中執行程式碼，它們使用 LLM 步驟來執行轉換。這意味著：
- 延遲可能較高 — 對於簡單的資料轉換（LLM 呼叫 vs. 記憶體內程式碼）
- 品質可能較高 — 對於非結構化資料處理（LLM 理解 vs. 正規表達式/程式碼）
- 維護更低 — API 變更時無需除錯程式碼
如果延遲很關鍵，使用條件步驟跳過確定性操作的 LLM 呼叫，並將 LLM 步驟保留給受益於 AI 的任務。
遷移檢查清單
使用此檢查清單追蹤你的遷移進度：
- [ ] 將所有 n8n 工作流程匯出為 JSON
- [ ] 建立 JieGou 帳戶（雲端、自架或混合）
- [ ] 上傳工作流程到匯入精靈
- [ ] 審查每個工作流程的轉換報告
- [ ] 從市集安裝所需的 MCP 伺服器
- [ ] 設定 MCP 伺服器憑證
- [ ] 為關鍵工作流程運行效能比拼
- [ ] 為 cron 觸發的工作流程設定排程
- [ ] 在上游系統中更新 webhook URL
- [ ] 監控執行 48 小時
- [ ] 停用 n8n 實例
- [ ] 匯出 SOC 2 證據作為稽核軌跡
需要幫助？
- 匯入工具： console.jiegou.ai/migrations/n8n
- MCP 市集： console.jiegou.ai/integrations/marketplace
- 社群： community.jiegou.ai
- 企業支援： sales@jiegou.ai
- 安全詳情： 為什麼我們選擇混合部署