技能库 - 闹钟

「闹钟」是一项系统技能：让用户通过自然语言设置、查询、删除闹钟，由云端解析后下发结构化指令到端侧执行。

启用方式详见 技能配置;端侧协议与接入细节详见 §6.5 闹钟设置接入。

1. 能力说明

闹钟技能为设备提供语音定时提醒能力，用户通过自然语言完成闹钟的增删改查。

支持的功能模块：

功能模块	说明	示例
普通闹钟	支持单次 / 每天 / 按周重复的定时闹钟，可跨天、可带事件内容	"明早7点叫我""每天早上7点""周一到周五7点提醒我交报告"
间隔提醒	当天内按固定间隔重复提醒，不跨天、当天结束自动失效	"8点到9点每15分钟提醒我喝水""每30分钟提醒我看远处"

支持的操作：

操作	示例
创建	"明天早上7点叫我""从明天起每天7点到下周五"
删除	"取消明天7点的闹钟""把喝水的提醒删掉"
修改	"把7点的闹钟改成8点"（云端拆解为先删后建）
查询	"我有哪些闹钟""明天有什么提醒"
全部删除	"取消所有闹钟"

2. 工作方式

当前采用端侧管理方案：云端负责语音解析和指令生成，端侧负责存储、计时和响铃执行。

用户语音 → 云端（意图解析 + 时间换算 + 校验 + 指令生成） → 下发到端侧 → 端侧执行

云端负责：

• 语言理解与时间换算（相对时间→绝对时间）
• 合理性校验与多轮澄清
• 读取端侧上报的闹钟列表做判重/冲突检查
• 生成结构化指令下发
• 接收端侧回传，生成确认话术播报

端侧负责：

• 接收并执行指令（增/删/改）
• 本地存储、RTC 计时、到点响铃
• 打断处理（唤醒词/按键/触摸，品牌方至少选一种）
• 触发后处理（单次清除/重复保留/间隔到期失效）
• 闹钟列表上报云端

设备离线不影响响铃（数据存本地、RTC 触发），但设置闹钟需在线。

3. 能力边界

3.1 云端自动处理

以下场景云端直接拦截或追问，不需要端侧关心：

场景	处理
时间已过期 / 超过1年 / 农历 / 格式无法识别 / 间隔提醒跨天	拒绝并告知用户
缺必填信息（时间、间隔、结束时间等）	追问用户补充
删除条件模糊且可能命中多个	追问用户确认

3.2 端侧自行处理

云端对两种类型（普通闹钟、间隔提醒）的指令都会正常解析并下发。以下边界由端侧自己判断并直接回复用户（不经过云端）：

边界项	说明
闹钟个数上限	端侧按自身存储能力决定，达上限时端侧直接播报拒绝
时间范围	端侧按自身能力决定
关机响铃	取决于端侧 RTC 唤醒能力
类型支持	若端侧不支持某种类型（如间隔提醒），端侧直接播报不支持

4. 铃声与打断

4.1 铃声模式

模式	条件	表现
纯铃声	用户未说事件内容	循环播放本地预置铃声，最长 15 分钟
铃声 + TTS	用户说了事件内容（如"提醒我交报告"）	提示音 + TTS 播报内容

铃声由品牌方预置（推荐：MP3/WAV，5~15 秒循环，≤500KB），用户不可选择。

4.2 打断方式

闹钟响铃时的打断完全由端侧实现，品牌方至少选一种：

打断方式	打断后行为
唤醒词	停止播放 + 进入语音对话
物理按键	停止播放 + 回到待机
触摸 / 拍一拍	停止播放 + 回到待机

4.3 触发后处理

类型	触发后
普通闹钟 - 单次	清除
普通闹钟 - 重复（每天/按周）	保留，等待下次触发
间隔提醒	继续计时；到达结束时间或当天结束自动失效清除

5. 配置入口

1. 进入【产品管理】→ 打开目标产品的智能体【配置详情】
2. 在【技能列表】中添加【闹钟】技能
3. 添加后即启用，无需额外平台侧配置

平台侧开箱即用。端侧需按 §6.5 闹钟设置接入 实现下发协议(domain=alarm、op=add/delete/clear_all)、闹钟列表上报与响铃打断能力。

6. 注意事项

• 需要设备开发：闹钟技能依赖端侧实现存储、计时、响铃、打断能力，添加技能后仍需端侧配合开发
• 两种类型都会下发：云端不区分端侧是否支持间隔提醒，两种指令都会正常下发，端侧按能力自行处理
• 个数限制由端侧决定：云端不设上限，端侧按存储能力自行控制并直接回复用户
• 修改=先删后建：云端将修改拆解为删除+创建两条指令顺序下发

7. Q&A

Q1：闹钟个数有上限吗？ 云端不限制个数。上限由端侧按自身存储能力决定，达上限时端侧直接回复用户。

Q2：端侧只想支持普通闹钟、不支持间隔提醒怎么办？ 云端两种类型都会正常下发。端侧不支持的类型自行拦截并直接回复用户即可。

Q3：设备离线/关机时闹钟还能响吗？ 取决于端侧能力。前提是设备有电；能否在关机/休眠状态下触发响铃，由端侧 RTC 唤醒能力决定。设置闹钟需在线（语音交互依赖网络）。

Q4：铃声可以让用户选择吗？ 当前不支持。铃声由品牌方预置。

8. 相关文档

• 端侧接入协议(必读):§6.5 闹钟设置接入 —— 下发事件(ALARM_CLOCK_EVENT / domain=alarm)、normal_alarm 与 interval_reminder 参数、闹钟列表上报(alarms)、量产验收清单
• 技能配置
• AIoT 指令控制(闹钟走同一事件通道)