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

用华为云部署MaxKB写作助手

原创于 2025-12-04 10:15:40 发布 · 238 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#华为 #华为开发者空间 #人工智能 #华为云开发者联盟

程序员同时被 3 个专栏收录

797 篇文章

订阅专栏

人工智能

270 篇文章

订阅专栏

华为开发者空间

150 篇文章

订阅专栏

一、概述

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. 案例流程

说明：

登录华为开发者空间，进入云主机，安装Docker；
Docker拉取镜像，启动MaxKB服务；
构建写作专栏助手应用，申请百万MaaS平台商用DeepSeek-R1模型免费tokens，配置应用大模型及其他配置；
发布写作专栏助手应用，浏览器测试智能对话。

5. 资源总览

本案例预计花费0元。

资源名称	规格	单价（元）	时长（分钟）
华为开发者空间 - 云主机	鲲鹏通用计算增强型 kc2 \| 4vCPUs \| 8G \| Ubuntu	免费	40

二、资源与基础环境准备

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

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

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

2. 领取百万免费token福利

参考案例《华为云MaaS大模型服务百万商用Tokens领取使用指导》中的“一、领取”章节内容，领取华为开发者空间百万token代金券福利，购买DeepSeek-R1 轻量体验包（¥7.00）。开通商用模型服务，最后获取API地址、model参数、API Key的参数值。

3. 安装Docker

下载Docker自动化安装脚本

在华为开发者空间-云主机桌面右键，选Open Termimal Here，打开命令行窗口。执行如下命令，下载Docker自动化安装脚本。

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

增加脚本执行权限

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

运行脚本，安装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 其他配置

系统提示词

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

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

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

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

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

开场白

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

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

2.4 保存并发布

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

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

3. 测试智能对话

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

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