语义识别图元

图元展示

参数介绍

节点名称：标识节点名称。
描述：节点的详细说明信息。
上下文：用于筛选需要匹配的意图，提升匹配速度。
语义识别内容：需要进行语义识别匹配的具体内容，可以为字符串或当前节点之前已经有的变量，如果为空，表示直接识别客户的语音。
事件：表示如果在本流程中第二次及以后进入该节点，是否要清除匹配到的意图中的槽位数据。通常在允许客户中途修改信息时设置为“清空当前上下文缓存”。
- 清空会话缓存：清空当前流程实例的所有变量的值。
- 清空当前上下文缓存：清空当前意图的变量值，通常用于多次执行同一个语义识别，清除上一次留存的意图数据。
意图个数：允许返回匹配的多个意图时设置，需配置为正整数。如果该参数设置为空，则默认和“配置中心>机器人管理>语义理解服务>系统管理>智能引擎参数>意图参数”设置的个数一致。
置信度间距：当返回多个意图时，允许各意图与第一个意图的最大置信度差距。
缓存变量名/响应中的属性名：即流程变量及其取值。由于意图的响应参数或槽位参数只能在当前节点有效，如果您需要在后续流程中应用该值，可在此处定义缓存变量，将意图的响应参数或槽位参数的值赋给它。
条件名/条件表达式：定义当前图元的出口有哪些分支，例如意图匹配成功可以设置为一个分支，意图匹配失败也可以设置为一个分支，每个分支可以指定不同的后续流程。

分支条件介绍

表1 分支条件
名称	含义	使用方法
timeout1	超时1次	当第三方（例如IVR系统）未接收到客户反馈，判定为超时时会给OIAP发送一个input字段为timeout的消息，此时会触发该分支条件。该分支一般应用于语义识别图元指向后续节点的连线上，表示语义识别时超时未收到客户响应。
timeout2	超时2次	在同一次通话过程中，当timeout1触发的条件第二次出现时，触发timeout2。在做话术流程设计时，第一次超时会要求流程重试，第二次失败则会跳过当前环节，进入后续流程节点。
nomatch1	未识别1次	在如下两种场景下，触发nomatch1：当语义识别图元未找到匹配结果（即语义识别图元返回未知意图命令字）。当第三方系统（例如IVR）返回input的值为nomatch的消息时。该场景通常为ASR系统识别失败返回给IVR。
nomatch2	未识别2次	在同一次通话过程中，当nomatch1触发的条件第二次出现时，触发nomatch2。
error3	错误3次	当timeout1、momatch1对应的触发条件，在同一次通话过程中累计出现3次，则会触发error3条件。如果不需要累计计算该错误次数，可在使用该条件前使用错误次数清零图元。
SYSERROR_INNER	odfs内部错误	ODFS内部发生其他未知错误时会触发该分支条件，不选择则进入异常流程。
SYSERROR_INTERFACE	业务接口调用失败	当使用业务接口调用图元进行第三方接口调用时发生错误，会触发该分支条件。该分支一般应用于业务接口调用图元指向后续节点的连线上。
slientInsertReply	静默坐席插入直接回复分支	仅在配置了静默坐席系统的语义识别图元使用，可以时客服直接回答后继续走其余预期的业务流程。

如何使用图元

当需要为客户语音进行意图匹配，识别客户需求时使用该图元。

单击图元，或使用鼠标将图元拖拽到画布上。在使用该图元前，您需要先在TUC管理中添加意图或问答。

典型使用场景

下面使用语义识别图元示例一个和机器人问候交互的场景。

操作员登录AICC，选择“配置中心>机器人管理>语义理解服务”。
配置领域和意图。
1. 选择“知识管理 > 领域管理”，单击右上角“新增”，填写“名称”，单击“保存”。
  图1 新增领域界面
1. 单击新创建领域的名称，进入“意图管理”页面。
2. 单击“新增 > 一般意图”，填写意图名称，语料以及响应，单击“保存”。
  图2 新建意图
3. 勾选新添加的意图，单击“激活”，激活新增的意图。
配置智能IVR流程。流程编排场景：用户接入后听到机器人说“你好”，用户说“你好”，机器人识别到用户说的你好后再次回复“你好”。
1. 选择“流程管理 > 流程编排”，单击增加一个简单流程。
2. 单击流程变量区域后的+，在弹出窗口中填写变量名称和数据类型，请添加变量welcome：该变量的缺省值用于客户接入时向客户说你好，再添加一个变量default：用于语义未识别到时的默认回复，例如：未识别到意图。
  图3 添加流程变量界面
  
  图4 流程编排示例
  - 语义识别下的机器人回复图元选择回复变量：TOC.ChatBotRespContent，表示匹配到用户说的你好后，再次回复“你好”。
  - 语义识别右边的机器人回复图元选择回复变量：default，表示未匹配到用户说的你好后，回复未识别到意图。
3. 保存并发布流程。
选择“智能机器人”，将流程绑定机器人。
选择“智能机器人”，在对应机器人的最后一列单击“更多”，绑定已激活的领域。
选择“智能机器人”，在对应机器人的最后一列单击“呼叫测试”。

进入测试对话窗口中，单击“开始呼叫”，测试机器人。输入“你好”，机器人回答“你好”表示语义识别成功。