JoyInside 产品使用文档

主题

技能库 - AIoT 指令控制 ​

「AIoT 指令控制」是一项系统技能：把用户的自然语言精准映射为设备可执行的硬件指令。

启用方式详见 技能配置。

1. 配置入口 ​

  1. 进入【产品管理】，打开目标产品的智能体【配置详情】；
  2. 在【技能列表】中新增【AIoT 设备控制】卡片，点击右侧【编辑】，打开配置抽屉；
  3. 抽屉中可见：
    • 【任务规划器】开关：默认开启；
    • 【垫句列表】：仅在「任务规划器 = 开启」时显示，可新增 / 编辑 / 删除垫句条目；关闭任务规划器后，垫句列表自动隐藏。

AIoT 设备控制配置抽屉：任务规划器开关与垫句列表

2. 任务规划器 ​

2.1 什么是「任务规划器」 ​

任务规划器是 AIoT 设备控制链路上的一个「前置思考层」。在指令真正下发到设备之前，规划器会先调用 LLM 对用户的输入进行一次额外的理解与拆分，判断：

  • 用户的意图是否完整、是否需要反问澄清；
  • 是否包含多个并行的子指令、是否需要按 SOP 顺序补全参数；
  • 是否需要根据上下文进行多轮对话改写。

2.2 开启 vs 关闭：核心差异 ​

配置指令下发形式是否调用规划模型适用特征
开启任务规划器并行下发：多指令会被拆分为多个独立协议，分别下发是需要澄清、SOP、主动推荐、多设备/多意图并行
关闭任务规划器串行下发：多指令打包为一个协议，按顺序在 instructions[] 数组中下发否（走精准指令链路）一句话能说清楚、明确不需要澄清的简单/连续动作场景

2.3 何时应「开启」任务规划器？ ​

  • 需要主动推荐 / SOP 约束的场景；
  • 用户表达不完整、需要反问澄清；
  • 需要根据上下文做多轮意图延续与改写；
  • 多设备 / 多意图并行执行，希望规划器自动拆分并并行下发。

2.4 何时应「关闭」任务规划器？ ​

  • 简单指令场景。例如：用户说「音量调高一点」「眼睛调亮一点」，一句话即可说清楚，无需开启规划器，避免不必要的模型调用，降低延迟与成本；
  • 简单多指令 + 端侧事件下发。例如：「先左翻再右翻，然后打个招呼」，端侧期望收到一个 instructions[] 数组按序执行，关闭规划器即可一次性串行下发；
  • 对响应速度敏感、且不需要 LLM 额外推理的场景。

3. 垫句 ​

3.1 什么是「垫句」 ​

AIoT 流程会多次调用模型，并且 IoT 指令的下发链路较长。垫句的作用就是在指令真正执行之前，先给到用户一个即时的语音 / 文字回复，让用户感受到「已经收到、正在处理」，避免长时间静默等待。

触发条件：只有当规划器识别到「可执行的 IoT 任务」时，平台才会从垫句列表中随机选择一条进行输出。

3.2 与任务规划器的联动规则 ​

任务规划器垫句列表实际表现
开启不为空AIoT 指令会先回复一句垫句；多指令并行下发，每条指令一个协议
开启为空AIoT 指令不垫句，但多指令仍并行下发
关闭（列表隐藏，不可编辑）AIoT 指令不垫句，多指令打包为单协议串行下发

3.3 何时应「配置 / 保留」垫句？ ​

  • 需要给用户即时反馈，避免等待感（例如指令执行链路较长、需要走 IoT 平台转发的设备）；
  • 希望通过差异化的垫句话术强化人设、提升交互温度。

3.4 何时应「清空」垫句？ ​

  • 需要完全静默执行：不希望服务端下发任何 TTS（既不希望有执行后回复，也不希望有执行前垫句）；
  • 此时需配合「指令集 → 是否需要执行反馈 = 关闭」一起使用，详细配置请参考 静默指令。

4. 相关资源 ​

本技能依赖以下资源，配置前请确认它们已就绪：

5. 端侧协议引用 🔌 ​

AIoT 指令按「指令下发方式」分为两类，端侧影响面完全不同，配置在指令建模时决定(详见 §6.1 控制项指令关键配置):

指令下发方式链路端侧影响
端侧(不经云端直达设备)云端识别意图 → CALL_SKILL_EVENT 下行事件 → 端侧接收并执行端侧需按技术手册协议实现指令回执与执行反馈
IOT 平台(经 IOT 平台转发)云端识别意图 → 云到云转发至 IoT 平台(如小家、集贤 IoT)→ IoT 平台驱动设备执行端侧无感,不感知也不需要处理该类指令

因此,下列端侧协议锚点仅适用于「端侧」下发方式;若指令走「IOT 平台」转发,端侧集成方无需实现对应事件: