MaxKB学习

MaxKB是什么MaxKB是一款开源的基于大语言模型LLM的知识库问答系统由1Panel团队开发。核心定位维度说明产品形态开源软件社区版免费企业版收费技术定位RAG-as-a-Service——将非结构化文档转化为可问答的知识库目标用户企业IT管理员、开发者、需要快速搭建内部知识库的团队核心功能模块知识库管理文档上传、自动分块、向量化、增量更新问答对话基于RAG的检索增强生成、支持多轮对话、引用溯源模型管理配置LLM供应商、切换模型、设置Temperature/Max Tokens等参数应用发布生成嵌入代码或独立对话链接集成到企业系统权限控制用户管理、知识库访问权限、API密钥管理运营统计对话日志、用户提问分析、知识库命中率与Dify的关键差异对比维度MaxKBDify核心工作能力专注RAG知识库问答全栈LLM应用开发平台工作流编排无可视化DAG工作流Agent能力基础单轮/多轮问答强ReAct、Function Calling、工具调用Prompt工程基础参数配置高级Proompt模板、版本管理、A/B测试运营观测基础日志统计完整闭环标注、反馈、持续优化复杂度轻量、上手快功能全、学习曲线较陡适用场景快速搭建企业知识库构建复杂AI应用、智能客服、自动化工具流“MaxKB是‘知识库问答工具’Dify是‘AI应用操作系统’”MaxKB的下载重要提醒MaxKB 完整使用教程标准四步流程MaxKB 核心流程接入大模型 → 搭建知识库 → 创建问答智能体 → 发布使用一、登录系统修改初始密码浏览器访问地址http://服务器IP:8080默认账号密码用户名admin密码MaxKB123..登录后立即修改默认密码保障系统安全。二、第一步添加大语言模型必须先配置支持 OpenAI、阿里云百炼、Ollama 本地模型、通义千问等主流模型以Ollama 本地模型和阿里云百炼举例。通用操作路径左侧菜单【系统】→【模型】→【添加模型】方案 1接入 Ollama 本地模型离线内网推荐供应商选择Ollama基础配置模型名称自定义如 DeepSeek-R1模型类型大语言模型基础模型填写本地 Ollama 拉取的模型名deepseek-r1:8bAPI 域名http://Ollama服务器IP:11434API Key无则随便填字符点击保存测试连接成功即完成方案 2阿里云百炼/OpenAI 公有云模型供应商选择对应平台阿里云百炼/OpenAI填写自定义模型名、基础模型名称、官方获取的API Key、API 地址保存并校验连通性。三、第二步创建知识库上传业务文档知识库是 AI 回答的知识来源支持本地文档上传、网站自动爬取两种类型。1. 创建知识库基础设置左侧菜单【知识库】→【创建知识库】参数说明知识库名称自定义产品手册、员工制度等知识库描述备注用途向量模型默认内置maxkb-embedding无需修改知识库类型二选一通用型本地文档上传 PDF/Word/TXT/Markdown/Excel 等文件Web 站点输入网站 URL系统自动爬取网页内容入库2. 上传文档/同步网站通用型知识库拖拽文件或点击上传系统自动分段、向量化无需手动处理。Web 站点知识库创建后点击【同步】支持覆盖更新/全量重新爬取。3. 知识库常用管理功能选中知识库卡片右上角更多操作重新向量化更换向量模型后批量重建文档向量生成问题AI 自动根据文档批量生成问答对资源授权将知识库开放给其他子账号使用导出/删除/查看关联应用四、第三步创建问答应用智能客服/内部问答机器人两种应用模式简单配置新手推荐、高级编排复杂工作流模式 A简单配置应用零代码快速搭建左侧【应用】→【创建应用】→选择简单配置基础信息填写应用名称对话框标题产品咨询助手应用描述场景说明核心配置关键两步AI 模型选择第二步添加完成的大模型关联知识库绑定前面创建好的知识库高级对话参数自定义优化回答效果系统提示词设定 AI 角色限制只能用知识库内容回答杜绝 AI 幻觉标准模板直接复制你是专业知识库问答助手仅能根据提供的知识库内容回答用户问题 知识库无相关信息时统一回复未查询到相关内容 禁止编造、猜测外部信息回答简洁分点引用原文信息。开场白用户打开对话的欢迎语支持快捷问题长期记忆开启后 AI 记住历史对话上下文连续问答更自然语音输入/语音播报配置语音模型后开启支持语音对话右侧调试窗口直接输入问题测试回答效果调整提示词和检索参数。模式 B高级编排应用复杂业务流程适合需要多步骤逻辑、表单收集、多知识库检索、问题优化的场景可视化拖拽节点搭建工作流支持节点知识库检索、问题优化、表单收集、文档提取、变量赋值、子应用调用等操作流程拖拽组件→配置每个节点参数→点击【调试】测试完整流程→保存→发布生效。五、第四步发布应用对外使用与集成1. 发布应用应用全部配置调试完成后点击页面【保存并发布】配置正式生效。2. 三种对外集成方式对话链接复制独立网页链接直接发给用户打开对话嵌入网页 JS 代码复制嵌入代码粘贴到官网、后台系统右下角悬浮对话窗口API 接口调用提供标准对话 API对接企业小程序、APP、内部系统。六、实用优化技巧优化检索精度创建应用-知识库检索参数调整相似度阈值、返回引用片段数量提高匹配准确度。批量生成问答对知识库页面点击【生成问题】AI 自动基于文档生成标准问答适合客服场景。权限管理左侧【用户】新建子账号通过【资源授权】分配指定知识库/应用权限多人协作管理。七、常见使用问题排查AI 回答完全不匹配知识库检查是否正确绑定知识库文档是否上传完成、向量化是否成功模型调用失败核对模型 API Key、接口地址是否正确网络能否连通模型服务商文档上传后无检索结果文档过大/格式损坏重新分段上传执行【重新向量化】。