概览

本文档介绍如何使用实时互动大模型的闹钟功能。实时互动大模型提供两种闹钟途径，即云端闹钟能力和本地闹钟方案。用户可以参考本文档按需选择或实现。

场景

云端闹钟能力

闹钟设置和管理在云端完成，用户在控制台上勾选（即将上线）后便可使用。时间到了闹铃时刻，云端闹钟会给客户端发送闹钟提醒（注意:云端闹钟要求设备端一直在线，否则闹钟提醒无法正常下发）。该功能适合持续在线的设备，如电风扇、冰箱、家庭中控设备等。

本地闹钟方案

闹钟管理和设置在本地完成，用户通过function call方式自行在本地开发闹钟设置和维护功能。用户在控制台配置闹钟相关的function call后，实时互动大模型会将相关参数按配置格式解析，并下发到端侧。端根据参数自行实现业务逻辑。该方案适合会离线的设备，如玩具、学拍机、蓝牙音响等。

方案概述

云端闹钟

云端闹钟方案如下图所示。用户在与互动大模型对话过程中，大模型识别到闹钟相关的意图（eg:“明天早上8点提醒我起床”、“我后天有什么计划”），实时互动大模型agent会触发闹钟增删改查相关操作。闹钟管理服务会对待执行的闹钟进行调度，到达需要执行的时刻，闹钟执行模块会进行闹铃，即通过agent下发闹钟语音和文字提醒（eg:“起床时间到了，起床时间到了，起床时间到了”）

支持能力： 通过语音对闹钟进行增删改查。典型功能如下

类别	query示例	播报示例
任务新增	30分钟后提醒我喝水。	已为您添加2025年12月15日 19:57喝水的闹钟
	定一个明天七点叫我起床的闹钟。	已为您添加2025年12月16日 07:00起床的闹钟
	每周一到五早上九点喊我吃饭。	已为您添加每周一至周五 09:00吃饭的闹钟
	每周工作日早上8点提醒我起床。	已为您添加每周一至周五 08:00起床的闹钟
	每周六晚上8点叫我运动。	已为您添加每周六 20:00运动的闹钟
	晚上8点我朋友叫我吃饭，到时候你记得提醒我。	已为您添加2025年12月15日 20:00吃饭的闹钟
任务查询	我现在有哪些闹钟。	为您查询到6个符合条件的闹钟：每周一至周五 08:00 起床; 每周六 20:00 运动; 2025年12月15日 20:00 吃饭; 2025年12月15日 19:57 喝水; 2025年12月16日 07:00 起床; 每周一至周五 09:00 吃饭
	今天我有什么计划。	为您查询到2个符合条件的闹钟：2025年12月15日 20:00 吃饭; 2025年12月15日 19:57 喝水
	我今天有什么要做的事吗。	为您查询到2个符合条件的闹钟：2025年12月15日 20:00 吃饭; 2025年12月15日 19:57 喝水
	我现在有哪些提醒？	为您查询到6个符合条件的闹钟：每周一至周五 08:00 起床; 每周六 20:00 运动; 2025年12月15日 20:00 吃饭; 2025年12月15日 19:57 喝水; 2025年12月16日 07:00 起床; 每周一至周五 09:00 吃饭
任务修改	把今天晚上8点吃饭的闹钟改到9点。	为您更新1个符合条件的闹钟，更新后的闹钟为：2025年12月15日 21:00 吃饭
	把工作日9点吃饭的闹钟改到8点。	为您更新1个符合条件的闹钟，更新后的闹钟为：每周一至周五 08:00 吃饭
	刚刚有人请我吃过饭了，8点的闹钟我要改成去夜跑。	为您更新1个符合条件的闹钟，更新后的闹钟为：2025年12月15日 20:00 去夜跑
	明天早上计划有变，帮我把时间改到下午1点。	为您更新3个符合条件的闹钟，更新后的闹钟为：每周一至周五 13:00 吃饭; 2025年12月16日 13:00 起床; 每周一至周五 13:00 起床
任务删除	把明天早上的起床闹钟删掉。	没有找到符合条件的闹钟，无法进行删除操作，您可以换种方式描述下想删除的闹钟
	把今晚的闹钟删掉。	为您删除2个符合条件的闹钟：2025年12月15日 21:00 吃饭; 2025年12月15日 19:57 喝水
	把所有闹钟删掉。	为您删除4个符合条件的闹钟：每周一至周五 13:00 吃饭; 每周六 20:00 去夜跑; 2025年12月16日 13:00 起床; 每周一至周五 13:00 起床

本地闹钟

本地闹钟推荐方案如下图所示。用户需要在实时互动大模型上配置好function call。用户在与实时互动大模型对话过程中，大模型识别到funcation call意图时，会触发function call执行（funcall参数解析和funcall回调）。用户的端侧，接受到funcall回调时，需要在本地实现闹钟的增删改操作。到达闹钟设置的执行时刻时，本地需要实现对闹铃。

支持能力：取决于funcall配置情况，实时互动大模型会安装配置的格式进行参数解析。参数解析示例：
[F]:{"session_id":"1765806049601","content":"{"function_name":"add_clock","parameter_list":[{"date":"2025-12-16"},{"time":"09:00"}]}","query":"明天早上9点喊我起床"}

（提醒，function call 支持回调语音播报。可以通过设置 [F]:{"session id":"1754555833139","result":"ok","message":"已为您设置2025-12-16 09:00 闹钟"} 指令中，message的值来实现内容播报，详细能容见意图设置 ）

配置步骤

云端闹钟

1、云端闹钟开启

在控制台app详情页里面，大模型配置中，勾选”云端闹钟哦“即可使用。 （强调：云端闹钟要求终端持续在线，否则无法接收闹钟提醒）

2、云端闹钟到时间提醒

云端闹钟到时间的提醒：

• 系统播报：云端闹钟内置的纯文本播报
• 自定义播报：支持播报固定内容、音乐、和模型生成的内容，具体接入见智能播报接入

本地闹钟

强调：本地端闹钟需要自行实现闹钟管理和执行能力

第一步，创建function call模版，填写模版名称和描述

第二步，在【意图设置】中点击【选择推荐Function】

第三步，以下提供闹钟场景的增删改查函数定义作为参考，请根据实际业务需求补充参数与规则。配置完成后，业务侧需实现对应接口以响应调用。

Function：query_alarm

Function 描述：查询闹钟

Function 例句：

• 我现在有哪些闹钟
• 告诉我明天十点以后有哪些闹钟
• 查询 xx 点到 xx 点的闹钟
• 查看所有闹钟
• 周 x 有哪些闹钟
• 7 月 15 号有闹钟吗

函数参数：

序号	参数名	类型	说明
1	alarm_time	String	闹钟时间条件。包括具体时间或时间范围。具体时间统一转换为 HH:mm 格式；时间范围统一转换为 HH:mm-HH:mm 格式，其中：上午 = 06:00-11:59，下午 = 12:00-17:59，晚上 = 18:00-23:59；用户表达具体时间范围时统一转换为 HH:mm-HH:mm 格式，如"八点到十点"转换为 08:00-10:00。
2	date	Date	闹钟日期。仅当用户明确指定相对日期或具体日期时填写，如今天、明天、后天、x 月 x 日等；根据用户表达自动转换。
3	query_all	Boolean	是否查询全部闹钟。当用户表达"所有闹钟""全部闹钟""我的闹钟""有哪些闹钟""查看全部闹钟"等意图时，取值为 true；否则为 false。
4	weekday	String	闹钟星期/周期信息。仅当用户明确指定星期时填写，如周一、周三、工作日、周末等；根据用户表达自动转换。支持多个星期，需全部保留，如"周一和周三"填"周一、周三"，不得只取其一。
5	repeat_type	String	闹钟重复类型，取值为 ["单次", "循环"] 之一。根据用户表达自动提取；当用户明确表达"每天""每周""工作日""周末"等重复意图时，取值为"循环"，并同时在 weekday 填写对应值；其余闹钟均取值为"单次"。默认为单次。
6	label	String	闹钟备注或提醒内容，只保留核心事项名词。如"起床""吃药""开会"。需要去除"叫我""提醒我"等动词前缀，如"叫我起床"提取为"起床"，"提醒我吃药"提取为"吃药"。若句中没有明确事项（如仅说"闹钟""叫我""提醒我"而无具体内容），必须留空，不得补全。

---

Function：set_alarm

Function 描述：创建闹钟，创建定时提醒。不用于查询、删除、修改闹钟。

Function 例句：

• 设置一个 xx 的闹钟
• 新增一个 xx 的闹钟
• 帮我定一个 xx 的闹钟
• 10 分钟后提醒我喝水
• 明天早上七点叫我起床
• 设置一个工作日 xx 点的闹钟
• 定一个闹钟

函数参数：

序号	参数名	类型	说明
1	time	String	闹钟触发时间，24 小时制 HH:mm。当用户未明确具体时间时不得填写。
2	date	Date	闹钟日期，YYYY-MM-DD 格式。当用户指定相对日期或具体日期时填写，如"今天""明天""后天""2026 年 7 月 10 日""7 月 10 日""10 号"等；根据用户表达自动转换为日期格式。用户未指定日期时，默认为今天的日期。
3	weekday	String	星期/周期信息。当用户明确指定星期几时填写，取值为 ["每天", "周一", "周二", "周三", "周四", "周五", "周六", "周日", "工作日", "周末"] 中的一个或多个。支持多个星期，需全部保留，如"周一和周三"填"周一、周三"，不得只取其一。根据用户表达自动转换。用户未指定星期时，不填写该参数。
4	label	String	闹钟备注或提醒内容，只保留核心事项名词。如"起床""吃药""开会"。需要去除"叫我""提醒我"等动词前缀，如"叫我起床"提取为"起床"，"提醒我吃药"提取为"吃药"。若句中没有明确事项（如仅说"闹钟""叫我""提醒我"而无具体内容），必须留空，不得补全。
5	repeat_type	String	闹钟重复类型，取值为 ["单次", "循环"] 之一。根据用户表达自动提取；当用户明确表达"每天""每周""工作日""周末"等重复意图时，取值为"循环"，并同时在 weekday 填写对应值；其余闹钟均取值为"单次"。默认为单次。

---

Function：delete_alarm

Function 描述：删除一个或多个闹钟。仅当用户明确表达"删除""删掉""取消""清空""都删了"等删除意图时触发；不得用于查询、新增或修改闹钟。

Function 例句：

• 删除闹钟
• 取消闹钟
• 把闹钟删掉
• 删除提醒
• 取消提醒
• 删除喝水提醒
• 把刚设置的提醒取消掉
• 清空所有闹钟和提醒

函数参数：

序号	参数名	类型	说明
1	time	String	闹钟触发时间，24 小时制 HH:mm。当用户未明确具体时间时不得填写。
2	date	Date	闹钟日期，YYYY-MM-DD 格式。当用户指定相对日期或具体日期时填写，如"今天""明天""后天""2026 年 7 月 10 日""7 月 10 日""10 号"等；根据用户表达自动转换为日期格式。用户未指定日期时，默认为今天的日期。
3	weekday	String	星期/周期信息。当用户明确指定星期几时填写，取值为 ["每天", "周一", "周二", "周三", "周四", "周五", "周六", "周日", "工作日", "周末"] 中的一个或多个。支持多个星期，需全部保留，如"周一和周三"填"周一、周三"，不得只取其一。根据用户表达自动转换。用户未指定星期时，不填写该参数。
4	label	String	闹钟备注或提醒内容，只保留核心事项名词。如"起床""吃药""开会"。需要去除"叫我""提醒我"等动词前缀，如"叫我起床"提取为"起床"，"提醒我吃药"提取为"吃药"。若句中没有明确事项（如仅说"闹钟""叫我""提醒我"而无具体内容），必须留空，不得补全。
5	repeat_type	String	闹钟重复类型，取值为 ["单次", "循环"] 之一。根据用户表达自动提取；当用户明确表达"每天""每周""工作日""周末"等重复意图时，取值为"循环"，并同时在 weekday 填写对应值；其余闹钟均取值为"单次"。默认为单次。
6	delete_all	Boolean	是否删除全部闹钟。用户表达"删除所有闹钟""清空闹钟""全部删掉"等意图时取 true，否则为 false。

---

Function：modify_alarm

Function 描述：修改已有闹钟，支持修改闹钟时间、日期、星期、重复方式。适用于用户表达修改、调整、更改等闹钟修改意图；仅用于修改已有闹钟，不用于新增、删除、开启、关闭或查询闹钟。

Function 例句：

• 修改闹钟
• 帮我改一下闹钟
• 调整明天早上八点的闹钟
• 把八点的闹钟改到九点
• 把今天的闹钟改到明天
• 把周一的提醒改到周三
• 把每天提醒改成工作日提醒
• 把单次闹钟改成重复闹钟
• 把这个闹钟提前半小时
• 把明早的提醒延后一小时
• 修改喝水提醒的时间
• 把开会提醒改成吃药提醒
• 把所有八点的闹钟改到九点
• 把所有喝水提醒改成运动提醒

函数参数：

序号	参数名	类型	说明
1	old_time	String	旧闹钟触发时间，24 小时制 HH:mm。
2	new_time	String	新闹钟触发时间，24 小时制 HH:mm。
3	old_date	Date	原闹钟日期，YYYY-MM-DD。仅当用户明确指定相对日期或具体日期时填写，如今天、明天、后天、x 月 x 日等；根据用户表达自动转换，用于定位需要修改的闹钟。
4	new_date	Date	新闹钟日期，YYYY-MM-DD。仅当用户明确指定相对日期或具体日期时填写，如今天、明天、后天、x 月 x 日等；根据用户表达自动转换，用于定位需要修改的闹钟。用户未指定时，不填写。
5	old_weekday	String	原星期/周期信息。当用户明确指定星期几时填写，取值为 ["每天", "周一", "周二", "周三", "周四", "周五", "周六", "周日", "工作日", "周末"] 中的一个或多个。支持多个星期，需全部保留，如"周一和周三"填"周一、周三"，不得只取其一。根据用户表达自动转换。用户未指定星期时，不填写该参数。
6	new_weekday	String	新的星期/周期信息。当用户明确指定星期几时填写，取值为 ["每天", "周一", "周二", "周三", "周四", "周五", "周六", "周日", "工作日", "周末"] 中的一个或多个。支持多个星期，需全部保留，如"周一和周三"填"周一、周三"，不得只取其一。根据用户表达自动转换。用户未指定星期时，不填写该参数。
7	old_repeat_type	String	原闹钟重复类型，取值为 ["单次", "循环"] 之一。根据用户表达自动提取；当用户明确表达"每天""每周""工作日""周末"等重复意图时，取值为"循环"，并同时在 weekday 填写对应值；其余闹钟均取值为"单次"。默认为单次。
8	new_repeat_type	String	修改后的闹钟重复类型，取值为 ["单次", "循环"] 之一。根据用户表达自动提取；当用户明确表达"每天""每周""工作日""周末"等重复意图时，取值为"循环"，并同时在 weekday 填写对应值；其余闹钟均取值为"单次"。默认为单次。

---

Function：control_countdown

Function 描述：控制倒计时，支持开始（新建、创建、打开、进入、设置）、修改、增加、减少、重置（清空）倒计时等操作。

Function 例句：

• 设置倒计时 x 分钟
• 延长倒计时至 x 分钟
• 减少倒计时时间至 x 分钟
• 打开倒计时
• 重置倒计时
• 清空倒计时
• 增加倒计时 x 分钟
• 延长倒计时 x 分钟

函数参数：

序号	参数名	类型	说明
1	operation	String	倒计时操作类型，取值为 ["开始", "修改", "增加", "减少", "重置"] 之一。默认取值为"设置"。
2	duration	Number	倒计时目标时长，单位为秒，取值范围为 30-86400 之间的整数。用户明确设置倒计时时长时填写，如"倒计时 1 分钟"根据用户表达自动转换；用户未指定时长时，默认 900 秒。
3	relative_duration	Number	倒计时时长相对调整值，单位为秒，根据用户表达自动转换；如"增加 2 分钟"为 120，"减少 30 秒"为 30；用户未表达增加、减少、延长、缩短等调整时长意图时，不填写。

参数样例：

输入例句	命中参数名	参数值
设置倒计时	operation	开始
设置倒计时	duration	900