# 语义识别图元 将客户语音提交到TUC对话引擎进行意图匹配的图元。 #### 图元展示 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002557424673.png) #### 参数介绍 - 节点名称：标识节点名称。 - 节点ID：图元节点ID，不可更改。 - 描述：节点的详细说明信息。 - 上下文：用于筛选需要匹配的意图，提升匹配速度。 - 语义识别内容：需要进行语义识别匹配的具体内容，可以为字符串或当前节点之前已经有的变量，如果为空，表示直接识别客户的语音。 - 事件：表示如果在本流程中第二次及以后进入该节点，是否要清除匹配到的意图中的槽位数据。通常在允许客户中途修改信息时设置为"清空当前上下文缓存"。 - 清空会话缓存：清空当前流程实例的所有变量的值。 - 清空当前上下文缓存：清空当前意图的变量值，通常用于多次执行同一个语义识别，清除上一次留存的意图数据。 - 意图个数：允许返回匹配的多个意图时设置，需配置为正整数。如果该参数设置为空，则默认和"配置中心\>机器人管理\>语义理解服务\>系统管理\>智能引擎参数\>意图参数"设置的个数一致。 - 置信度间距：当返回多个意图时，允许各意图与第一个意图的最大置信度差距。 - 缓存变量名/响应中的属性名：即流程变量及其取值。由于意图的响应参数或槽位参数只能在当前节点有效，如果您需要在后续流程中应用该值，可在此处定义缓存变量，将意图的响应参数或槽位参数的值赋给它。 - 条件名/条件表达式：定义当前图元的出口有哪些分支，例如意图匹配成功可以设置为一个分支，意图匹配失败也可以设置为一个分支，每个分支可以指定不同的后续流程。 #### 分支条件介绍 表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管理中添加意图或问答。 #### 典型使用场景 下面使用语义识别图元示例一个和机器人问候交互的场景。 1. 操作员登录AICC，选择"配置中心\>机器人管理\>语义理解服务"。 2. 配置领域和意图。 1. 选择"知识管理 \> 领域管理"，单击右上角"新增"，填写"名称"，单击"保存"。 图1新增领域界面 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002557344715.png) 2. 单击新创建领域的名称，进入"意图管理"页面。 3. 单击"新增 \> 一般意图"，填写意图名称，语料以及响应，单击"保存"。 图2新建意图 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002557344703.gif) 4. 勾选新添加的意图，单击"激活"，激活新增的意图。 3. 配置智能IVR流程。流程编排场景：用户接入后听到机器人说"你好"，用户说"你好"，机器人识别到用户说的你好后再次回复"你好"。 1. 选择"流程管理 \> 流程编排"，单击增加一个简单流程。 2. 单击"定位及变量"按钮进入[定位及变量]界面。单击流程变量后的"新建"按钮，在弹出窗口中填写变量名称和数据类型，请添加变量welcome：该变量的缺省值用于客户接入时向客户说你好，再添加一个变量default：用于语义未识别到时的默认回复，例如：未识别到意图。 图3定位及变量界面 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002557424671.png) 图4添加流程变量界面 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002526384784.png) 图5流程编排示例 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002526224838.png) - 语义识别下的机器人回复图元选择回复变量：TOC.ChatBotRespContent，表示匹配到用户说的你好后，再次回复"你好"。 - 语义识别右边的机器人回复图元选择回复变量：default，表示未匹配到用户说的你好后，回复未识别到意图。 3. 保存并发布流程。 4. 选择"智能机器人"，将流程绑定机器人。 5. 选择"智能机器人"，在对应机器人的最后一列单击"更多"，绑定已激活的领域。 6. 选择"智能机器人"，在对应机器人的最后一列单击"呼叫测试"。 进入测试对话窗口中，单击"开始呼叫"，测试机器人。输入"你好"，机器人回答"你好"表示语义识别成功。