# 添加实体
实体可以理解为一个变量，参数，可被用于配置任务型机器人的多轮对话来识别具体的用户目的，也可以用于暂存接口中的参数值，方便后续计算使用。例如在购买飞机票的任务中，您需要了解客户的起始地、目的地、起飞时间、航空公司等信息，才能够确认航班，完成购买操作，这里的起始地、目的地、起飞时间和航空公司都可以看做实体。
#### 背景信息
使用实体能够对槽位中填充的值进行规格约束，类似于为变量定义数据类型。系统预置了一些常用实体，例如系统日期、系统时间、国内常用城市名、数字、手机按键等，您可以在"模板管理 \> 实体管理"中的"系统实体"以及"环境实体"查看，也可以单击用户实体页签下的"测试实体"，查看您需要的变量是否能够识别。如果预置实体无法满足您需要，您可自行添加用户实体。用户实体分为三种：
- 一般实体：对应单一变量的实体，例如起始地、目的地、航空公司都是一般实体。用户自定义添加的一般实体当前只支持设置枚举值和对应枚举值的同义表述，而无法实现模糊匹配等复杂功能。
- 组合实体：将多个实体组合起来，例如将身份实体、城市实体、区划实体以及街道实体结合在一起，形成邮寄地址实体。通常使用组合实体对复杂的，结构化的文字信息进行定义。
- 规则实体：定义了固定格式（前后缀）以及词性规则的实体。当某类型实体在句式表达上具有固定的特征，例如都有相同前缀或后缀等，可以通过规则实体定义来扩大实体的捕获范围。
添加的实体在应用时，会将本实体待选的值与客户语言匹配，如果匹配成功，则认为客户语言中包含这个实体，并将取值用于后续处理。
 #### 配置一般实体
例如您需要添加航空公司实体，可使用如下步骤添加。
1. 选择"配置中心\>机器人管理\>语义理解服务"菜单。
2. 选择"知识管理 \> 实体管理 "。单击"新增"，选择"一般实体"。
3. 填写"名称"，并依次单击"新增"，为该实体添加枚举值和枚举值的同义表述，单击"保存"。 
   ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001686972249.png)
   
   
4. 单击右上角的测试实体，在对话框窗口中输入您设置的枚举值或同义表述，如果AI机器人返回@航空公司=南方航空公司，说明配置生效。 
   ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001718989709.png)
   
   
#### 配置组合实体
您需要添加一个位置实体，表示方向和距离，例如向东100米。
1. 选择"配置中心\>机器人管理\>语义理解服务"菜单。
2. 选择"知识管理 \> \> 实体管理"。请参见[配置一般实体]增加一个一般实体，表示方向。方向实体包括东、西、南、北四个元素。
3. 单击"新增"，选择"组合实体"。
4. 填写"名称"，并单击"![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001739103184.png)"。
5. 配置组合实体。 
   1. 在下拉列表框选择[步骤 2]中增加的实体。
   
   2. 单击"![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001738962108.png)"，新增第二个下拉列表框，选择系统实体system.number，表示数字。
   
   3. 单击"![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001785961345.png)"新增第三个下拉列表框，鼠标划过第三个下拉列表框中的![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001721772688.png)，将选择实体模式变更为文本输入模式，输入"米"。
      ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001769452529.png)
      
   
   
   
   
6. 单击"保存"。
#### 配置规则实体
您需要添加一个规则实体，用于识别XXX有限公司这种公司名称实体。
1. 选择"配置中心\>机器人管理\>语义理解服务"菜单。
2. 选择"知识管理 \> 实体管理"。单击"新增"，选择"规则实体"。
3. 填写"名称"。
4. 填写具体的规则，如下所示。 
   一条规则支持对一串字符串做如下筛选：
   - 指定词性和后缀，则匹配到后缀后向前取符合词性要求的字符串，长度不超过"最大长度"的配置。 词性可多选，除通用的形容词、名词、数词和量词外，还对特殊的名词做了细分：
     - 名动词：如果使用可做动词的词组合成实体的名称，例如XX日用品批发有限公司，则可以指定词性为名动词，使实体匹配更精确。
     
     - 方位词：表示除前后缀外，剩余字符为表示前、后、上、下等的词。
     
     - 机构团体名：表示除前后缀外，剩余字符为机构团体。
     
     - 地名：表示除前后缀外，剩余字符为城市、省份。
      
   
   - 不指定词性，则截取前缀和后缀中间的字符数，长度不超过"最大长度"的配置。 是否精确匹配表示使用前后缀进行匹配的模式。
     是否包含前后缀是指，是否将前后缀对应的信息作为实体的内容，例如本例中需要启用"是否将后缀包含进实体结果"，实体匹配出来后为"XX有限公司"。
     
   
   
   ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001769976137.png)
   
   
5. 单击"保存"。