MaxKB

一、MaxKB是什么？

MaxKB（Max Knowledge Brain） 是飞致云（1Panel-dev）开源的企业级智能体平台，致力于解决企业在AI落地过程中面临的技术门槛高、部署成本高、迭代周期长三大痛点。截至2026年8月，该项目在GitHub上已获得超过2.2万Stars，全球免费安装量突破100万次，付费客户超过1000家企业及机构。

MaxKB的核心定位是让AI落地更简单，秉承“开箱即用·伴随成长”的产品理念。它提供了一条从基础RAG问答 → 工作流自动化 → 智能体（Agent） 的渐进式升级路径，企业可以根据自身业务成熟度，逐步解锁AI能力。

在技术架构上，MaxKB采用Vue.js前端 + Python/Django后端 + LangChain大模型框架 + PostgreSQL + pgvector向量数据库的组合。它同时支持私有模型（如DeepSeek、Llama、Qwen等）和公有模型（如OpenAI、Claude、Gemini、MiniMax等），真正做到模型无关（Model-Agnostic） 。

⚠️ 安全提醒：MaxKB v2.7.1及之前版本曾被发现跨站脚本（XSS）漏洞，建议所有用户升级至v2.8.0及以上版本。

二、核心功能全景

2.1 智能体（Agent）——核心能力不断进化

2026年是MaxKB智能体能力大幅跃升的一年：

• v2.5.0（2026年1月） ：原“应用”模块正式升级为“智能体”模块，支持大语言模型自主执行流程（自主调用工具、MCP和智能体）；上线模板中心，用户可通过模板一键创建智能体。
• v2.7.0（2026年3月） ：支持智能体自主调用Skills技能，知识库标签管理优化，企业级安全增强。
• v2.9.0（2026年5月） ：新增长期记忆功能（按对话轮次或时间周期触发记忆生成），工作流节点禁用/启用功能，支持MiniMax系列模型。
• v2.10 LTS（2026年6月） ：首个长期支持版本，AI对话节点全面支持多模态输入（文本+图片），新增工作空间首页统计功能，知识库支持自定义术语库。

2.2 RAG知识库——从静态到智能

MaxKB内置完整的RAG（检索增强生成）流水线，支持直接上传文档和自动爬取在线文档，具备自动文本拆分和向量化能力，有效降低大模型幻觉。

更值得关注的是，从v2.5版本开始，MaxKB支持构建 “智能RAG”（Agentic RAG） ——让AI能够主动搜索知识、自我反思、多轮迭代，而非传统的“一次检索即输出”。例如，当用户问“公司有多少博士员工”时，智能RAG会先检索“博士”无果，然后自动意识到“博士”属于“学历结构”范畴，更换关键词进行二次寻证。

2.3 工作流编排——可视化构建复杂业务

MaxKB配备强大的可视化工作流引擎、函数库和MCP工具调用能力。用户可以通过拖拽节点的方式，将复杂业务流程拆解为标准化节点，实现全流程自动化编排。

2.4 零编码集成——快速嵌入现有系统

MaxKB支持零编码快速集成到网站、企业微信、钉钉、飞书等办公系统，以及第三方业务系统。同时提供开放的API接口，业务系统可以直接调用MaxKB的API实现AI审核、智能决策等功能。

三、快速上手指南（5分钟部署）

3.1 Docker一键部署（推荐）

执行以下命令即可启动MaxKB容器：

docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb

启动后，通过浏览器访问 http://your_server_ip:8080。

默认管理员账号：

• 用户名：admin
• 密码：MaxKB@123..

📌 中国用户提示：如遇Docker镜像拉取失败，请参考离线安装文档进行安装。

3.2 三步完成AI落地

第一步：接入大模型——在私有环境中快速接入DeepSeek、Qwen、OpenAI、Claude等主流大模型。

第二步：构建知识库——上传文档，系统自动完成文本拆分和向量化。

第三步：创建智能体——从模板中心选择模板，或从零开始编排工作流。

3.3 进阶：搭建智能RAG

1. 准备知识库：上传企业文档，完成向量化。
2. 创建“向量检索智能体” ：专注于从知识库检索最相关原文片段，配置相似度阈值和TopK数量。
3. 编排“智能RAG”工作流：创建主智能体，在AI节点的技能配置中添加“向量检索智能体”，通过Prompt赋予AI调度检索、自我修正和多轮追溯的能力。

四、企业级应用建议

4.1 典型应用场景

MaxKB已广泛应用于以下场景：

4.2 部署建议

1. 版本选择：建议生产环境使用 v2.10 LTS长期支持版本，稳定性更高。
2. 模型接入：可根据业务需求灵活选择私有模型（数据安全要求高）或公有模型（成本更低）。
3. 数据安全：MaxKB支持私有化部署，企业数据自主可控。v2.5.0起新增第三方用户默认角色分配和登录失败锁定账号功能。
4. 多模态能力：从v2.10 LTS开始，AI对话节点支持同时传入文本和图片，适用于更丰富的交互场景。

4.3 最佳实践

• 渐进式升级：从基础RAG问答开始，逐步过渡到工作流自动化，最终实现智能体全面应用。
• 利用模板中心：v2.5.0上线的模板中心覆盖典型应用场景，可大幅缩短开发周期。同时欢迎社区用户贡献模板至GitHub工具商店。
• 善用长期记忆：v2.9.0的长期记忆功能可按对话轮次或时间周期生成记忆，通过引用变量 {memory} 注入提示词，提升对话连贯性与个性化体验。
• 自定义术语库：v2.10 LTS支持自定义专业词汇和行业缩写，可显著提升垂直领域知识库检索准确率。

五、总结

MaxKB在2026年经历了从“应用”到“智能体”的全面升级，已成长为一个功能完备的开源企业级智能体平台。它通过RAG流水线、可视化工作流、MCP工具调用和多模型支持四大核心能力，覆盖了从智能客服到智能运维的广泛企业场景。

对于希望低成本、快速落地AI能力的企业而言，MaxKB的“开箱即用”特性和渐进式升级路径，提供了一个兼顾当下需求与未来扩展的理想选择。