MaxKB学习

MaxKB是什么

MaxKB是一款开源的基于大语言模型（LLM）的知识库问答系统，由1Panel团队开发。

|------|-----------------------------------------|
| 维度 | 说明 |
| 产品形态 | 开源软件，社区版免费，企业版收费 |
| 技术定位 | RAG-as-a-Service------将非结构化文档转化为可问答的知识库 |
| 目标用户 | 企业IT管理员、开发者、需要快速搭建内部知识库的团队 |
[核心定位]

核心功能模块：

|-----------|-------------------------------------------|
| 知识库管理 | 文档上传、自动分块、向量化、增量更新 |
| 问答对话 | 基于RAG的检索增强生成、支持多轮对话、引用溯源 |
| 模型管理 | 配置LLM供应商、切换模型、设置Temperature/Max Tokens等参数 |
| 应用发布 | 生成嵌入代码或独立对话链接，集成到企业系统 |
| 权限控制 | 用户管理、知识库访问权限、API密钥管理 |
| 运营统计 | 对话日志、用户提问分析、知识库命中率 |

与Dify的关键差异

|----------|-------------|--------------------------------|
| 对比维度 | MaxKB | Dify |
| 核心工作能力 | 专注RAG知识库问答 | 全栈LLM应用开发平台 |
| 工作流编排 | 无 | 可视化DAG工作流 |
| Agent能力 | 基础（单轮/多轮问答） | 强（ReAct、Function Calling、工具调用） |
| Prompt工程 | 基础参数配置 | 高级Proompt模板、版本管理、A/B测试 |
| 运营观测 | 基础日志统计 | 完整闭环（标注、反馈、持续优化） |
| 复杂度 | 轻量、上手快 | 功能全、学习曲线较陡 |
| 适用场景 | 快速搭建企业知识库 | 构建复杂AI应用、智能客服、自动化工具流 |

"MaxKB是'知识库问答工具'，Dify是'AI应用操作系统'"

MaxKB的下载

重要提醒：MaxKB 完整使用教程（标准四步流程）

MaxKB 核心流程：接入大模型 → 搭建知识库 → 创建问答智能体 → 发布使用

一、登录系统，修改初始密码

1. 浏览器访问地址：http://服务器IP:8080
2. 默认账号密码：
   • 用户名：admin
   • 密码：MaxKB@123..
3. 登录后立即修改默认密码，保障系统安全。

二、第一步：添加大语言模型（必须先配置）

支持 OpenAI、阿里云百炼、Ollama 本地模型、通义千问等主流模型，以Ollama 本地模型 和阿里云百炼举例。

通用操作路径

左侧菜单【系统】→【模型】→【添加模型】

方案 1：接入 Ollama 本地模型（离线内网推荐）

1. 供应商选择：Ollama
2. 基础配置：
   • 模型名称：自定义（如 DeepSeek-R1）
   • 模型类型：大语言模型
   • 基础模型：填写本地 Ollama 拉取的模型名（deepseek-r1:8b）
   • API 域名：http://Ollama服务器IP:11434
   • API Key：无则随便填字符
3. 点击保存，测试连接成功即完成

方案 2：阿里云百炼/OpenAI 公有云模型

1. 供应商选择对应平台（阿里云百炼/OpenAI）
2. 填写：自定义模型名、基础模型名称、官方获取的 API Key、API 地址
3. 保存并校验连通性。

三、第二步：创建知识库，上传业务文档

知识库是 AI 回答的知识来源，支持本地文档上传 、网站自动爬取两种类型。

1. 创建知识库基础设置

左侧菜单【知识库】→【创建知识库】

参数说明：

• 知识库名称：自定义（产品手册、员工制度等）
• 知识库描述：备注用途
• 向量模型：默认内置 maxkb-embedding，无需修改
• 知识库类型二选一：
  1. 通用型（本地文档）：上传 PDF/Word/TXT/Markdown/Excel 等文件
  2. Web 站点：输入网站 URL，系统自动爬取网页内容入库

2. 上传文档/同步网站

1. 通用型知识库：拖拽文件或点击上传，系统自动分段、向量化，无需手动处理。
2. Web 站点知识库：创建后点击【同步】，支持覆盖更新/全量重新爬取。

3. 知识库常用管理功能

选中知识库卡片右上角更多操作：

• 重新向量化：更换向量模型后，批量重建文档向量
• 生成问题：AI 自动根据文档批量生成问答对
• 资源授权：将知识库开放给其他子账号使用
• 导出/删除/查看关联应用

四、第三步：创建问答应用（智能客服/内部问答机器人）

两种应用模式：简单配置（新手推荐） 、高级编排（复杂工作流）

模式 A：简单配置应用（零代码，快速搭建）

1. 左侧【应用】→【创建应用】→选择简单配置
2. 基础信息填写
   • 应用名称：对话框标题（产品咨询助手）
   • 应用描述：场景说明
3. 核心配置（关键两步）
   1. AI 模型：选择第二步添加完成的大模型
   2. 关联知识库：绑定前面创建好的知识库
4. 高级对话参数自定义（优化回答效果）

   • 系统提示词 ：设定 AI 角色，限制只能用知识库内容回答，杜绝 AI 幻觉
     标准模板直接复制：

     你是专业知识库问答助手，仅能根据提供的知识库内容回答用户问题；
     知识库无相关信息时，统一回复：未查询到相关内容；
     禁止编造、猜测外部信息，回答简洁分点，引用原文信息。

   • 开场白：用户打开对话的欢迎语，支持快捷问题

   • 长期记忆：开启后 AI 记住历史对话上下文，连续问答更自然

   • 语音输入/语音播报：配置语音模型后开启，支持语音对话

5. 右侧调试窗口：直接输入问题测试回答效果，调整提示词和检索参数。

模式 B：高级编排应用（复杂业务流程）

适合需要多步骤逻辑、表单收集、多知识库检索、问题优化的场景，可视化拖拽节点搭建工作流：

支持节点：知识库检索、问题优化、表单收集、文档提取、变量赋值、子应用调用等

操作流程：拖拽组件→配置每个节点参数→点击【调试】测试完整流程→保存→发布生效。

五、第四步：发布应用，对外使用与集成

1. 发布应用

应用全部配置调试完成后，点击页面【保存并发布】，配置正式生效。

2. 三种对外集成方式

1. 对话链接：复制独立网页链接，直接发给用户打开对话；
2. 嵌入网页 JS 代码：复制嵌入代码，粘贴到官网、后台系统，右下角悬浮对话窗口；
3. API 接口调用：提供标准对话 API，对接企业小程序、APP、内部系统。

六、实用优化技巧

1. 优化检索精度
   创建应用-知识库检索参数：调整相似度阈值、返回引用片段数量，提高匹配准确度。
2. 批量生成问答对
   知识库页面点击【生成问题】，AI 自动基于文档生成标准问答，适合客服场景。
3. 权限管理
   左侧【用户】新建子账号，通过【资源授权】分配指定知识库/应用权限，多人协作管理。

七、常见使用问题排查

1. AI 回答完全不匹配知识库：检查是否正确绑定知识库，文档是否上传完成、向量化是否成功；
2. 模型调用失败：核对模型 API Key、接口地址是否正确，网络能否连通模型服务商；
3. 文档上传后无检索结果：文档过大/格式损坏，重新分段上传，执行【重新向量化】。