【案例共创】华为开发者空间 - 云开发环境（开发桌面）部署 maxKB+MaaS 大模型搭建 AI 理论智库

最新案例动态，请查阅【案例共创】华为开发者空间-云开发环境（开发桌面）部署maxKB+MaaS大模型搭建AI理论智库。小伙伴们快来领取华为开发者空间进行实操吧！

本案例由开发者：鸢尾离夏提供

一、概述

1. 适用对象

• 个人开发者

• 高校学生

2. 案例流程

MaxKB(Max Knowledge Brain)是一个基于大语言模型和 RAG 的开源知识库问答系统，它支持多种大模型。其通过与大模型的对接，可快速的打造出适合企业级的智能体系 AI Agent。

本案例将基于华为开发者空间 - 云开发环境（开发桌面），以 Docker 的方式部署 MaxKB 服务，配置以华为云 MaaS 平台的 DeepSeek-R1 模型商用 tokens，快速搭建 AI 理论智库。

在实际操作过程中，我们将逐步拆解利用 MaxKB 打造私有知识库与专业级 Agent 的全过程，帮助大家深入理解。开发者通过此次实操，不仅能熟练掌握 MaxKB 的使用技巧，还能高效运用 MaaS 平台的强大功能，为后续应用开发注入强劲动力，实现从理论认知到实践落地的飞跃 。

说明：

1. 登录华为开发者空间，进入云开发环境（开发桌面），安装 Docker；

2. Docker 拉取镜像，启动 MaxKB 服务；

3. 构建 AI 理论智库助手应用，申请百万 MaaS 平台商用 DeepSeek-R1 模型免费 tokens，配置应用大模型及其他配置；

4. 发布 AI 理论智库助手应用，浏览器测试智能对话。

3. 资源总览

本案例预计花费 1 元。

二、环境和资源准备

1. 创建云开发环境

登录华为开发者空间，点击菜单 开发平台 > 云开发环境 > 开发桌面，创建云开发环境 - 开发桌面。

创建完成后，操作开发桌面开机，然后打开远程桌面。

2. 获取华为云 MaaS 免费 Token

登录华为开发者空间，参考案例《华为云MaaS平台商用大模型Tokens领取使用指导》中的“二、 领取 MaaS 平台商用大模型 Tokens”章节内容，领取 MaaS 平台商用大模型 Tokens，购买 DeepSeek-R1 轻量体验包，开通商用模型服务，最后获取到模型的 API 地址、模型名称和 API Key。

3. 安装 Docker

1. 下载 Docker 自动化安装脚本

在开发桌面右键，选 Open Termimal Here，打开命令行窗口。执行如下命令，下载 Docker 自动化安装脚本。

git clone https://gitcode.com/sinat_41661654/install_docker-ubuntu.git

2. 增加脚本执行权限

cd install_docker-ubuntu/chmod +x install_docker-ubuntu.sh 

3. 运行脚本，安装 Docker

./install_docker-ubuntu.sh

注：在执行到脚本第二个步骤时，需根据提示按回车键以继续自动化安装。

三、创建 MaxKB 智能体

1. Docker 启动 MaxKB

在命令行窗口输入以下命令，自动拉取 MaxKB 镜像，启动 Docker 容器。

sudo docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data -v ~/.python-packages:/opt/maxkb/app/sandbox/python-packages registry.fit2cloud.com/maxkb/maxkb

启动成功后，在开发桌面 > 浏览器中打开http://127.0.0.1:8080/admin/login。跳转MaxKB应用界面，首次登录使用默认账号密码。（用户名：`admin`，密码为：`MaxKB@123..`)

首次登录成功后需要设置 admin 用户新密码。

注：密码必须为 6-20 个字符，且必须包含大小写字母、数字和特殊字符。

新密码设置成功后，使用新密码重新登录 MaxKB。

2. 构建 AI 理论智库

2.1 配置大模型

在 MaxKB 工作台页面选择模型页签，点右上角的添加模型，选择模型供应商 OpenAI。

参考如下样例信息配置 MaaS 平台 DeepSeek-R1 大模型，然后点保存。

模型名称：DeepSeek模型类型：大语言模型基础模型：DeepSeek-R1，步骤“2. 获取华为云 MaaS 免费 Token”中获取到的 model 参数。（注意：下拉选项中不包含此选项，输入模型名称，回车即可添加）API URL：https://api.modelarts-maas.com/v2，步骤“2. 获取华为云 MaaS 免费 Token”中获取到的 API 地址（注意删除其尾缀/chat/completions）。API Key：步骤“2. 获取华为云 MaaS 免费 Token”中获取到的 API Key。

2.2 创建知识库

在 MaxKB 工作台页面选择知识库页签，点右上角的创建，选择通用知识库。

参考如下样例信息配置知识库，然后点创建。

知识库名称：AI理论智库，可根据实际情况自定义。知识库描述：知识库中包含与AI相关的基础理论知识，可根据实际情况自定义。向量模型：maxkb-embedding，公有的向量模型。

在华为开发者空间-开发桌面右键，选 Open Termimal Here，打开命令行窗口。执行如下命令，获取获取知识库资料。

git clone https://gitcode.com/sinat_41661654/AILibrary.git

创建好后进入知识库界面，点击上传文档。

将我们提前准备好的文档上传到知识库中，然后点下一步。

选择智能分段，然后点开始导入。

导入成功后，文件状态为成功，启用状态为已启用。

2.3 创建 AI 理论智库助手

1. 创建应用

在 MaxKB 工作台页面应用 > 创建 > 简易应用，在创建简易应用对话框编辑名称及描述，然后点创建。

样例：

• 名称：AI 理论智库助手

• 描述：AI 理论智库助手是一款专注于人工智能领域知识整合与理论研究的智能应用。它能够系统梳理 AI 技术发展脉络，解析机器学习、深度学习等核心算法的原理与应用，并提供前沿研究动态、技术趋势分析及学术资源推荐。智库支持多维度知识检索与智能问答，帮助用户快速获取专业理论解释、技术对比及创新思路。主要服务于 AI 研究者、技术开发者、高校师生及科技企业决策者，致力于成为用户探索人工智能理论、把握技术发展方向的专业知识引擎，推动学术交流与技术创新。

2. 配置 AI 模型

选配“2.1 配置大模型”中创建的 DeepSeek 模型。

2. 配置应用系统提示词

参考如下样例，填写系统提示词，然后点确定。

人设：AI理论智库是一款专注于人工智能领域的知识整合与理论研究智能应用，扮演以下角色：  1. 知识整合者：系统梳理AI技术发展脉络，整合机器学习、深度学习等核心算法的原理与应用。  2. 前沿分析者：解析最新研究动态与技术趋势，提供学术资源推荐与创新思路。  3. 智能问答助手：支持多维度知识检索，快速响应用户的专业理论解释与技术对比需求。  专业技能：    - 精通机器学习、深度学习、自然语言处理等AI核心技术原理。    - 熟悉学术文献与行业报告，能够提供权威的技术分析与趋势预测。    - 具备结构化知识输出与智能问答能力，支持多语言交互。任务描述：  1. 核心目标：    - 帮助用户快速获取AI领域的专业理论解释、技术对比及创新思路。    - 提供前沿研究动态与技术趋势分析，辅助学术研究或技术决策。  2. 服务对象：    - AI研究者、技术开发者、高校师生、科技企业决策者。  3. 预期影响：    - 提升用户对AI理论的理解深度，缩短技术调研时间。    - 促进学术交流与技术创新，推动行业技术发展。约束条件：  1. 任务边界：    - 仅覆盖人工智能领域（如机器学习、深度学习、计算机视觉等），不涉及其他学科。    - 回答需基于公开权威资料或学术共识，避免主观推测。  2. 用户要求：    - 输出需逻辑清晰，术语准确，引用来源需标注（如适用）。    - 技术对比需包含至少3个维度的分析（如性能、适用场景、计算成本）。    - 趋势分析需提供近3年的关键研究或行业动态支持。

3. 关联知识库

点添加，选配“2.2 创建知识库”中创建的 AI 理论智库。

3. 开场白

参考如下样例，填写开场白，然后点确定。

您好,我是AI理论智库助手，您可以向我提出AI基础理论方面的问题，例如：- 什么是神经网络？- 强化学习架构有哪些？- 如何解释有监督学习？

2.5 保存并发布

点右上角的保存、发布按钮，发布 AI 理论智库助手应用。

保存，发布成功后，点左侧菜单栏的概览，可以查看应用信息、监控统计等信息。

3. 测试智能对话

复制概览页的公开访问连接，在浏览器中打开，输入测试问题：“什么是神经网络？”，AI 理论智库助手做出正确回应。

至此，基于华为开发者空间-云开发环境（开发桌面）部署 MaxKB+MaaS 大模型搭建 AI 理论智库案例结束，各位小伙伴快来华为开发者空间 - 云开发环境（开发桌面）实操吧。

反馈改进建议

如您在案例实操过程中遇到问题或有改进建议，可以到论坛帖评论区反馈即可，我们会及时响应处理，谢谢！