案例共创】基于华为开发者空间云主机部署 maxKB+MaaS 大模型构建写作专栏助手

一、概述

1. 案例介绍

华为开发者空间，是为全球开发者打造的专属开发者空间，致力于为每位开发者提供一台云主机、一套开发工具和云上存储空间，汇聚昇腾、鸿蒙、鲲鹏、GaussDB、欧拉等华为各项根技术的开发工具资源，并提供配套案例指导开发者 从开发编码到应用调测，基于华为根技术生态高效便捷的知识学习、技术体验、应用创新。

ModelArts Studio（MaaS）平台，是华为云推出的一款大模型即服务平台，可以一站式的对业界主流开源大模型进行部署托管，同时开放大模型 API 服务，可以结合业界主流 Agent 开发框架，进行并轻松的构建 AI Agent 应用。

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

本案例将基于华为开发者空间 - 云主机以 Docker 的方式部署 MaxKB 服务，配置以华为云 MaaS 平台免费的百万 DeepSeek-R1 模型商用 tokens 构建写作专栏助手。

2. 适用对象

• 企业

• 个人开发者

• 高校学生

3. 案例时间

本案例总时长预计 40 分钟。

4. 案例流程

说明：

1. 登录华为开发者空间，进入云主机，安装 Docker；

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

3. 构建写作专栏助手应用，申请百万 MaaS 平台商用 DeepSeek-R1 模型免费 tokens，配置应用大模型及其他配置；

4. 发布写作专栏助手应用，浏览器测试智能对话。

二、资源与基础环境准备

1. 华为开发者空间-云主机

进入华为开发者空间-工作台，在我的云主机卡片，点打开云主机 > 进入桌面。

注：若尚未配置云主机，在工作台界面点配置云主机，参考下图配置信息配置，最后点安装。

2. 领取百万免费 token 福利

参考案例《华为云MaaS大模型服务百万商用Tokens领取使用指导》中的“一、 领取”章节内容，领取华为开发者空间百万token代金券福利，购买DeepSeek-R1 轻量体验包（¥7.00）。开通商用模型服务，最后获取 API 地址、model 参数、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. 构建写作专栏助手应用

2.1 创建应用

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

样例：

• 名称：写作专栏助手

• 描述：写作专栏助手是专为文字工作者设计的智能工具，通过 AI 技术提供从构思到成文的全程支持。

2.2 配置大模型

完成创建后，进入应用设置界面，点 AI 模型 > 添加模型。选择模型供应商 OpenAI，然后配置 OpenAI。

在基础信息页签，参考如下样例信息配置，然后点保存。

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

添加模型成功后，再次点击 AI 模型，在下拉菜单中选择添加的 DeepSeek。

2.3 其他配置

1. 系统提示词

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

人设：写作专栏助手角色：专业文字创作辅助AI特长：  选题策划与头脑风暴  文章结构优化与逻辑梳理  风格化写作（如学术、幽默、新闻等）  语法校对与润色  多语言翻译与本地化适配任务描述：1. 核心目标：帮助用户高效完成专栏文章的创作全流程，包括但不限于：  生成选题建议与大纲  提供段落扩展与案例参考  优化语言表达与逻辑连贯性2. 预期影响：  缩短用户50%以上的写作时间  提升文章专业度与读者吸引力

2. 用户提示词 (无引用知识库)

参考如下样例，填写用户提示词 (无引用知识库)，然后点确定。

你可以帮助用户回答创作方面的任何知识，当用户向你进行提问时，你必须礼貌回答，时刻保持谦逊礼貌，注意，一定要中文回复。

3. 开场白

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

您好，我是写作专栏助手，您可以向我提出写作方面的问题。  如何写好一篇文章？  文章有哪些分类？

2.4 保存并发布

点右上角的保存、发布按钮，发布写作专栏助手应用。

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

3. 测试智能对话

复制概览页的公开访问连接，在浏览器中打开，输入测试问题：“如何写好一篇文章？”，写作专栏助手做出正确回应。

至此，基于华为开发者空间云主机部署 maxKB+MaaS 大模型构建写作专栏助手案例结束，各位小伙伴快来华为开发者空间 - 云主机实操吧。