此文档将带您快速了解度家-AIOT语音语义平台“定制技能配置”板块的功能定位与核心概念。
1. 功能定位
度家-AIOT语音语义平台（下文称“度家”）的“定制技能配置”板块集成百度自然语言处理的能力，支持智能家居设备厂商和方案商快速定制设备控制技能。例如，台灯控制技能、冰箱控制技能、扫地机控制技能、全屋控制技能等。
度家“定制技能配置”与传统的技能创建方法区别之处在于：用户无需创建意图、词槽，无需匹配语言模板，只要根据设备自身特性创建相关“属性”和“控制动作”，并添加必要的词典、动作泛化与答复话术，即可快速获得基础版技能。
2. 核心概念
若你想快速入门，在“定制技能配置”板块配置一个控制智能家居设备的语义解析技能，请先了解以下核心概念。
2.1 定制技能
指客户在度家“定制技能配置”板块创建、配置、训练的技能，目前每个客户仅可创建一个定制技能，并在研发环境进行训练。若创建的定制技能要上线生产环境，需与百度商务联系。
2.2 模块
创建定制技能时需区分“单模块”和“多模块”控制技能。此处的模块可理解为技能需要控制的最小单元，或终端用户控制query中涉及的最小单元。请通过以下三个例子理解此概念：
- 假设您是台灯厂商，需要定制一个台灯控制技能，创建技能时需选择“单模块”即可，无需将台灯细分为更小的零部件模块。终端用户通常只会说“台灯打开”，而不会说“台灯按钮打开”，所以在配置技能模块时，“台灯”本身作为一个模块即可。
- 假设您是全屋控制方案商，需要定制一个全屋控制技能。创建技能时需选择“多模块”，需要控制的最小单元为屋内的具体设备，例如：“顶灯”、“台灯”、“左窗帘”、“右窗帘”、“加湿器”、“卧室插座”等，每一个设备需要创建为一个“模块”，终端用户会对上述各个设备下达控制query。
- 假设您是集成灶厂商，需要定制一个集成灶控制技能，由于集成灶上需要控制的最小单元包含“灶灯”、“蒸烤箱”、“抽油烟机”。创建技能时需选择“多模块”，并将以上控制单元分别创建为模块，终端用户会对上述各个设备下达控制query。
2.3 有属性指令
每个物理设备都具备诸多属性，以灯为例，“亮度”、“模式”、“色温”为灯的常见属性。终端用户若需要语音控制灯的常见属性，典型控制指令如下：
- “亮度调高一点”
- “灯亮度调为50”
- “把灯调到学习模式”
- “打开夜晚模式”
- “色温调低一些”
- “灯的温调到2300”
上述指令都是为了控制物理设备的某个“属性”，所以我们称之为“有属性指令”。为了让定制技能可以解析上述指令，需要需要通过“创建属性”来创建、编辑属性。
2.4 无属性指令
但在语音控制中，有一些指令无法与属性挂钩，例如：
- “开灯”
- “关灯”
- “把灯复位”
上述无法归纳出属性的控制指令，我们称之为“无属性指令”。为了让定制技能解析上述指令，可通过创建“无属性指令”来实现指令解析。
2.5 属性基础信息
属性基础信息需要您自主编辑“属性名称”和“属性标识符”。
“属性名称”输入代表设备属性的中文，例如“音量”、“温度”、“亮度”、“长度”
“属性标识符”输入代表设备属性的英文，例如“sound_volume”、“temperature”、“brightness”、“length”。当技能配置完成后，当用户query命中相关属性后，技能将下发您定义的“属性标识符”。
2.6 属性权限
属性权限选择包含两方面，“语音查询属性功能”、“定时功能”。
语音查询属性功能：
开启：若选择开启，则默认支持解析“属性是多少”类型的query，例如”现在温度是多少“、”亮度是多少“。
暂不需要：若技能无需支持“属性是多少”类型的查询query，建议保持默认不开启状态。
定时功能：
开启：若选择开启，则默认支持解析“2个小时后关灯”，“下午3点开始打扫”等类型的预约query。
暂不需要：若技能无需解析“预约某时间执行特定操作”类型的query，建议保持不开启状态。
2.7 属性值类型
度家-AIOT语音平台的属性分为五类，您需要根据属性的值类型，在下图中选择合适的“属性值”。
| 属性类型 | 中文名 | 备注 |
|---|---|---|
| int | 整型 | 需选择“整型”的典型属性为“音量” |
| float | 浮点 | 需选择“浮点型”的典型属性为“温度” |
| enumerate | 枚举 | 需选择“枚举型”的典型属性为“模式”，例如台灯的“夜晚模式”、“护眼模式”等 |
| bool | 布尔 | 需选择“布尔型”的典型属性为状态对称的属性，例如某设备需要语音控制“开启状态”、“关闭状态” |
| time | 时间 | 需选择“时间”的典型属性中不可包含其他属性因素，创建此属性是为了解析如“时间调到5点”等query，而非“5点后开始打扫卧室” |
2.8 属性值
属性值如何编辑依赖于属性值类型的选择。您选择属性值类型后，度家控制台会自动弹出待编辑的属性值。示例如下：
int类型属性值示例：
float类型属性值示例：
enumerate类型属性值示例（无序）：
注意：无序enumerate类型代表词典值之间无大小关系，如下图所示
enumerate类型属性值示例（有序）：
注意：有序enumerate类型代表词典值之间有大小逻辑关系，如下图所示
bool类型属性值示例：
time类型属性值示例：
注意：timee类型属性值为系统预置，无需您编辑
2.9 控制动作
终端用户通过语音指令控制设备时明说或意图中暗含的动作。例如：
- “打开台灯”，控制动作为“打开”。
- “台灯亮度调高一点”，控制动作为“调高”。
- “台灯亮度100”，终端用户虽未说出动词，但默认控制动作为“调到”，即“台灯亮度调到100”。
2.10 泛化
“泛化”可理解为替特定词语添加“同义词”或“同义说法”的过程。例如，“抽油烟机”在用户群体中有多重说法——“抽烟机”、“抽风机”、“油烟机”。当您创建完模块“抽油烟机”后，为了保证不同用户的说法都能被技能识别，需要为“抽烟机”这一名称进行泛化。
2.11 答复话术
当定制技能解析时命中已配置信息时，技能下发的回答内容。答复话术需要在“模块-属性-动作”粒度下逐一创建。
2.12 兜底话术
当所配置的定制技能无法解析指令时，技能返回的说法。每个技能可配置多条兜底话术，系统将随机返回。
3. 技能返回字段说明
定制技能配置完成、且训练过后，您可在控制台上的技能测试窗口进行对话测试。测试返回字段说明如下。
备注：若代表query中不包含某字段信息，则该字段返回null，
| 字段 | 字段中文名 | 备注 |
|---|---|---|
| action | 动作 | 模块、属性下关联的动作，或模块下关联的无属性指令词。具体含义可参考上述全局名词解释 |
| mod | 模块 | 英文全名为module，即模块。实际含义可理解为“设备”。具体含义可参考上述全局名词解释 |
| property | 属性 | 模块下关联的属性。具体含义可参考上述全局名词解释 |
| propertyUnit | 属性单位 | 属性单位，当终端用户的query中不包含单位时，值为空。例如，用户说“温度调高10”，返回propertyUnit为null，用户说“温度调高10度”，返回propertyUnit为“度”。 |
| propertyValue | 属性值 | 例如，用户说“空调调高10”，返回propertyValue为“10” |
| reply | 答复话术 | 针对每个模块-属性-动作粒度下的答复话术。具体含义可参考上述全局名词解释 |
| skillId | 技能ID | 所创建的控制技能ID，创建技能后自动自动生成返回 |
| timeDuration | 持续时间 | 当用户query中涉及“持续时间”概念时返回的字段，例如用户说“烤箱烤鱼半小时”，timeDuration返回“0.5小时” |
| timeStart | 开始时间 | 根据当下时间推算出的预定动作起始时间，当用户query中涉及“开始时间”概念时返回的字段。例如“过2小时关闭空调”，且当下时间为下午2点，timeStart返回“16：00” |
query与返回示例
若测试query为“小度小度，空调温度调到26度”，技能测试窗口将返回如下结果。
| 字段名 | 字段值 |
|---|---|
| action | "to" |
| mod | "air_condition" |
| property | "temperature" |
| propertyUnit | “度” |
| propertyValue | “26” |
| reply | “好的，主人” |
| skillId | “12345678” |
| timeDuration | null |
| timeStart | null |
返回示例代码
若测试query为“开始清扫”时，技能解析返回的代码示例：
