📘 鸿蒙智能体实战记录 12

快捷指令配置与真机逐条验证实现

---

一、本篇目标

完成以下内容：

• 完整配置快捷指令入口
• 在真机环境逐条验证指令效果
• 打通「快捷指令 → 工作流 → 卡片」链路
• 配置测试白名单支持真机调试

在前面能力搭建完成后，本篇重点从“配置完成”过渡到“真实可用”，确保每一个入口都能在真机侧稳定触发，并输出符合预期的结构化内容，避免仅在编排侧可用但实际不可用的情况。

---

二、快捷指令配置

进入：

编排 → 快捷指令

配置如下指令（仅列文案与内容）。

这些快捷指令本质上是对用户高频使用场景的抽象，通过固定表达方式，让智能体可以精准命中对应工作流，从而减少自然语言理解误差，提高触发成功率与响应一致性。

---

2.1 写一副春联

快捷指令文案：写一副春联
指令内容：帮我写一副马年春联

用于验证结构化生成能力，重点关注上下联对仗、语义连贯以及横批是否完整。

---

2.2 温柔贺词

快捷指令文案：温柔贺词
指令内容：写一段温柔风格的新春贺词

用于验证风格类输出能力，确保整体语气稳定、柔和，并具备一定情绪表达。

---

2.3 节气知识

快捷指令文案：节气知识
指令内容：介绍一下立春

用于验证知识型内容生成，重点在信息完整度与结构清晰度。

---

2.4 年俗文化

快捷指令文案：年俗文化
指令内容：讲讲贴春联的来历

用于验证长文本生成能力，以及多段落内容的逻辑组织。

---

2.5 一句祝福

快捷指令文案：一句祝福
指令内容：生成一句简短的新春祝福

用于验证短文本输出能力，要求精炼、有表达力。

---

2.6 今日节气

快捷指令文案：今日节气
指令内容：今天是什么节气

用于验证实时类问题响应能力，以及返回内容的准确性。

---

三、真机调试前准备（测试白名单）

进入：

测试白名单

该步骤用于控制测试范围，只有被加入白名单的账号，才能在真机侧访问当前智能体能力，避免未发布状态下被外部用户触发。

---

3.1 新建用户组

点击「新建用户组」，填写：

用户组名称：test

📷 图 1：新建用户组

该步骤用于统一管理测试账号，后续可以批量扩展，适合多人协同测试场景。

---

3.2 添加测试用户

进入「管理用户」，点击「添加用户」，填写：

账号类型：手机号
手机号：测试设备登录账号
设备ID：可选
备注：测试账号

📷 图 2：添加用户

添加完成后，需要确认测试设备使用该手机号登录小艺 App，否则白名单不会生效。

---

四、真机逐条验证

在小艺 App 打开智能体，依次点击快捷指令进行验证。

验证过程中不仅要确认“是否有返回”，还要检查“返回是否正确”，包括字段完整性、卡片样式、内容质量等多个维度。

---

4.1 写一副春联

验证：

• 触发春联工作流
• 返回春联卡片
• 上下联与横批完整

📷 图 3：春联效果

重点观察对仗是否自然，以及内容是否符合节日语境。

---

4.2 温柔贺词

验证：

• 触发贺词工作流
• 返回贺词卡片
• 内容为温柔风格

📷 图 4：贺词效果

重点检查语气统一性，避免出现风格漂移。

---

4.3 节气知识

验证：

• 触发节气工作流
• 返回节气卡片
• 各字段完整展示

📷 图 5：节气效果

重点关注信息是否完整、无缺失字段。

---

4.4 年俗文化

验证：

• 触发年俗工作流
• 多区块内容完整
• 信息结构清晰

📷 图 6：年俗效果

重点检查内容层次是否清晰，阅读体验是否顺畅。

---

五、本篇完成内容

• 完成快捷指令统一配置
• 配置测试白名单支持真机调试
• 在真机逐条验证所有能力
• 确认卡片渲染与链路正常

至此，智能体已完成从配置到真机验证的完整闭环，所有指令均可稳定触发并正确返回结果，为后续优化体验与正式发布提供了可靠基础。同时，这一阶段也验证了链路的稳定性，为扩展更多能力提供了良好基础。