搭建MaxKB_轻量应用服务器(SAS)-阿里云帮助中心

MaxKB（Max Knowledge Base）是一款基于大语言模型和RAG的开源知识库问答系统，广泛应用于企业内部知识库、客户服务、学术研究与教育等场景。本文主要介绍使用MaxKB应用镜像快速搭建基于大语言模型的知识库问答系统。

说明

关于MaxKB的更多信息，请参见MaxKB官网。

操作步骤

步骤一：部署MaxKB

重要

如果您已购买轻量应用服务器，可以跳过此步骤，以重置系统的方式部署MaxKB（重置系统时选择应用镜像下的MaxKB镜像），但重置系统会清除轻量应用服务器上的磁盘数据，请您根据需要做好数据备份。具体操作，请参见重置系统。

登录轻量应用服务器管理控制台。
在左侧导航栏，单击服务器。
在页面左上角，单击创建服务器。

在轻量应用服务器页面，完成服务器配置。

具体配置项说明如下表所示。

配置项	示例	说明

配置项	示例	说明
实例类型	服务器实例	本文需选择服务器实例。
地域	华东1（杭州）	请根据您业务所在的地理位置选择地域。服务器创建后无法更换地域，请谨慎选择。重要非中国内地地域，例如中国香港、新加坡等地域的服务器，提供国际带宽，因此，当您在中国内地访问服务器时，会有较大的网络延迟。因此建议选择和您目标用户所在地域最为接近的地域，可以进一步提升用户访问速度。更多信息，请参见地域与网络连通性。
镜像	类型：应用镜像应用：MaxKB 版本：1.10.1	在应用镜像页签下，单击MaxKB。
套餐配置	220元/月	您可以根据业务需求选择适配的套餐。如果套餐中包含每月流量，如果每月流量超出套餐外的公网出流量会产生额外费用。关于计费的更多信息，请参见计费概述。如果套餐中不包含每月流量，表示流量可无限使用，不收取公网流量费用。
数据盘	0GB	可选。如果您的业务需要更大的存储设备，可以选择自定义大小的数据盘。
购买时长	1个月	选择购买服务器的时长。您可以选择是否开启到期自动续费功能。
购买数量	1	选择购买服务器的台数。

单击立即购买，根据界面提示完成付费操作。
当服务器状态从准备中变更为运行中后，表示服务器已经搭建成功。
（条件必选）如果您在创建轻量应用服务器时挂载了数据盘，则必须创建分区和文件系统才能使数据盘变为可用。具体操作，请参见分区格式化数据盘。

步骤二：登录MaxKB

放行端口并获取MaxKB登录信息。
1. 在服务器页面，单击服务器卡片中的实例ID。
  进入服务器概览页面。
2. 单击应用详情页签，放行所需端口并获取MaxKB首页地址、管理员账号和密码。
  具体操作说明：
  1. 在图中①区域，单击一键放通，放通MaxKB所需的8080端口。
  2. 在图中②区域，获取MaxKB首页地址http://47.178.XX.XX:8080。
  3. 在图中③区域，单击快速查看，在弹出的快速查看对话框中，获取MaxKB默认管理员用户名和密码。
登录MaxKB。
在本地电脑中，在浏览器中输入MaxKB首页地址http://47.178.XX.XX:8080，并输入默认管理员用户名和密码后，单击登录。首次登录后，请根据界面提示及时修改默认密码，避免造成数据泄露。

步骤三：使用MaxKB

本步骤主要介绍使用MaxKB制作企业知识库小助手的基本流程，关于MaxKB的更多使用，请参见MaxKB官方文档。

1. 添加模型

2. 创建知识库

3. 创建应用

4. 应用集成

模型管理用于对接供应商的大语言模型，支持对接主流的大模型，支持的类型包括文本生成、向量模型、重排、语音识别、语音合成、视觉模型、图片生成等。更多信息，请参见模型管理。

在左侧顶部菜单，单击系统设置。
在左侧导航栏，单击模型设置。
在模型设置页面，单击添加模型。
根据界面提示，选择模型供应商。
本示例选择阿里云百炼。

根据界面提示，设置模型参数后，单击保存。

不同模型对应的参数可能不同，其他模型，请参见模型对接。

参数	说明	示例
模型名称	输入MaxKB中自定义的模型名称。	qwen-turbo
权限	按需选择权限：私有：仅当前用户使用。公有：所有用户都可以使用。	私有
模型类型	下拉列表选择模型类型。	大语言模型
基础模型	在下拉列表中选择模型。	qwen-turbo
API域名	输入模型服务API服务访问地址，本示例直接输入`https://dashscope.aliyuncs.com/compatible-mode/v1`即可。目前仅当模型类型是大语言模型时需要输入。	https://dashscope.aliyuncs.com/compatible-mode/v1
API Key	输入模型服务API服务访问密钥。本示例您需要在阿里云百炼控制台获取API Key。具体操作，请参见获取API Key。	sk-88473bc3a451436aa9e172ff4a43****

企业私有的专业知识库，包含各种类型的数据，是问答对话中回答用户问题的知识来源。关于知识库的更多信息，请参见知识库。

在左侧顶部菜单，单击知识库。
在知识库页面，单击创建知识库。

在弹出的创建知识库对话框中，配置参数。

参数	说明	示例
知识库名称	请输入知识库名称。	test
知识库描述	请输入知识库描述信息。	-
向量模型	在下拉列表中，选择向量模型。	maxkb-embedding
知识库类型	按需选择知识库模型：通用型：对离线文档上传管理，支持的文本文件、表格以及 QA 问答对。 web站点：用于获取在线静态文本数据管理，输入Web站点地址后，自动同步根地址及子级地址的文本数据。	web站点
Web根地址	输入文档的根目录。本示例输入轻量应用服务器帮助文档的根目录。	https://help.aliyun.com/zh/simple-application-server/

单击创建后，查看文件状态。
请耐心等待，系统会自动爬取根地址及子地址的文本数据，按照URL地址生成文档，并自动拆分和进行向量化处理。当所有文档的文件状态由排队中变为成功，表示创建知识库完成。

本示例以创建轻量应用服务器产品智能问答小助手应用为例，更多信息，请参见应用。

创建应用。

在左侧顶部菜单，单击应用。
在应用页面，单击创建应用。
如果您已有对应的应用，单击导入应用。

在弹出的创建应用对话框中，根据界面提示配置参数后，单击创建。

参数	说明	示例
应用名称	请输入应用名称。	AI智能小助手
应用描述	请输入该应用的应用场景及用途。	轻量应用服务器产品智能问答
选择应用类型	按需选择应用类型：简单配置：适合新手创建小助手。高级编排：适合高级用户自定义小助手的工作流。	简单配置

在设置页面，根据界面提示配置参数。

关键参数说明如下，其他参数请按需配置。

参数	说明	示例
AI模型	在下拉列表中选择已添加的模型。	qwen-turbo
系统角色	请输入角色信息。	你是智能问答小助手
提示词	系统默认有智能知识库的提示词，用户可以自定义通过调整提示词内容，引导大模型聊天方向。可对无引用知识库和引用知识库两种情况分别设置不同的提示词。	{question}
关联知识库	单击添加，选择已创建的知识库。	-
开场白	输入用户打开对话时，系统弹出的问候语。	您好，我是智能问答小助手，您可以向我提出使用轻量应用服务器的问题。 - 主要功能有什么？ - 如何收费？ - 转人工服务

在调试预览区域，调试后在页面右上角，单击保存并发布。

验证结果。
1. 在左侧导航栏，单击概览。
2. 在概览页面单击演示或在浏览器中复制公开访问链接。
3. 进入问答页面，输入问题进行提问。

MaxKB应用支持零编码快速嵌入第三方Web系统，嵌入代码后，便可在第三方系统中进行问答。

在应用信息区域中，单击嵌入第三方。
在弹出的嵌入第三方对话框中，根据需求在全屏模式或者浮窗模式中，单击图标，复制对应的嵌入代码。
嵌入完成后，便可在第三方系统中进行问答。
嵌入后的效果如下：