AI 助手

平台内置 AI 助手，使用 自然语言一句话 即可完成设备的查询、控制、场景联动、告警配置等操作，无需在多个页面间切换。

入口与基本使用

打开 AI 助手

平台任意页面右下角都有一个紫色 AI 悬浮球，点击即可弹出右侧抽屉。
悬浮球可以拖动到任意位置，刷新后位置仍然保留。
不需要时点击右上角关闭按钮，下次再打开依然保留对话历史。

怎么对它说话

直接用日常语言描述要做什么，不需要懂任何协议、SN 编码或字段名。
一句话可以同时包含多件事，AI 会自动拆分。
AI 涉及到 下发指令、创建场景、创建告警 这类有副作用的操作时，会先在抽屉里展示 待确认 的卡片，必须点 确认执行 才会真正生效，绝不会未经确认就改设备。

支持的能力

AI 助手目前支持以下五大类操作。每条指令以 自然语言例子 → AI 行为 的方式列出，照葫芦画瓢即可。

1. 查询设备当前属性

查看设备此刻的某个状态，例如温度、湿度、开关、模式等。AI 会读取设备最新一次上报的数据并直接展示，无需确认。

你说	AI 做什么
客厅温度多少	显示客厅温湿度计的温度值 + 单位 + 上报时间
卧室空调开了吗	显示卧室空调的开关状态
看一下客厅湿度和卧室温度	同时返回多个查询结果
厨房烟雾报警器现在是什么状态	返回当前状态属性的最新值

提示：温度、湿度 这种中文 AI 会自动映射到 物模型 里定义的标识符（例如 temp / hum）。前提是设备已经在物模型里定义了对应属性。

2. 下发控制指令

让设备执行一个动作，例如开关、调节、调色等。AI 会先列出准备下发的指令让你确认。

你说	AI 做什么
打开客厅水阀	显示"客厅水阀 - 开关 - 参数 1"，待确认
关闭卧室所有灯	同时列出多个灯的关闭指令，确认后批量下发
把卧室空调调到 26 度	自动选择"设定温度"指令，参数填 26
把客厅灯调成红色	按指令配置生成 RGB 参数
打开客厅水阀，再看看卧室温度	一次完成下发 + 查询的混合指令

让 AI 填参数更准的关键：指令的 `备注` 字段

在 产品 / 设备 - 指令下发 配置页，每条指令都有一个 备注 输入框，这个备注同时给人和 AI 看。

推荐写法（越规范 AI 越准）：

开关型：1=开 0=关
数值型：temp 整数 16-30 单位℃
枚举型：取值 ON 或 OFF
JSON 型：JSON：{r,g,b 都是 0-255}
AT 命令：AT+POWER=ON 开机，AT+POWER=OFF 关机

AI 看到 1=开 0=关 时，用户说"打开"它就知道填 1，说"关闭"就填 0。

3. 修改设备属性（属性修改通道）

当指令列表里没有专门修改某个属性的指令，但设备绑定了 属性修改指令（在设备配置里）时，AI 会自动走属性修改通道。

你说	AI 做什么
把卧室空调温度设到 26 度	若有 `set_temp` 指令优先用它；没有则走属性修改，property=temp、value=26
把客厅空调调成制冷模式	字典属性自动翻译："制冷" → key=`1` 下发
把卧室灯亮度改成 80	走属性修改通道，value=80

适用条件：设备在 设备配置 - 属性修改指令绑定 里选择了功能码后，AI 才会启用这条通道。

4. 创建场景联动（自动化）

让设备 当满足某些条件 / 到达某个时间 时自动执行动作。落库后即时生效，与手动在 场景联动 页面创建的完全等价。

属性触发

设备数据满足条件时触发执行。

你说	AI 做什么
如果客厅温度高于 30 度且湿度大于 70，就把客厅空调打开并把窗帘关上	创建多条件 AND 场景，触发后并行下发两台设备
当卧室温度低于 18 度，关闭窗帘并打开加湿器	跨设备联动场景
如果客厅人体感应器有人，就打开客厅灯	单条件触发场景

定时触发（周期）

按时间表周期性执行。

你说	AI 做什么
每天早上 8 点把客厅空调打开	创建每日定时场景
每周一 9 点关闭办公室所有灯	创建周一定时场景
每月 1 号 10 点同步一次设备状态	创建每月定时场景
每天晚上 10 点把所有灯关掉	多设备并行执行

定时触发（一次性）⭐

单一时刻执行一次后自动停用，特别适合临时提醒。

你说	AI 做什么
今晚 8 点 50 把客厅空调打开	一次性场景，今晚 20:50 执行后自动停用
明天早上 7 点提醒我开窗户	一次性场景
10 分钟之后打开客厅空调	基于当前时刻 +10 分钟创建一次性场景
两小时后关闭客厅所有灯	即便跨天也能算对
30 秒后打开浴室灯	秒级精度，到点自动停用

定时 + 前置条件

定时到点后还要看条件成立才执行，否则跳过。

你说	AI 做什么
每天早上 8 点如果空调没开就打开客厅空调	定时 + 检查空调开关，未开才执行
每天晚上 10 点如果客厅有人就关灯	定时 + 人体感应判断

在 场景联动 列表页可以看到 AI 创建的场景，也能手动启用/停用/删除。一次性场景在执行后会自动变成"已停用"，不会重复触发。

5. 创建告警配置

配置告警规则。AI 会根据条件和动作是否涉及多台设备自动选择正确的入口。

单设备告警 → 落到 `设备 - 告警配置`

你说	AI 做什么
卧室空调温度大于 30 度，并且空调未打开，触发温度告警，并执行开启空调指令	在卧室空调上创建告警规则，包含 2 个 AND 条件 + 1 个执行动作
当烟雾感应器报警时，发严重等级告警	单条件单设备告警

多设备联动告警 → 自动改用 `属性触发场景` 实现

你说	AI 做什么
卧室空调温度大于 30 度并且客厅空调温度大于 30 度，且空调都未打开，触发告警并开启这两个空调	AI 识别到"跨设备"，改用属性触发场景实现，效果一致

区分逻辑：触发条件 + 执行动作全部在同一台设备上 → 单设备告警；跨了任意一台设备 → 自动走场景联动。

6. 闲聊与帮助

和设备无关的提问也能正常回答，例如"你是谁"、"你能干什么"、"讲个笑话"等，不会触发任何设备操作。

怎么让 AI 工作得更准

AI 的准确度主要依赖你在配置页面填好这些字段。规则越规范，AI 越聪明。

1. 设备名要清晰、具有定语

✅ 好：客厅的空调、卧室温湿度计、厨房烟雾报警器
❌ 模糊：空调1、设备A、传感器
多台同型号时用位置/房间作定语，AI 才能在"打开客厅空调"和"打开卧室空调"之间区分。

2. 指令的 `备注` 字段必填

越规范 AI 越准。参考第 2 节"让 AI 填参数更准的关键"。
备注同时是给 AI 看的"说明书"，没填备注 AI 只能凭推测。

3. 物模型要建好

在 产品/设备 - 物模型 页面给每个属性配上 标识符 + 名称 + 单位 + 备注。
字典型属性记得填 字典配置，例如：[{"key":"1","value":"制冷"},{"key":"2","value":"制热"}]。AI 会自动把"制冷"翻译成 1 下发。
没建模的设备，AI 只能从最近一次上报消息里猜字段，准确度大幅下降。