实战：在华为云上快速搭建 openJiuwen Agent 平台，并开发一个“诗词雅集”知识库智能体

前言

随着人工智能的不断发展，大语言模型技术日益成熟。AI应用已经从最初专注于语音识别等简单任务的应用，演进到能够进行自主推理决策，完成复杂任务的Agent。各行各业场景中，AI Agent都展示出巨大的应用潜力，广泛应用于客户支持、销售拓展、医疗诊断和金融分析等场景。

openJiuwen作为开源Agent平台，致力于提供灵活、强大且易用的AI Agent开发与运行能力。基于该平台，开发者可快速构建处理各类简单或复杂任务的AI Agent，实现多Agent协同交互，高效开发生产级可靠AI Agent；并助力企业与个人快速搭建AI Agent系统或平台，推动商用级Agentic AI技术广泛应用与落地。

openJiuwen 项目核心组件：

●Agent Studio（智能体工作室）：https://atomgit.com/openJiuwen/agent-studio

可视化智能体开发平台，提供拖拽式编排能力

●Agent Core（智能体核心）：https://atomgit.com/openJiuwen/agent-core

智能体核心引擎，提供Agent开发、运行、调优与演进相关的全套SDK能力

一、openJiuwen 部署

这里我们使用openJiuwen的最新版本：v0.1.2版本，该版本更新引入了知识库功能、内置沙箱能力等多项新特性，同时修复了若干问题，提升了系统的稳定性和用户体验。

官方下载安装指南：https://www.openjiuwen.com/download

前置部署环境条件：

1、部署到华为云开发者空间（Linux）

博主这里决定将其部署到我的华为云开发者空间上，当然你也可以选择部署到自己电脑上，这里选择灵活。

首先，我们访问华为云开发者空间, 打开开发平台-云开发环境-开发桌面，创建一个鲲鹏的Ubuntu的开发桌面：

2、点击远程桌面，进入到远程环境

3、Docker安装

部署之前需要先安装 Docker，点击菜单栏中的Open Termimal Here，打开命令行窗口。执行如下命令，下载Docker自动化安装脚本。

bash 复制代码

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

4、进入下载目录，执行如下命令，进行安装 Docker。

bash 复制代码

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

5、验证docker版本

等待安装完成，并验证版本，版本验证成功，表示你已经完成安装。

bash 复制代码

docker --version
docker compose version

6、下载 openJiuwen 版本包

执行如下命令，下载 openJiuwen agent-studio 版本包

bash 复制代码

wget https://openjiuwen-ci.obs.cn-north-4.myhuaweicloud.com/agentstudio/deployTool_0.1.2_arm64.zip

7、执行如下命令，解压该版本包和确认 Docker 已启动。

安装 unzip 工具

bash 复制代码

sudo apt update && sudo apt install unzip -y

解压 arm 架构版本包，进入 deployTool_0.1.2_arm64 目录，输入以下命令确认 Docker 已启动：

bash 复制代码

# 解压下载的 arm 架构版本包
unzip deployTool_0.1.2_arm64.zip

# 进入 deployTool_0.1.2_arm64 目录
cd deployTool_0.1.2_arm64

#启动 docker 并查看状态：
sudo systemctl start docker
sudo systemctl status docker

docker启动正常

8、输入以下命令启动 openJiuwen：

bash 复制代码

sudo ./service.sh up

安装过程中，v0.1.2版本由于新增对 SQLite 轻量级数据库的支持，安装部署流程简化，很快就安装好了。

启动成功后会输出：

bash 复制代码

Local access: 本地访问地址

Network access: 网络访问地址

9、输入网址，访问即可

到这里你就成功部署了openJiuwen智能体平台。

二、使用openJiuwen 开发一个"诗词雅集"知识库智能体

1、准备阶段

1.1 配置LLM大模型（智能体问答使用）

进入LLM模型管理界面，点击"添加模型"。在模型配置界面中，依次填入模型名称、模型类型、API_KEY、基础URL以及模型描述。

模型名称：系统显示名称，用户可自定义。
模型类型：由模型服务提供商定义的调用名称，可在各提供商的官方网站查询。
API_KEY：模型的API Key
基础URL：由模型服务提供商定义的API地址，可在各提供商的官方网站查询。
模型描述：模型的详细描述，用户可自定义

博主这里体验使用的是Atomgit平台的大模型API，有一定免费token使用量，这里大家也可以使用自己熟悉云平台的大模型API。

地址自取：https://ai.atomgit.com/serverless-api

博主选择的是 DeepSeek R1 模型，如图中切换到 openai 页签，取到API调用的关键信息-- BaseUrl 、API Key 、Model ID 。

BaseUrl ： https://api-ai.gitcode.com/v1 （这里实际上后面有个V1 ，别被误导了）
API Key ：你的体验api_key
Model ID: deepseek-ai/DeepSeek-R1

回到openJiuwen平台后，输入信息，点击模型连接测试, 测试结果正常，表示配置成功

配置成功后回到列表界面：

1.2 配置embedding模型（知识库使用）

进入embedding模型管理界面，点击"添加模型"。在模型配置界面中，依次填入模型名称、模型类型、API_KEY、基础URL以及参数配置。

博主这里使用的是阿里云的文本向量模型：

获取到模型相关参数后进行配置并验证，提示测试成功后即表示模型配置成功

1.3 构建诗词知识库

最新的studio v0.1.2版本支持了知识库功能，支持高效的文档索引构建与信息检索和支持在智能体构建时绑定知识库

这里我们切换到知识库管理，新建知识库，输入知识库名称、描述、和选择embedding模型

创建好之后，上传文档到知识库

博主这里将古诗词数据库的诗词数据集上传到知识库中，共计文档十几篇，涵盖唐宋古诗词十几万首

文档上传完成之后，等待embedding 模型进行解析、分段和清洗。

等待所有文档都处理完成我们的诗词知识库就编辑完成了

2、搭建智能体

在准备好所需的模型与插件后，进入智能体开发界面，点击"创建智能体"按键，选择单Agent模式。这里我们创建一个诗词雅集智能体。

智能体开发界面主要由三部分组成：

左侧为系统提示词配置，用户可根据需求自由设定提示词；
中间为智能体的编排配置，包括模型选择、技能设置、知识管理以及开场白，当前 openJiuwen 支持多种技能的配置，如记忆管理、知识管理和插件配置。
右侧为调试预览区域，用户可在此与已配置的智能体进行实时交互

2.1 系统提示词配置

在系统提示词配置中，输入预先准备好的提示词，例如：

复制代码

你是精通中国古典诗词的智能体"诗词雅集"，兼具学者严谨与诗人灵性。请按以下规则交互：

一、创作时：
1. 先确认主题、风格、格律要求
2. 生成符合平仄对仗的作品
3. 提供格律分析、意象解读、创作思路
4. 可应要求提供白话译文

二、赏析时：
1. 分析格律、对仗、用典
2. 解读意境与情感层次
3. 关联历史背景与诗人经历
4. 对比同类题材作品

三、教学时：
1. 用比喻解释专业概念
2. 设计渐进式练习
3. 纠正错误时引用经典例证

四、默认回应：
1. 语言文白相间，优雅自然
2. 适当使用诗词典故
3. 复杂分析配简单总结
4. 鼓励用户尝试创作