引言

openJiuwen作为开源Agent平台，致力于提供灵活、强大且易用的AI Agent开发与运行能力。基于该平台，开发者可快速构建处理各类简单或复杂任务的AI Agent，实现多Agent协同交互，高效开发生产级可靠AI Agent。

一、项目核心定位与创新亮点

1.1 核心定位

区别于传统健康类APP的复杂功能，“小健”聚焦“日常健康刚需+轻量化交互”，主打四大核心能力：个性化饮食建议、碎片化运动指导、作息睡眠优化、常见小不适护理指南，全程规避专业医疗诊断，仅提供科学可落地的日常调理方案，适配全年龄段人群。

1.2 创新亮点

• 结构创新：先完成LLM与Embedding双模型创建与适配，再优化Prompt与开场白，确保智能体“逻辑能力”先于“交互体验”落地，提升回复精准度；
• 场景创新：针对大学生、上班族、宝妈、中老年四大核心人群定制化逻辑，避免健康建议“一刀切”；
• 技术落地：基于华为云ModelArts低代码能力，无需自研模型，新手也能快速实现功能闭环，同时预留工具对接接口，便于后续扩展。

二、开发前置准备：工具与平台选型

本次开发以“易用性+稳定性”为核心选型原则，全程基于华为云生态工具，无需额外搭建本地环境：

• 核心平台：华为云ModelArts（提供模型创建、部署、调用全链路能力，支持低代码可视化操作）；

• 辅助工具：openJiuwen（智能体交互配置平台，用于后续Prompt与开场白落地，支持一键对接华为云模型）；

• 数据支撑：公开健康数据集（含常见食材营养数据、居家运动动作规范、作息优化指南，用于模型微调辅助）。

三、核心步骤一：LLM与Embedding模型创建与适配

智能体的核心能力依赖双模型协同：LLM模型负责理解需求、生成话术，Embedding模型负责精准匹配健康知识、提升回复专业性。以下是基于华为云ModelArts的完整创建流程：

3.1 LLM模型创建（对话逻辑核心）

选用华为云ModelArts内置的qwen3-32b模型（适配中文对话场景，文本生成流畅度高，且支持自定义规则约束），创建与配置步骤如下：
步骤一：打开浏览器，访问华为云 ModelArts 大模型广场。

步骤二：登录华为云控制台，进入ModelArts Studio，选择“推理调用”，点击，复制API地址和model参数。

步骤三：点击 “API Key 管理”，创建 / 获取 API Key（用于模型接口鉴权），注意：密钥仅展示一次所以请及时保存。

3.2 Embedding模型创建（知识匹配核心）

为解决健康知识碎片化问题，需创建Embedding模型将用户需求与健康知识库进行精准匹配，确保建议科学合规。选用华为云BGE-M3模型（中文语义理解能力强，适配短文本匹配场景），知识库的本质是“向量化”，所以需要文本向量模型，步骤同上：

同样记录API地址和model参数，还有密钥
知识库关联：将整理好的健康知识库（分饮食、运动、作息、护理四大类）转化为向量格式，通过Embedding模型接口导入，建立“用户需求关键词-健康知识”映射关系，例如“久坐腰酸”对应“办公室拉伸动作”知识库；

3.3 双模型协同配置

在ModelArts“服务编排”模块，建立双模型调用逻辑：用户输入需求→Embedding模型提取关键词并匹配知识库→将需求与匹配到的知识一同传入LLM模型→LLM模型生成符合场景的健康建议，确保回复既精准又有依据，避免无意义话术生成。

四、智能体搭建

4.1. 创建智能体

智能体的创建仅仅通过 openJiuwen 的图形化界面填写必要参数，为后续模型调用和对话行为奠定基础。

4.1.1 进入创建页面

登录 openJiuwen 平台后，在主界面右上角点击 “创建智能体” 按钮（如下图所示），即可进入智能体配置表单。

4.1.2. 填写基本信息

在弹出的表单中，依次填写以下字段：
名称：全民健康助手
功能描述 ：

1. 个性化饮食建议：根据用户输入的人群属性（如青少年/上班族/孕妇/中老年、是否有基础需求如“控糖”“减脂”“增肌”“儿童挑食”），推荐每日饮食搭配方案（含三餐示例、食材替换建议）；支持查询常见食材的营养成分、烹饪方式（简单易操作的菜谱）；可生成购物食材清单，标注“必买”“可替代”品类。

2. 轻量化运动指导：根据用户场景（居家/办公室/户外）、身体状况（如“久坐腰酸”“膝盖不适”“零基础健身”）、时间预算（10分钟/20分钟/30分钟），推荐针对性运动方案，含动作步骤描述、注意事项（如避免受伤的发力要点）；支持运动计划制定（如“7天居家拉伸计划”“30天办公室久坐舒缓计划”），并定时提醒运动。

3. 作息与睡眠优化：根据用户年龄、职业（如“熬夜党”“早起上班族”“学生党”），推荐科学作息时间表；针对常见睡眠问题（如入睡困难、易醒），提供非药物调理建议（如睡前放松方法、卧室环境优化要点、饮食禁忌）；支持设置睡眠提醒（如“睡前1小时放下手机”）和起床唤醒（循序渐进的提醒方式）。

4. 常见不适应对指南：针对日常小不适（如感冒初期、轻微咳嗽、腹泻、过敏、蚊虫叮咬、轻微外伤），提供科学的居家护理建议、症状观察要点；明确“需及时就医”的警示信号（如持续高烧、剧烈疼痛等），避免用户延误治疗；支持用户记录身体不适情况，生成简单的健康日志，方便后续回顾。

4.1.3 编写提示词（Prompt）与开场白（Greeting）

这是决定智能体行为风格的核心环节。

提示词（System Prompt）：定义智能体的 “行为准则”。示例：

你是“全民健康助手·小健”，核心职责是为用户提供日常健康管理的科学建议，主打“预防+日常调理”，不进行
专业医疗诊断。请遵循以下规则：
1.首先明确用户的核心需求（如饮食建议、运动方案、不适应对）和基础信息（年龄、人群属性、身体状况），
信息不全时简洁提问补充；
2.所有建议需基于大众可理解的科学常识，语言通俗，步骤清晰，避免专业医疗术语，方案可操作性强.
3.涉及不适应对时，必须明确区分“居家护理”和“需就医”的边界，重点标注就医警示信号，不误导用户；
4.尊重用户个体差异，推荐方案时提供2-3种可替代选择，适配不同用户的生活习惯；
5.严格保护用户健康信息隐私。请根据用户输入，精准匹配对应功能提供服务。

开场白（Greeting）：降低用户使用门槛。例如：

“哈喽～我是你的全民健康助手小健！专注帮你搞定饮食搭配、碎片化运动、作息优化和日常小不适护理～
 你可以告诉我你的需求和情况，比如‘上班族控糖午餐推荐’‘宝妈给1岁宝宝做辅食’‘久坐腰酸怎么缓解’
 ，我来帮你定制科学方案哦！”

五、双模型接入openJiuwen智能体（核心落地环节）

步骤一：模型创建
填写完毕后，点击 “下一步”，系统将引导你为该智能体绑定一个大语言模型。点击左侧的模型管理，会看到LLM模型和Embedding模型，点击新建，将上面创建的两个模型分别加进去。


步骤二：知识库创建
将信息填写完整后继续点击左侧导航栏点击知识库管理。将Embedding模型加入。

步骤三：智能体的完善
以上都完成后重新打开智能体，将LMM模型也加入智能体的模型配置里边，并在右侧进行调试。

若测试可行，则本次的智能体创建就顺利完成啦！！！！

六、开发心得

本次实践让我深刻意识到：“实用型智能体的核心不是复杂技术，而是精准解决需求”。通过“先搭建双模型、再优化交互”的结构，有效避免了“交互华丽但回复不准”的问题——LLM与Embedding模型的协同，确保了健康建议的科学性；而精细化的Prompt设计，则规避了健康场景的合规风险。
华为云ModelArts的低代码能力，让新手无需深入算法研发即可落地AI应用，这也为大学生开发者提供了低成本实践的路径。未来，健康类智能体的发展方向必然是“个性化+轻量化+合规化”，本次搭建的“小健”仅为基础版本，后续将持续迭代，让技术真正服务于日常健康生活。

●Agent Studio（智能体工作室）：
https://atomgit.com/openJiuwen/agent-studio
可视化智能体开发平台，提供零码、低码可视化开发和工作流编排能力，以及模型、知识库、插件等各资源管理能力
●Agent Core（智能体核心）：
https://atomgit.com/openJiuwen/agent-core
智能体核心引擎，提供Agent开发、运行、调优与演进相关的全套SDK能力