1. 开源项目介绍
MaxKB是一个快速崛起的明星开源项目，自2024年4月发布至今，已经累计下载超50万次，与此同时其使用群体还在持续扩大。GitHub 开源地址：https://github.com/1Panel-dev/MaxKB
MaxKB支持企业快速接入主流大模型，高效构建专属知识库，并且提供从基础知识问答（RAG）、复杂业务流程自动化（Workflow，工作流）到智能体（Agent）的渐进式升级路径，有效赋能智能客服、智慧办公等多种应用场景。
2. 工作原理
MaxKB 基于检索增强生成RAG技术研发 首先将用户上传的不同格式文档（如Word、PDF等）分割成段落，通过嵌入模型（Embedding模型）转换为向量并存储到向量数据库中；当用户提问时，系统将问题同样向量化并在数据库中搜索最相关的文档段落（Top K），最后将这些相关段落与问题一起输入大语言模型生成最终答案。
图 1：MaxKB工作原理
2. 安装部署
4.1 资源要求
-
服务器配置
部署服务器要求：
- 操作系统：Ubuntu 22.04 / CentOS 7（内核版本要求 ≥ 3.10）
- CPU/内存：4C/8GB 以上
- 磁盘空间：100GB
-
端口要求
在线部署 MaxKB 需要开通的访问端口说明如下：
| 端口 | 作用 | 说明 |
| 22 |
| 安装、升级及管理使用 |
| 8080 | Web服务端口 | 默认Web服务访问端口，可根据实际情况进行更改 |
SSH4.2 快速部署
在配置 docker 环境的操作系统中，仅需执行以下命令即可一键完成 MaxKB 的安装：
| # Linux 操作系统 docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb # Windows 操作系统 docker run -d --name=maxkb --restart=always -p 8080:8080 -v C:/maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb |
待所有容器状态显示为healthy后，可通过浏览器访问 MaxKB：
| http://目标服务器 IP 地址:8080 默认登录信息 用户名：admin 默认密码：MaxKB@123.. |
4.3 在线升级
根据以下步骤依次执行进行升级：
（1）下载最新镜像
| docker pull registry.fit2cloud.com/maxkb/maxkb |
（2）查看并确认上一次数据持久化目录，复制保存
| docker inspect maxkb |
图 2：在线升级
（3）删除正在运行的、旧版本的 MaxKB 容器
| docker rm -f maxkb |
（4）启动并运行新版本的 MaxKB 容器
注意： 务必确认数据持久化目录（即命令行中 -v后的目录）要跟第 (2) 步查看目录保持一致，否则启动后整个系统的数据为空。
| docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb registry.fit2cloud.com/maxkb/maxkb |
5. 界面展示
图 3：MaxKB界面展示
6. 适用场景
企业智能体应用按服务对象分类可以分为对内与对外。其中对外场景中的智能客服类智能体聚焦客户服务与智能问答。在企业侧，智能客服类智能体可以针对企业客户的需求，提供智能问答助手，如智能在线客服、智能售后处理等；在政府侧，它能够为政府部门提供法律咨询、政策咨询、办事指导等政务智能体服务。
对内场景中的智能体其功能覆盖信息检索、审核和决策，包括解决“知识找不到”痛点的信息检索类智能体、解决“文档产出慢”痛点的内容生成类智能体、解决“信息提炼难”痛点的数据提取类智能体、解决“人工审查累，审核效率低”痛点的合规审核类智能体以及解决“经验依赖重”痛点的辅助决策类智能体。
图 4：MaxKB落地场景
