📘 鸿蒙智能体实战记录 04

节气知识查询工作流：单节点结构化输出与字段完整性控制

---

一、开发目标

本篇实现第三个能力 —— 节气知识查询。

与春联、贺词不同，节气查询属于：

信息类结构化输出
内容准确性优先
字段完整性优先

目标输出字段：

term_name
term_date
term_meaning
term_customs
term_health

要求：

• 输出为标准 JSON
• 字段固定
• 不出现额外解释文本
• 信息结构稳定

---

二、新建工作流

2.1 配置路径

工作流 → 新建工作流

2.2 工作流命名

命名规则：

• 仅允许字母、数字、下划线
• 必须以字母开头

本次命名为：

workflow_solar_term_query

工作流描述：

根据用户输入查询节气相关知识并结构化输出

📷 图 1：新建节气工作流界面

---

三、搭建节点结构

本工作流采用单大模型节点结构：

开始节点
   ↓
查询节气信息
   ↓
结束节点

📷 图 2：节气工作流结构界面

---

四、开始节点配置

新增输入字段：

solar_term		Str. String

说明：

• solar_term：节气名称（如立春、雨水、惊蛰等）

📷 图 3：开始节点字段配置界面

---

五、大模型节点重命名

将默认“大模型”重命名为：

查询节气信息

后续变量来源将显示为：

查询节气信息-term_name

📷 图 4：大模型节点重命名界面

---

六、大模型节点配置

点击 查询节气信息 进入编辑界面。

---

6.1 输入绑定

solar_term ← 开始-solar_term

📷 图 5：输入变量绑定界面

---

6.2 系统 Prompt

填写：

你是一名中国传统节气文化讲解助手。

根据用户输入的节气名称，提供准确、结构化的信息。

内容要求：
1. 节气名称解释准确
2. 提供大致公历时间范围
3. 说明节气含义
4. 列举相关习俗
5. 提供养生建议

输出规则：
1. 必须输出合法 JSON
2. 仅包含以下字段：
   term_name
   term_date
   term_meaning
   term_customs
   term_health
3. 不得输出额外说明文字
4. 字段顺序固定

📷 图 6：系统 Prompt 配置界面

---

6.3 用户 Prompt

填写：

查询节气：${solar_term}

请提供该节气的详细信息。

📷 图 7：用户 Prompt 配置界面

---

6.4 输出结构配置

输出格式选择：

JSON

添加字段：

term_name      Str. String
term_date      Str. String
term_meaning   Str. String
term_customs   Str. String
term_health    Str. String

📷 图 8：输出字段配置界面

---

七、结束节点配置

进入结束节点，设置返回变量：

term_name     ← 查询节气信息-term_name
term_date     ← 查询节气信息-term_date
term_meaning  ← 查询节气信息-term_meaning
term_customs  ← 查询节气信息-term_customs
term_health   ← 查询节气信息-term_health

📷 图 9：结束节点返回变量配置界面

---

八、调试运行

输入示例：

"solar_term": "立春"

输出示例：

{
  "term_name": "立春",
  "term_meaning": "立春是指春天的开始，标志着冬季的结束，万物开始复苏，天气逐渐变暖，气温回升。",
  "term_date": "2月3日至5日",
  "term_customs": "立春时节，民间有吃春饼、踏青、放风筝等习俗。人们还会在这一天进行祭祀活动，祈求来年风调雨顺、五谷丰登。",
  "term_health": "立春时节，天气多变，气温波动较大，需注意保暖，防止感冒。饮食上应多吃新鲜的蔬菜和水果，补充维生素，增强身体抵抗力。同时，适当进行户外活动，锻炼身体，增强体质。"
}

验证：

• 字段齐全
• JSON 结构正确
• 无额外文本
• 信息内容完整

📷 图 10：调试运行结果界面

---

九、本篇完成内容

• 创建节气查询工作流
• 单大模型节点结构设计
• 输入字段绑定
• 系统与用户 Prompt 编写
• JSON 输出结构定义
• 结束节点变量映射
• 调试与结构验证

至此，节气知识查询能力完成结构化实现。