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支持Web站点知识库，可抓取在线文档并同步更新；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与Skills

工具模块可以编写和调试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和商业支持另有授权。

二次分发或商业集成前应分别核对许可证与合同。