更新时间：2026-02-03 GMT+08:00
管理实体&变量
实体
- 概念：实体是在对话过程中，需要收集的核心业务数据，如：城市、日期、颜色、品牌名称等。
- 作用：对同一个意图加上不同的属性时，则会衍生出一个新的意图，如“查天气意图”加上“地址”属性后，则会衍生出“查询杭州天气意图”“查询北京天气意图”“查询江西天气意图”等意图，且所衍生出的各意图对应回复内容不尽相同。通过实体配置则可将此类意图归结为“查询某地址天气意图”，此处“地址”即为一个实体，对应的通过调用实体信息的方式配置对应意图的回复内容，大大提升了列举意图及其对应回复内容的效率。
- 使用：可在收集实体、收集用户回复、大模型调用、API调用、自定义调用、自定义调用、固定模板回复、条件判断的节点中使用已存在的实体值。
以下为新建实体的操作步骤：
- 单击“技能编排”右上方的“实体”，进入实体管理页面。
图1 进入实体管理方式一
- 进入实体管理页面后在“实体管理”页面，单击
，按下表填写参数后，单击“保存”创建自定义实体。
图2 新建实体
表1 新建实体参数 参数
说明
实体名称
支持由大小写字母、数字、空格、汉字以及部分符号（“_”、“-”、“#”）组成，输入长度为1~64字符，名称创建后可修改。
实体继承
新创建的实体，可以继承系统实体，将相似实体进行归类。非必填参数。
实体值
当前实体的字典列表，用户可以自定义输入符合该实体描述的值域。非必填参数。
变量
- 概念：变量是在对话过程中，需要收集的关键参数。
- 作用：记录对话过程中涉及到的关键参数，可以在本轮对话的后续流程节点中引用或输出。
- 使用：在收集用户回复、大模型调用、API调用、自定义调用、自定义调用、固定模板回复、条件判断的节点中使用已被赋值的变量。
以下为新建变量的操作步骤：
系统预置变量用户输入、用户输入的多轮改写结果、用户ID、触发意图名称、对话历史、扩展信息。如果以上变量不能满足您的需求，可以自定义变量。
- 单击“技能编排”页面右上方的“变量”，进入变量管理页面。
图3 进入变量管理方式一
- 进入变量管理页面后，单击
，按下表填写参数后，单击“保存”创建自定义变量。
图4 新建实体
表2 新建实体参数 参数
说明
变量名称
由大小写字母、数字、空格组成，输入长度为1~64字符，名称创建后可修改。
变量描述
描述此变量。非必填参数。
父主题： 技能编排
