📘 鸿蒙智能体实战记录 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：年俗效果
重点检查内容层次是否清晰，阅读体验是否顺畅。
五、本篇完成内容
- 完成快捷指令统一配置
- 配置测试白名单支持真机调试
- 在真机逐条验证所有能力
- 确认卡片渲染与链路正常
至此，智能体已完成从配置到真机验证的完整闭环，所有指令均可稳定触发并正确返回结果，为后续优化体验与正式发布提供了可靠基础。同时，这一阶段也验证了链路的稳定性，为扩展更多能力提供了良好基础。