实体（Entity）是自然语言处理领域中的重要概念，是一个规范的自然语言短语集合，通常定义为应用所在领域的关键词、术语。如常见的时间、地点、POI、人名、数量等，都可以作为实体来处理。

设置实体是为了告诉平台算法，当从用户语句中解析参数时，参数的取值范围是什么。

实体分为 自定义实体 和平台提供的 公共实体。

一. 自定义实体

根据自身的业务需求，开发者可以创建自定义的实体，填充实体内容。

1. 创建实体

点击自定义技能中的 实体 菜单，点击 创建实体，填写实体名称和实体标识名。

实体名称：要求中文字符，便于开发者在多个实体中快速找到需要的实体。

实体标识名：是实体被意图中参数关联时的标识，实体标识名可以使用各种字符。

2. 设置实体值

在实体值版块中选择 添加实体，输入想要添加的实体值内容。支持多个实体值同时输入(最多20个)，实体值之间以 空格 分隔，然后按 回车键 添加实体。

3. 设置同义词

当某条实体值还有其它同义词时，需要将同义词配置到相应的实体后。点击 编辑，单击同义词的输入框，逐条输入该实体值的同义词，每输入一条同义词按一次回车完成输入。全部输入后点击 保存。

4. 其它添加实体值的途径

批量上传：开发者也可以通过 .csv 文件批量上传。点击 批量上传 按钮，在弹出提示框中下载文件模板，填写实体内容后上传即可。

算法推荐：算法推荐会根据实体名称智能推荐相关的实体值。点击 算法推荐，选中需要的实体值，点击 确认 即可将选中的实体值导入你创建的实体中。

目前支持推荐的词语为：旅游景点、学科知识、节目、诗歌、诗人、人物、演员、组织机构、河流、海洋、山脉、湖泊、歌手、歌曲、专辑、作曲家、作词家、编曲家、电影、语言、历史、省份、国家、大洲、城市、垃圾、食物、家庭称谓、朝代、书、动物

动态获取实体：使用 API 方式向平台推送更新频繁的实体内容。风险较大，已停止接入动态获取实体。

例句语料绑定参数：例句式语料在绑定参数的时候，会自动将标注的词语添加到参数关联的实体中。

二. 公共实体

公共实体是平台提供的已经填充好内容的实体，直接引用即可，不需要开发者做额外的填充工作。如 数字 实体就可以引用平台提供的 sys.anyNumber 公共实体。

已开放的公共实体介绍如下：

• sys.price：价格，几 / 几点几 + 货币单位 。国内常用货币单位【元/园/块、角/毛、分 等】，国外常用货币单位【美元/刀、欧元、英镑、法郎、加元 等】。

• sys.length：长度，几 / 几点几 + 长度单位。国际标准长度单位【纳米、微米、毫米、厘米/公分、分米、米、千米/公里、光年 、海里 等】，国内常用非标长度单位【寸、尺、丈、里、码 等】，国外常用非标长度单位【英尺、英里 等】

• sys.weight：重量， 几 / 几点几 + 重量单位。国际标准重量单位【微克、毫克、克、千克/公斤、吨、克拉】，国内常用非标重量单位【斤】，国外常用非标重量单位【磅、盎司】

• sys.temperature：温度，（零上/零下/负）几 / 几点几 + 温度单位。温度单位【度、摄氏度、华氏度 等】，其他常用的表达【绝对多少度、室温、常温、沸点、冰点】

• sys.anyNumber：任意数字， 整数、小数、负数   等。

• sys.age：年龄，几/几点几 +  岁/周岁/虚岁、几岁几个月、几岁多少天  等。

• sys.color：常用的颜色，红色、蓝色、茶色、咖啡色、XX   红/黄/蓝/绿/青/紫/黑/白/灰/褐 等。

• sys.province：国内省级行政区名称， 浙江、四川、内蒙古、黑龙江 等，同义词中有省级行政区的全称，浙江省，内蒙古自治区，香港特别行政区 等。

• sys.location：国内城市名称， 北京、上海、杭州  等。

• sys.specification：常用的购物规格单位，如 桶、箱、条、盒、袋等，或常用的重量、体积、数量 等单位。

• sys.date：时间的通用描述， 前/去/今/明/后  年 + 几月几号/二十四节气/节日、农历 几月几号、昨天、今天、明天、后天 等。

• sys.volumePlace：家内地点，如 客厅、主卧、餐厅、工作间、起居室 等。

• sys.precentage：折扣，几点几折、几点几成、几分之几、百分之/千分之 几  等。

• sys.ordinal：序号，第几。包含英文（如 first、second 等）。

• sys.area：面积，几 / 几点几 + 面积单位。国际标准面积单位【平方毫米、平方厘米、平方分米、平方米、平公里、顷/公顷】，国内常用非标面积单位【亩】，国外常用非标面积单位【英亩、平方英尺、平方英里】。

• sys.duration：持续时长，可精确到秒。如 几年、几月、几天 + 几小时 + 几分 + 几秒。

• sys.timeRange：时间范围，几点几分 +  至/到  + （凌晨/早上/上午/中午/下午/晚上 等）几点几分。

• sys.dateRange：日期区间，一个日期  至/到  另一个日期。

• sys.datetimeRange：具体的时间段范围，可以精确到分钟级别的描述。如  前/去/今  +  年/星期/周 + 几点几分   +  至/到   +   今/明/后   +  年/星期/周   +  几点几分。

• sys.datetime：具体时间点的描述，如 今天下午3点，后天早上5点3刻 等。

• sys.time：日期，几月几号、几点几分、二十四节气、各种节假日  等。

点击 引用公共实体，打开对应实体的 引用 按钮即可引用完成，返回实体列表就可看到引用的公共实体。