意图配置

**目录**
1. 语料设计
	1.1. 语料说明
	1.2. 压缩语料
2. 编写句式选择
	2.1. 智能贴弧开关选择
	2.2. 定义语义槽
	2.3. 定义辅助词
3. 语义槽绑定实体
	3.1. 自定义实体
4. 填槽对话
5. 技能回复
6. 意图确认

**意图配置**主要就是语料填充编写，关于语料编写详细流程如下：
##  1. 语料设计
### 1.1. 语料说明
一个意图有多种说法，称为语料：
- 查快递单号8888
- 顺丰单号8888到哪里了
- ……

### 1.2. 压缩语料
对梳理的技能对话语料进行合并和压缩，具体方法可以有：
- 使用模糊匹配方式，对关键信息进行处理。详见[模糊匹配](https://aiui-doc.xf-yun.com/project-1/doc-50/)说明；
- 设置非关键信息为非必选字段或槽位，使用方式见[可选符](https://aiui-doc.xf-yun.com/project-1/doc-47/#可选符)说明，进行类似句式合并。

我们将这些提问方式添加进入控制台，示例如下：

![](https://aiui-file.xfyun.cn/aiui-doc/4_skill_develop/4_private_skill/add_sample.png)

## 2. 编写句式选择
在进行语料编辑时，可以选择的句式可以分两类，分别为：
- **例句语料**：
	纯文本句式，不使用标签符号进行槽位说明。需要进行槽位控制时，鼠标滑动选字符进行设置
- **模板语料**：
	使用标签符号进行槽位说明，支持的符号详见[意图和语料](https://aiui-doc.xf-yun.com/project-1/doc-47/)说明；

示例说明如下：

![](/media/202407/2024-07-30_112638_9061130.7688732084367446.png)

### 2.1. 智能贴弧开关选择

系统自动判断**例句语料**的槽位，并匹配实体。当不需要系统进行智能槽位判断时，可进行手动关闭：

![](/media/202409/2024-09-13_104057_1695630.5219667202223248.png)

###  2.2. 定义语义槽
用户说法:`查顺丰快递、查EMS、查圆通快递`
抽象语义槽并命名为company：`查{company}`

### 2.3. 定义辅助词
**辅助词**：不改变句式含义的词，如我要、查询、帮我。

## 3. 语义槽绑定实体
将快递公司名总结为 **实体**{expressCompany}

==每个语义槽均需与实体绑定==。在以上的例子中，我们将语义槽`{company}`与实体`expressCompany`绑定。

![](https://aiui-file.xfyun.cn/aiui-doc/4_skill_develop/4_private_skill/change_slot.png)

### 3.1. 自定义实体
讯飞有一些开放的实体可以供开发者调用，比如针对快递单号语义槽 {number} ，使用官方开放实体 `IFLYTEK.number` 可以很好的解决。
当官方实体不满足自由业务实体内容选择时，可以进行自定义实体来填充自己的数据。
以快递公司的名称为例，需要开发者自己总结。新建实体示例如下（具体用户该创建何种实体可以见[实体文档](https://aiui-doc.xf-yun.com/project-1/doc-48/ "实体文档")说明自行选择）：
- 实体类型：`静态实体`
- 实体名称：`快递公司`
- 实体标识：`expressCompany`

![](https://aiui-file.xfyun.cn/aiui-doc/4_skill_develop/4_private_skill/creat_entity.png)

如下图为实体添加词条，建议`词条`填写归一化的实体名，`别名`填词条用户所有的可能表述方式。

![](/media/202407/2024-07-30_113521_4592130.8746946376165508.png)

## 4. 填槽对话
填槽对话用于追问用户补充缺失信息。可设置语义槽是否必填。

举例
- 用户 ：查顺丰快递
- 讯飞 ：请告诉我快递单号 （填槽对话：追问单号信息）
- 用户 ：123

若勾选对话必须，则可以且必须自定义追问语句（ElicitSlot）以及回答语料，否则技能可能无法命中。

开发者可以在「意图编辑页-实体」中将实体勾选为「对话必须」，当缺少必须的实体时，会主动追问，参照下图设置。

![](https://aiui-file.xfyun.cn/aiui-doc/4_skill_develop/4_private_skill/fill_slots.png)

平台暂不支持可视化的配置槽位确认（ConfirmSlot）

- 关闭云函数时，系统会按照你在页面上的配置，依次引导用户填写**必选槽位**
- 开启云函数时，你应当每次请求到来时，你都应当根据你的业务逻辑，判断此时此刻是否需要进行槽追问，槽确认，意图确认。如果你不想处理，可以使用 DelegateDirective（托管）指令，此时系统会根据当前的槽位状态以及你在平台上的配置，自动的去触发**槽追问（ElicitSlot**） 或者**意图确认（ConfirmIntent）**。

填槽对话是意图内的多轮对话，详细概念可参考[填槽对话](https://aiui-doc.xf-yun.com/project-1/doc-51/)章节。
## 5. 技能回复
可按需添加，如不添加，“模拟测试”和端侧测试可能无法命中技能。
## 6. 意图确认
>前提：勾选对话必须

你可以选择开启意图确认（ConfirmIntent）并填写意图确认语句。