主题
指令库
「指令」是让设备动起来的钥匙。它与 技能库 · 系统技能 、 技能库 · 自定义技能 是并列的三大资源:
- 技能 = AI 理解意图后,生成一段文字回复给用户;
- 指令 = AI 识别意图后,既下发一条控制命令给设备执行,同时也生成一段文字回复给用户;
- 所以多数指令都需要设备端开发配合,只有设备能接收并执行平台下发的命令,链路才能闭环;特例是 设备码查询 —— 云端闭环,端侧无需改造。
1. 指令库包含什么
指令库分为两大板块,分别对应不同的产品形态和接入深度:
| 板块 | 定位 | 是否需要企业侧配置 | 典型场景 |
|---|---|---|---|
| 01 · 系统指令 | 平台预置的通用指令,所有企业开箱可用 | 多数需设备端实现对应接口;设备码查询无需端开 | 电量查询、音量调节、退出对话、设备码查询 |
| 02 · 自定义指令集 | 企业根据自家硬件配置的私有指令集,与型号绑定 | 需要在型号库/指令库中完整配置 | 台灯亮度、洗衣机模式、机器人前进 |
2. 指令与技能的关系速览
| 对比项 | 技能 | 指令 |
|---|---|---|
| AI 做什么 | 理解意图 → 生成文字回复 | 识别意图 → 下发控制命令 + 文字回复 |
| 是否需要设备配合 | 不一定(闲聊/知识问答不需要) | 必须(设备需实现接收与执行接口) |
| 典型场景 | 查天气、闲聊、知识问答 | 音量调节、电量查询、亮度控制 |
| 用户感知 | AI「说」了一段话 | 设备「做」了一个动作 |
| 平台链路 | LLM → TTS | LLM → 指令识别 → IoT 下发 → 设备执行 → TTS |
3. 启用指令库的前置条件
一条自定义指令从「配置好」到「用户能触发」需要 3 个前置条件同时满足:
- 型号已建立:在 型号库 中登记好型号(含品类、部件、IoT 平台);
- 指令集已绑定型号:在 自定义指令集 中新建指令集时选择目标型号;
- 智能体已勾选「AIot 设备控制」技能:在 产品管理 · 技能配置 中,把 AIoT 指令控制 加进当前智能体的技能列表。
⚠️ 上述任一环节缺失,即使指令识别正确,设备也不会真正被驱动。
4. 指令库的子板块导航
| 子板块 | 内容概要 |
|---|---|
| 01 · 系统指令 | 平台预置指令清单(电量查询 / 音量调节 / 退出对话 / 设备码查询)、指令编码、触发说法、设备端配合点 |
| 02 · 自定义指令集 | 三维度配置法(物理归属 / 能力结构 / 数据类型)、控制项 vs 非控制项、任务规划器 & 垫句、批量测试 |
| 02.1 · 定时指令 | 让指令按用户设定的时间自动执行(单次 / 循环)——「明天早上 7 点开灯」 |
| 02.2 · 指令的测试和调优 | 三阶验证:跑批测试 → 端到端测试 → 边界验证的完整调优闭环 |
| 02.3 · 静默指令 | 让设备只执行动作、不发出任何语音的配置形态 |
5. 常见问题 Q&A
Q1:自定义指令集配置好了,但设备毫无反应,应该先排查什么? 答:优先按顺序排查——① 型号是否与指令集正确绑定;② 应用是否勾选了「AIot 设备控制」技能;③ 设备端是否实现了对应的接收与执行接口。详见 指令的测试和调优 · STEP 2 端到端测试。
Q2:同一个指令集能否绑定多个型号? 答:不可以。一个指令集只能绑定一个型号。若需要多型号复用,请使用「复制指令集」功能,详见 自定义指令集 · 5.4 复制指令集。
Q3:我不想让设备执行完指令后播报「好的,已经调好了」,怎么办? 答:参见 静默指令,需要同时关闭两个开关:① 指令集的「是否需要执行反馈」;② AIot 设备控制技能的「垫句列表」清空。
Q4:指令识别不准确,漏识别或误识别,如何系统性优化? 答:进入指令集详情页 → 右上角 批量测试,根据整体准确率和失败明细反向优化例句、别名、槽位提示词,详见 指令的测试和调优。