MaxKB（Max Knowledge Base）是一款基于大语言模型和RAG的开源知识库问答系统，广泛应用于企业内部知识库、客户服务、学术研究与教育等场景。本文主要介绍使用MaxKB应用镜像快速搭建基于大语言模型的知识库问答系统。
关于MaxKB的更多信息，请参见MaxKB官网。
操作步骤
步骤一：部署MaxKB
如果您已购买轻量应用服务器，可以跳过此步骤，以重置系统的方式部署MaxKB（重置系统时选择应用镜像下的MaxKB镜像），但重置系统会清除轻量应用服务器上的系统盘数据，请您根据需要做好数据备份。具体操作，请参见重置系统。
在页面左上角，单击创建服务器。
在轻量应用服务器页面，根据界面提示完成资源配置，具体配置项说明如下表所示。
说明不同地域及其实例规格类型支持的镜像和套餐可能不同，具体请以控制台购买页为准。
配置项
示例
说明
实例
实例规格族：通用型
套餐：￥224/月
镜像
应用镜像：MaxKB
版本： 1.10.2
在应用镜像页签下，单击MaxKB。
地域
新加坡
请根据业务所在的地理位置选择就近地域，降低网络延迟。服务器创建后不支持更换地域，请谨慎选择。
重要非中国内地地域，例如中国香港、新加坡等地域的服务器，提供国际带宽，因此，当您在中国内地访问服务器时，会有较大的网络延迟。因此建议选择和您目标用户所在地域最为接近的地域，可以进一步提升用户访问速度。更多信息，请参见地域与网络连通性。
购买配置
数量：1
时长：1个月
完成配置后，单击立即购买，根据界面提示完成付费操作。
支付完成后，单击进入管理控制台。当服务器状态由准备中变为运行中，表示MaxKB服务器已经部署成功。
，可选择更多套餐。套餐中包含vCPU、内存、系统盘、公网流量包等指标信息。更多信息，请参见步骤二：登录MaxKB
放行端口并获取MaxKB登录信息。
在服务器页面，单击目标服务器的实例ID，进入服务器概览页面。
单击应用详情页签，放行所需端口并获取MaxKB首页地址、管理员账号和密码。
具体操作说明：
在图中①区域，单击一键放通，放通MaxKB所需的
8080端口。在图中②区域，获取MaxKB首页地址
http://47.178.XX.XX:8080。在图中③区域，单击快速查看，在弹出的快速查看对话框中，获取MaxKB默认管理员用户名和密码。
登录MaxKB。
在本地电脑中，在浏览器中输入MaxKB首页地址
http://47.178.XX.XX:8080，并输入默认管理员用户名和密码后，单击登录。首次登录后，请根据界面提示及时修改默认密码，避免造成数据泄露。
步骤三：使用MaxKB
本步骤主要介绍使用MaxKB制作企业知识库小助手的基本流程，关于MaxKB的更多使用，请参见MaxKB官方文档。
1. 添加模型
模型管理用于对接供应商的大语言模型，支持对接主流的大模型，支持的类型包括文本生成、向量模型、重排、语音识别、语音合成、视觉模型、图片生成等。更多信息，请参见模型管理。
在左侧顶部菜单，单击系统设置。
在左侧导航栏，单击模型设置。
在模型设置页面，单击添加模型。
根据界面提示，选择模型供应商。
本示例选择阿里云百炼。
根据界面提示，设置模型参数后，单击保存。
不同模型对应的参数可能不同，其他模型，请参见模型对接。
参数
说明
示例
模型名称
输入MaxKB中自定义的模型名称。
qwen-turbo
权限
按需选择权限：
私有：仅当前用户使用。
公有：所有用户都可以使用。
私有
模型类型
下拉列表选择模型类型。
大语言模型
基础模型
在下拉列表中选择模型。
qwen-turbo
API URL
输入模型服务API服务访问地址，本示例直接输入
https://dashscope.aliyuncs.com/compatible-mode/v1即可。目前仅当模型类型是大语言模型时需要输入。https://dashscope.aliyuncs.com/compatible-mode/v1
API Key
输入模型服务API服务访问密钥。本示例您需要在阿里云百炼控制台获取API Key。具体操作，请参见获取API Key。
sk-88473bc3a451436aa9e172ff4a43****
2. 创建知识库
企业私有的专业知识库，包含各种类型的数据，是问答对话中回答用户问题的知识来源。关于知识库的更多信息，请参见知识库。
在左侧顶部菜单，单击知识库。
在知识库页面，单击创建知识库。
在弹出的创建知识库对话框中，配置参数。
参数
说明
示例
知识库名称
请输入知识库名称。
test
知识库描述
请输入知识库描述信息。
-
向量模型
在下拉列表中，选择向量模型。
maxkb-embedding
知识库类型
按需选择知识库模型：
通用型：对离线文档上传管理，支持的文本文件、表格以及QA问答对。
web站点：用于获取在线静态文本数据管理，输入Web站点地址后，自动同步根地址及子级地址的文本数据。
web站点
Web根地址
当知识库类型为Web站点时，需要输入文档的根目录。本示例输入轻量应用服务器帮助文档的根目录。
https://help.aliyun.com/zh/simple-application-server/
单击创建后，查看文件状态。
请耐心等待，系统会自动爬取根地址及子地址的文本数据，按照URL地址生成文档，并自动拆分和进行向量化处理。当所有文档的文件状态由排队中变为成功，表示创建知识库完成。
3. 创建应用
本示例以创建轻量应用服务器产品智能问答小助手应用为例，更多信息，请参见应用。
创建应用。
在左侧顶部菜单，单击应用。
在应用页面，单击创建应用。
说明如果您已有对应的应用，单击导入应用。
在弹出的创建应用对话框中，根据界面提示配置参数后，单击创建。
参数
说明
示例
应用名称
请输入应用名称。
AI智能小助手
应用描述
请输入该应用的应用场景及用途。
轻量应用服务器产品智能问答
选择应用类型
按需选择应用类型：
简单配置：适合新手创建小助手。
高级编排：适合高级用户自定义小助手的工作流。
简单配置
在设置页面，根据界面提示配置参数。
关键参数说明如下，其他参数请按需配置。
参数
说明
示例
AI模型
在下拉列表中选择已添加的模型。
qwen-turbo
系统角色
请输入角色信息。
你是智能问答小助手
提示词
系统默认有智能知识库的提示词，用户可以自定义通过调整提示词内容，引导大模型聊天方向。可对无引用知识库和引用知识库两种情况分别设置不同的提示词。
{question}
关联知识库
单击添加，选择已创建的知识库。
-
开场白
输入用户打开对话时，系统弹出的问候语。
您好，我是智能问答小助手，您可以向我提出使用轻量应用服务器的问题。
- 主要功能有什么？
- 如何收费？
- 转人工服务
在调试预览区域，调试后在页面右上角，单击保存并发布。
验证结果。
在左侧导航栏，单击概览。
在概览页面单击演示或在浏览器中复制公开访问链接。
进入问答页面，输入问题进行提问。
4. 应用集成
MaxKB应用支持零编码快速嵌入第三方Web系统，嵌入代码后，便可在第三方系统中进行问答。
在应用信息区域中，单击嵌入第三方。
在弹出的嵌入第三方对话框中，根据需求在全屏模式或者浮窗模式中，单击
图标，复制对应的嵌入代码。嵌入完成后，便可在第三方系统中进行问答。
嵌入后的效果如下：
