实体管理

功能概述

• 概念：实体是同类型单词的合集，如：城市、日期、颜色等。

• 作用：对同一个意图加上不同的属性时，则会衍生出一个新的意图，如“查天气意图”加上“地址”属性后，则会衍生出“查询杭州天气意图”、“查询北京天气意图”、“查询江西天气意图”等意图，且所衍生出的各意图对应回复内容不尽相同。通过实体配置则可将此类意图归结为“查询某地址天气意图”，此处“地址”即为一个实体，对应的通过调用实体信息的方式配置对应意图的回复内容，大大提升了列举意图及其对应回复内容的效率。

功能入口

1. 登录云联络中心控制台，在左侧导航栏选择实例管理-V2，单击具体实例的访问地址进入实例控制台。

2. 单击页面右上角菜单按钮，选择数字员工进入数字员工业务控制台。在左侧导航栏选择AI平台>多轮对话（对话工厂）>实体管理。

新增实体

新增标准实体

在生活和业务当中，有很多不同的词语代表着同一种意思，例如：北京、帝都、中国首都。这几个词语都是指同一个城市，那么就可以通过配置将这些词语指定到一个固定的实体下面。

1. 进入实体管理界面后，单击新增标准实体，按照实际业务需求填写信息，单击创建即可完成标准实体新建。

   • 实体名称：即实体名字，根据实际业务需求进行填写。

   • 实体code：是实体的唯一标识，新建后不能修改。

2. 实体创建完成后，自动进入实体配置界面，根据实际业务需求，完成实体内容配置后，单击保存，即完成实体新建。

   实体配置面板包含实体类型、实体名称、实体code字段，以及实体成员列表（含成员和同义词列）。可单击+添加实体成员逐行添加成员及其同义词（例如成员"上海"对应同义词"魔都"）。

新增正则实体

正则表达式是一种可以用于模式匹配和替换的规范，一个正则表达式就是由普通的字符（例如字符a到z）以及特殊字符（元字符）组成的文字模式，它用以描述在查找文字主体时待匹配的一个或多个字符串。正则表达式作为一个模板，将某个字符模式与所搜索的字符串进行匹配。每个正则实体最多可添加5条表达式。

1. 进入实体管理界面后，单击新增正则实体，按照实际业务需求填写信息，单击创建即可完成正则实体新建。

   需填写的信息包括实体类型（正则实体）、实体名称（如手机号码）和实体code（如phonenumber）。

2. 实体创建完成后，自动进入实体配置界面，根据实际业务需求，完成实体内容配置后，单击保存即完成实体新建。

   说明

   在正则表达式编写完成后，可在测试表达式窗口对正则表达式进行测试以校验其正确性。

   单击+添加正则表达式，在弹出的对话框中输入正则表达式（例如 [0-9]{11}$），确认无误后单击确定。

系统实体查看

为了让用户快速使用多轮对话功能，系统预置了很多实体供用户直接使用。系统实体具体展示与含义描述如下：

实体名称	实体描述	实体示例
@sys.number	系统-数字	一百二十五、100、零点三、1.8
@sys.phone-number	系统-手机号	176********
@sys.age	系统-年龄	15岁、30了、五十岁
@sys.ordinal	系统-序数	第一
@sys.number-fraction	系统-分数	三分之一，1/3
@sys.percentage	系统-百分数	百分之20，20%
@sys.money	系统-金额	200元
@sys.temperature	系统-温度	20度、90摄氏度、20.5华氏度
@sys.number-range	系统-数字范围	一到五，大于10
@sys.plate-number	系统-车牌号	浙A12345
@sys.date	系统-日期	明天、下周一、三月二十号、明年六月份、国庆节、2017-10-5
@sys.time	系统-时间	上午九点、中午十二点半、傍晚六点一刻
@sys.date-time	系统-日期时间	明天中午十二点半，下周三上午八点一刻
@sys.duration	系统-时间段	一小时、15分钟、一小时零五分等
@sys.timeset	系统-重复时间	每周一、每个工作日
@sys.address	系统-地址	中国上海市静安区巨鹿路882号
@sys.geo-country	系统-国家	中国、新加坡
@sys.geo-province	系统-省份	浙江、河北
@sys.geo-city	系统-城市	北京、杭州、上海
@sys.geo-district	系统-区县	朝阳区
@sys.name	系统-人名	鲁迅
@sys.surname	系统-百家姓	张

实体管理

除了支持新增实体外，系统还支持实体的导入、导出、搜索、发布与删除等操作，有关操作在实体管理界面即可完成，具体操作含义如下：

• 实体配置：配置实体的具体信息，标准实体配置实体成员及对应的同义词，正则实体配置正则表达式。

• 发布：将实体的配置发布到线上环境（发布对话机器人的时候，会同步发布实体；只有单独修改实体配置的时候可使用此发布功能）。

• 导出：支持单个实体导出，批量导出和全量导出。导入实体基本信息（实体名和类型），实体配置。基本信息不推荐在导出文件中编辑修改，实体配置可以在导入文件中增加，导入后实体配置会自动进行合并。

• 导入：支持导入实体。导入意图可以新增实体成员、新增同义词、正则表达式。

• 搜索：可以使用实体名称检索机器人内的实体。