MaxKB

MaxKB是什麼？

MaxKB的全名是Max Knowledge Brain，是飛致雲旗下的開源企業級智慧體平台。它將大模型接入、知識庫建構、RAG檢索增強、可視化工作流、工具調用以及智慧體發布等功能整合在一套Web系統中，主要用於企業內部的知識諮詢、智慧客服、教育培訓、學術研究以及業務流程自動化。

MaxKB並非一個自研的通用大模型，而是連接模型與企業數據之間的應用平台。管理員可以連接DeepSeek、Qwen、Llama、OpenAI、Claude、Gemini等公有或私有的模型，再上傳內部文件、抓取網站資料或編排工作流程，最終生成可公開訪問、嵌入業務網站或透過API調用的AI助手。

核心功能

1. RAG知識庫

通用知識庫支援上傳Markdown、TXT、PDF、DOCX、HTML、XLS、XLSX、CSV和ZIP等檔案，系統會解析文本、自動分段、調用向量模型生成向量，並將其儲存於PostgreSQL與pgvector中。當用戶提問時，系統會先召回相關片段，再將這些片段與問題交給大模型來生成回答，如此一來，答案就能圍繞企業資料而產生。

管理員可以設定分段規則、相似度閾值、召回數量、引用來源以及命中測試，同時也能維護問題與答案的對應關係。RAG可以減少缺乏資料依據的回答，但無法完全消除幻覺；

掃描件、複雜表格、圖片、頁眉腳和跨頁語義可能解析不完整，關鍵答案仍應打開原文核驗。

2. Web、飛書與工作流知識庫

除離線檔案外，MaxKB還支援網站知識庫，可抓取線上文件並同步更新；X-Pack更提供飛書知識庫的接入功能。

通用、Web和飛書知識庫可以轉換為工作流知識庫，將資料來源、內容提取、分段處理與寫入步驟自由編排。

工作流知識庫可以處理圖片、音頻和影片：先調用理解或轉寫模型來提取結構化資訊，再將文本與原始媒體路徑組合後分段儲存，從而形成跨模態的檢索流程。知識庫的轉換屬於不可逆操作，Web知識庫在轉換之後也會失去原有的同步入口，因此在執行前應先備份並驗證工作流。

3. 簡易智能體

簡易智能體面向標準知識問答場景。用戶選擇大語言模型、關聯知識庫、編寫系統提示詞並設定開場白，即可發布助手。

提示詞支援引用問題與檢索內容變數，還能控制多輪對話、引用來源、語音播放、執行詳情和回覆樣式。

該模式適合用於產品手冊、員工制度、校園問答以及售後客服，使用者無需理解複雜的流程步驟。若業務中涉及多階段審批、外部介面、表單收集或多個模型之間的協作，則應使用進階智能體。

4. 高級智能體與可視化工作流

高級智能體透過畫布組合AI對話、圖片理解、圖片生成、知識庫檢索、多路召回、判斷器、問題優化、指定回覆、表單收集、變數賦值、文件提取、語音辨識、語音合成、循環、函數、MCP以及其他智能體等節點。節點輸出可作為後續輸入，適合將業務規則嵌入AI流程。

用戶可在對話開始時選擇模型或知識庫，也能上傳文件、圖片、音頻和影片交由後續節點處理。工作流提供調試與執行詳情，發布前應涵蓋正常、無命中、模型超時、工具失敗、循環上限和敏感輸入等分支。

5. 多路召回與重排

當一個問題涉及多個知識庫時，可以先分別進行搜尋，再利用重排模型對候選片段重新評分，從而提升最終結果的相關性。標籤搜尋還能根據部門、產品、年份等元資料來縮小搜尋範圍，減少無關內容出現在提示詞中。

召回的數量越多，並不一定代表準確度越高，還可能增加上下文與 Token 的成本。應該以真實的業務問題來建立測試集，並對分塊長度、向量模型、重排模型、閾值以及 Top K 進行評估，而非僅憑演示問題來判斷效果。

6. 模型供應商與多模態能力

MaxKB支援OpenAI、Azure OpenAI、Anthropic、Gemini、DeepSeek、阿里雲百煉、Kimi、智譜AI、百度千帆、矽基流動等雲服務，也能連接Ollama等本地推理服務。模型類型涵蓋大語言模型、向量模型、重排模型、視覺、圖片生成、語音識別和語音合成。

平台並不包含這些模型的全部使用額度。雲端模型通常是根據各供應商的 Token 或媒體產生量來計費，而本地模型則需要自行準備 CPU、GPU、記憶體和儲存空間。

添加模型時應使用官方API地址，代理地址會接觸API密鑰和對話數據。

7. 工具、MCP與技能

工具模組可以編寫和調試Python程式碼，定義啟動參數、輸入和輸出，讓智慧體能夠查詢資料庫、呼叫業務介面、計算或提取資訊。啟動參數與工作流輸入分開，便於隱藏密鑰。

系統也支援建立MCP、Skills、資料來源、匯入工具，以及從工具商店添加能力。

MCP和自訂Python工具可能存取網路、檔案系統和資料庫，其權限高於一般問答功能。在啟用之前應先檢查程式碼及相關依賴項目，並使用只讀或最低權限的帳號，同時限制網路出口並記錄執行日誌。

模型自主決定調用工具時，還要防範提示詞注入誘導越權操作。

8. 觸發器與自動執行

智能體可以配置定時觸發器或Webhook事件觸發器。定時任務支援按月、週、日、間隔或Cron表達式來運行；

Webhook會產生請求地址和Bearer Token，外部系統可以攜帶參數來啟動工作流。

自動任務適合用於定期整理資料、產生日報以及處理業務事件。在生產環境中，需要對請求簽名進行驗證、輪換Token、限制執行頻率、設定幂等性，並在發生錯誤時發出警報，以避免重複執行而導致模型費用增加或業務數據出現異常。

9. 發布、API與網頁嵌入

智能體發布後可以生成公開訪問連結，並能以全螢幕、行動端或浮窗形式，以零程式碼方式嵌入第三方網站。公開問答頁面支援複製、重新回答、回饋、分享，以及匯出 Markdown、HTML、PDF 或圖片。

每個智慧體可創建、啟用、停用及刪除API Key，外部系統透過API調用其問答功能。平台還能限制單一用戶端的提問次數以及允許嵌入的來源清單。

正式開放前應配置身份驗證、限流、密鑰保管、日誌脫敏和模型費用預警。

10. 企業協作與第三方辦公平台

X-Pack提供多用戶、工作空間、角色權限、資源授權、共享知識庫/模型/工具、操作日誌、外觀品牌以及登入認證功能。在專業或企業環境中，還可與LDAP、OIDC、CAS、OAuth2、SAML2，以及企業微信、釘釘、飛書的掃碼登入功能相整合。

智能體接入功能可連接企業微信機器人與智能體、微信客服、微信公眾號、釘釘和飛書，使員工或客戶直接在辦公平台中進行問答。回調地址、Token、加密密鑰和IP白名單需要依照各平台的規則來設定。

安裝與私有化部署

在社群版中，最常見的部署方式就是使用 Docker。官方提供的鏡像會將 Web 服務置於 8080 連接埠上，而資料則會被儲存於主機的目錄中。此外，也可以透過離線安裝包或 1Panel 應用商店來進行部署。

技術堆疊包括Vue.js前端、Python/Django後端、LangChain以及PostgreSQL和pgvector。

預設的管理員帳號與密碼會顯示在公開文件中，首次登入後必須立即修改，並設定 HTTPS、防火牆、備份以及最小權限。在將環境升級之前，應先備份資料庫、知識庫的原始檔案、模型設定以及掛載目錄；

V1到V2的接口與部分結構不同，遷移工具也區分社區版和專業版。

MaxKB服務本身可在沒有GPU的伺服器上運行，但若本機同時部署大模型或多模態模型，硬件需求主要由模型決定。高併發還需評估資料庫連線數、向量檢索、模型吞吐、檔案解析隊列和對象儲存。

價格與版本

社區版

社區版免費且開源，適用於個人及小型團隊。官方價格頁面說明，V2社區版不限制使用者數量、智能體數量以及知識庫數量，並包含知識庫、智能體、工作流、MCP、Skills等基礎功能，技術支援主要透過社區渠道進行。

專業版

專業版目前的價格為4.8萬元/套，提供永久授權，適用於中小型企業。每套授權對應一個最終客戶的部署實例，包含所有社群版功能、X-Pack的進階功能、單機或冷備份部署選項，以及5×8的小時基本支援服務。

專業版包含一年維保，第二年起維保價格為9600元/年，並提供軟體小版本升級服務。永久授權指的是已購買版本的軟體使用權，並不代表之後的維保、升級、模型Token、雲資源及定制實施服務都會永久免費。

企業版

企業版需要聯繫銷售以獲取報價，適用於大型組織，具備多租戶、共享資源、集群部署等功能，並提供7×24小時的加強型支援，同時還包含更高等級的回應服務、培訓服務，以及遠端或現場服務。採購時應明確規定實例數量、部署架構、維保年限、升級範圍、SLA條款，以及是否將資料遷移和客製化開發納入合約範圍。

一體機

官方還提供與硬體廠商聯合的一體機方案，本次核驗頁面顯示GB10版限時價格為9.9萬元/台，包含FusionXpark GB10硬體、MaxKB專業版、1Panel企業版、一年軟硬件維保以及5×8技術支援。此價格適用於特定配置與活動，不應替代軟體專業版的報價。

GitHub與開源許可

MaxKB的官方代碼倉庫位於1Panel-dev組織中，V2版本則由該組織持續維護。前端主要使用Vue.js，後端則使用Python和Django。

該專案採用GNU General Public License v3.0，允許在許可證條件下運行、研究、修改和散發。

GPL-3.0的開源代碼與X-Pack的商業增強功能需要區分開來。如果企業在修改後再發布軟體、製作商業版本，或是整合專有模組，那麼就必須審視相關的GPL義務。

購買專業版也應以商業授權文件說明為準，不能僅根據網頁功能表推斷二次發行權。

MaxKB使用教學

完成一次基礎任務

1. 明確問題、時間範圍、地區、來源優先級和輸出格式；
2. 在MaxKB中上傳有權使用的資料或輸入檢索問題；
3. 先用RAG知識庫建立框架，再透過Web、飛書與工作流知識庫補充證據；
4. 要求區分來源事實、作者觀點和AI推斷；
5. 逐條核對日期、數字、原文位置和相互衝突的證據；
6. 人工修訂結論並記錄核驗時間後再發布；

建立可重複使用的專業工作流

1. 把複雜主題拆成背景、數據、比較和結論四類問題；
2. 組合RAG知識庫、Web、飛書與工作流知識庫與簡易智能體形成固定研究步驟；
3. 優先使用官網、論文、監管文件和原始數據；
4. 對高風險結論設置第二人複核；
5. 保存查詢、證據、版本和未解決的問題；
6. 資料變化後重新運行並更新結論；

安全與運維注意事項

• 公開知識庫、訪問連結和API可能洩露內部文件片段；
• 上線前應配置身份認證、資源授權、來源白名單、APIKey有效期與輪換、檔案下載策略、日誌保留和敏感詞規則；
• 知識庫原文的下載權限要與業務訪問權限一致；
• 官方2026年版本曾修復密碼重設介面明文傳輸以及工作流模板回呼地址所導致的SSRF風險，說明私有化部署也必須持續升級安全版本；
• 不要把“部署在內網”視為無需補丁；
• 還應限制容器權限、資料庫端口和工具網路訪問；
• 模型與向量服務會接觸問題和檢索片段；
• 使用公有API前需核對供應商的數據保留、訓練、地域和合規條款；
• 嚴格保密資料應考慮本地模型、脫敏、審計和網路隔離；

適合哪些用戶？

• 搭建企業制度、產品、售後及技術文件問答的團隊；
• 需要私有部署RAG知識庫與AI客服的中小企業；
• 希望透過可視化工作流連接模型、知識庫和業務API的開發者；
• 需要企業微信、釘釘、飛書或網站嵌入AI助手的組織；
• 希望用Ollama和本地模型控制數據流向的使用者；
• 需要工作空間、角色權限、多租戶和集群支援的大型企業。

產品優勢

• 社群版免費開源，V2不限制用戶、智能體和知識庫數量；
• 從簡單的RAG問答到複雜的Agent工作流可漸進使用；
• 兼容國內外雲模型和Ollama私有模型；
• 支援文件、網站、飛書及多模態工作流知識庫；
• 集成MCP、Skills、Python工具和觸發器；
• 支援公開連結、API及網頁零代碼嵌入；
• 專業版與企業版提供國產化、權限及原廠支援方案。

限制與注意事項

• MaxKB降低了RAG與智能體搭建的門檻，但模型選型、數據清洗、分段評估、權限設計及運維仍需專業人員；
• 知識庫數量不受限也不代表磁碟、併發和向量檢索性能無限；
• 社區版與X-Pack的功能邊界會隨版本調整，舊版宣傳冊中的用戶或應用數量限制不應套用到V2；
• 部署、升級和採購前應以當前版本對比頁、發行說明和許可證為準；

常見問題

MaxKB免費嗎？

社區版免費開源，且V2版本沒有使用者、智慧體和知識庫數量的限制；雲端模型API、伺服器、專業版、企業版以及原廠服務則需另行付費。

MaxKB專業版多少錢？

目前官網價格為4.8萬元/套永久授權，含一年維保；第二年起維保9600元/年。

每套對應一個最終客戶的一個部署實例。

MaxKB能私有化部署嗎？

可以。支援Docker、離線包和1Panel等方式部署，也可連接Ollama或其他私有模型。

生產環境需要自行完成HTTPS、備份、安全升級和監控。

MaxKB支援API和網站嵌入嗎？

支持。智能體可以生成API Key和公開連結，也可透過全屏、行動端或浮窗代碼嵌入第三方Web系統。

MaxKB與大模型是什麼關係？

MaxKB是智能體與知識庫平台，而非基礎大模型。它連接用戶選擇的公有或私有模型，並以企業知識庫與工具來提升回應品質。

MaxKB採用什麼開源許可？

社群代碼採用GPL-3.0；X-Pack及商業支援另有授權。

二次發行或商業集成前應分別核對許可證與合約。