專案 Bloss0m Note 000 ENGINEERING CASE STUDY · AGENT PLATFORM
工程案例
用單一 LINE 入口承接多種 AI 任務，再以語意路由與模組化工作流分派到 19 個可獨立維護的子流程。
問題與限制
問題
RAG、事實查證、新聞、圖像和網頁任務若全部塞在同一 Bot 流程，會快速形成高耦合、難觀測、難測試的巨大工作流。
限制
- 使用者只看到一個 LINE 對話入口，系統必須自行判斷任務類型。
- 19 個子流程使用不同 API、資料源與回傳格式，不能互相拖累。
- 新能力需要能獨立新增、替換與停用，不改動 LINE 主流程。
- 所有結果最終都要符合 LINE 訊息限制與一致的回覆格式。
架構與技術決策
系統流程
- 01 對話入口 LINE Webhook · message context
- 02 意圖路由 Gemini intent analysis · task contract
- 03 主工作流 n8n orchestration · error boundary · dispatch
- 04 19 個能力模組 RAG · FACT · NEWS · IMAGE · WEB · data tools
- 05 回覆正規化 result adapter · message formatting · LINE Reply API
技術選型
n8n
讓路由、外部 API、錯誤分支與資料轉換保持可視化，也方便把能力拆成可替換子流程。
Gemini intent routing
相較關鍵字規則，更能處理自然語言中混合或不完整的任務描述。
主流程 + 子流程
主流程只負責入口、路由與回覆契約，能力模組可獨立開發與維護。
LINE Messaging API
以真實對話通路驗證 Agent 平台，而不是只停留在後台流程 Demo。
我的具體責任
- 01
設計主流程、意圖分類、子流程 dispatch 與統一回覆 contract。
- 02
整合 RAG、事實查證、新聞、圖片、爬蟲與資料查詢等 19 個模組。
- 03
處理 LINE Webhook、訊息格式、API token 與各服務錯誤邊界。
- 04
整理可公開匯入的 n8n workflow 與分層教學文件。
評測方式與成果
以能力矩陣逐項驗證路由是否進入正確子流程，並檢查每個模組在成功、空結果與外部 API 失敗時，都能回到統一的 LINE 回覆契約。
失敗與修正
- 失敗現象
- 早期能力直接串在同一工作流，新增節點後理解與除錯成本快速上升。
- 修正方式
- 把入口、意圖路由與能力執行拆成主流程和獨立子流程。
- 工程教訓
- Agent 平台的擴展性來自模組邊界，不是節點數量。
- 失敗現象
- 只使用關鍵字分流時，複合問句與模糊描述容易走錯能力。
- 修正方式
- 使用 Gemini 產生受限意圖結果，再由 n8n 做確定性 dispatch。
- 工程教訓
- 模型適合處理語意，工作流適合執行受控決策。
- 失敗現象
- 不同模組各自回傳文字、圖片或錯誤，LINE 端處理分支持續膨脹。
- 修正方式
- 加入 result adapter 與統一回覆 contract。
- 工程教訓
- 工具可以異質，但平台邊界必須一致。
證據與延伸資料
Deep dive · 深入實作
技術實作細節
接續案例摘要，深入查看工作流、實作決策、架構圖與專案產出。Context（情境）
LINE 作為企業對外或內部溝通管道時，使用者會提出技術問題、新聞查詢、圖片生成等多元需求。情境需要單一入口接收訊息後，依內容類型自動分流至對應能力（RAG、事實查證、新聞、圖像、爬蟲等），並將回覆格式化送回 LINE。
Challenge（痛點）
- 若每種需求各建一個 Bot，維護與體驗分散；若單一流程處理所有類型，邏輯龐大難以擴充。
- 需以 AI 辨識意圖並路由至正確子流程，且回覆需符合 LINE 顯示（長文分段最多 5 則等）。
Solution（架構＋做法）
提供一個智慧化 LINE 自動回覆機器人：使用者傳送訊息後，由 Google Gemini 分析內容類型，並智能路由到對應的子流程處理，涵蓋技術文件摘要、事實查證、RAG 知識檢索、新聞與股票、圖像生成、網頁爬取等，最後將回覆格式化並送回 LINE（支援長文自動分段，最多 5 則）。
架構概覽
主流程 [MAIN] LINE CHATBOT：接收 LINE Webhook → 呼叫 Gemini 分析訊息 → 依內容類型路由至子流程 → 彙整 AI 回應 → 分段發送回 LINE。
19 個子流程模組 分為：AI 代理（1399 RAG、MCP RAG、RAG Pipeline、ITR、FACT、CB、DR）、資訊處理（NEWS、News Agent Scrape、STOCK）、圖像處理（IMAGE Generator、Food Image、Image Editing、Image Module）、網頁處理（WEB、LINE CHATBOT Crawl）、工具（SUBS Module、Database Query Tool），以及 FACT linebot 工作流。
LINE Webhook → [MAIN] LINE CHATBOT (Gemini 分析) → 子流程路由
→ RAG / FACT / NEWS / IMAGE / WEB / … (19 子流程)
→ 回應格式化與分段 → LINE Reply API技術內容處理
- 技術相關：辨識技術文件、會議記錄、專業討論；可搭配網址爬取（HTTP Request / Jina AI）、YouTube 逐字稿；輸出可選「標準模板」或「詳細報告」，繁體中文、500 字以內、適配 LINE 顯示。
- 非技術內容：走個性化對話與對應子流程（如 FACT、NEWS、IMAGE 等）。
- 安全：API tokens 以環境變數管理，不硬編碼；Git 歷史已清理敏感資訊。
工作流示意（可搭配 n8n 課程流程圖）
以下為 n8n 工作流層級概念示意；實際主流程與子流程圖可於 GitHub 展示站 查看。
n8n 工作流 Level 1
n8n 工作流 Level 2 範例 1
n8n 工作流 Level 2 範例 2
技術棧與亮點
- n8n — 可視化工作流設計與執行
- Google Gemini — 訊息分析與回應生成
- LINE Messaging API — Webhook 接收與回覆
- RAG / MCP RAG / FACT — 知識檢索與事實查證
- 模組化 — 每項功能獨立子流程，易維護與擴充
- GitHub Pages — 工作流說明與流程圖展示站：poirotw66.github.io/n8n_workflow
Impact（量化成效）
- 架構：1 主流程（LINE Webhook → Gemini 意圖分析 → 路由）+ 19 個子流程，涵蓋 RAG、MCP RAG、FACT、NEWS、STOCK、IMAGE、WEB、爬蟲等，模組化易維護與擴充。
- 體驗：單一 LINE 入口即可觸發技術摘要、事實查證、新聞、圖像、爬蟲等，回覆自動分段適配 LINE 顯示。
Extension（可延伸方向）
- 新增更多子流程（如訂單查詢、表單填寫、預約排程），持續擴充能力邊界。
- 將主流程意圖分析改為可訓練或可設定的規則，降低對單一模型的依賴。
- 串接內部 API 或 CRM，從對話到業務動作一站完成。
相關連結
- Repository：github.com/poirotw66/n8n_workflow
- 展示網站（流程圖與說明）：poirotw66.github.io/n8n_workflow