消息队列

重要

在使用前,请先开通 消息队列 RocketMQ 服务。

概述

智能对话分析服务作为消息的生产者,通过向您的阿里云消息队列RocketMQ服务中发送消息的方式推送相关信息给您,您作为消息的消费者从RocketMQ中接收并消费消息,从而实现低延迟、高并发、高可用的消息推送。

授权

需要您授权,允许智能对话分析服务向您的消息队列RocketMQ中发送消息。请使用阿里云主账号登录,点击智能对话分析控制台左侧导航中的基础设置-消息队列,如下图,先点击 前往授权 按钮,请详细阅读弹出窗口中的内容,确认无误后中点击 确认 按钮完成授权。

image.png

消息队列配置信息

image.png

授权成功后,会显示如上图页面,点击编辑按钮,开始填写 消息队列配置信息

消息队列配置信息

配置信息的内容,您可以从 消息队列RocketMQ控制台 获取,需要注意的是,消息队列RocketMQ服务的实例所属地域需要为 公网。

  • 接入点:接入点地址需要填写TCP协议的地址,因为我们发送消息时使用的是RocketMQ官方推荐的TCP协议。image.png

  • 实例ID:消息队列服务的实例ID,实例所在地域需要为 公网。

image.png

  • Topic:Topic 在创建时消息类型需要选择为 顺序消息-全局顺序消息

image.png

  • Group ID:

image.png

以上配置信息填写完毕后,点击测试按钮,测试您所填写的消息队列服务配置是否可用,我们会发送一条消息来测试服务连通性,结果如下图:

image.png

发送消息的类型,目前支持以下三种:

  • 实时质检单句语音识别结果:一个实时质检会话会推送N次,也就是每调用一次 SyncQualityCheck(实时质检) 接口,就会推送一次单句语音识别结果。

  • 实时质检全文语音识别结果:通话结束后,推送一个实时质检会话完整的语音识别结果,一个通话仅推送一次,也就是调用 UpdateSyncQualityCheckData(维护录音信息)接口后进行推送。

  • 实时质检对话分析结果:也就是质检结果(规则命中信息),不支持单独发送,需要与 实时质检单句语音识别结果实时质检全文语音识别结果 类型的消息一起发送,也就会说在发送语音识别结果消息时携带质检结果。

消息推送的类型及消息结构说明

下图为通过消息队列服务控制台查询消息,可以看到智能对话分析目前会推送三种不同Tag的消息,您可以根据Tag的不同进行不同的处理。

image.png

  • testEvent:智能对话分析发送的测试消息,用来验证您所填写的消息队列配置信息是否可用。此类消息您可以直接丢弃,不用做任何处理。消息内容示例:

    • {
          "eventType":"testEvent"
      }
  • SyncResult:实时质检单句结果,消息内容示例:

    • {
          "checkResult":{
              "rules":[
                  {
                      "highlight":[
                          {
                              "3868":[
                                  {
                                      "val":"阿里云",
                                      "pid":0,
                                      "from":6,
                                      "to":9,
                                      "tid":"202010***",
                                      "cid":"3***"
                                  }
                              ],
                              "cid":"31***"
                          }
                      ],
                      "hit":[
                          {
                              "phrase":{
                                  "role":"客服",
                                  "identity":"某客服",
                                  "words":"您好,这里是阿里云客服中心,有什么可以帮您的?",
                                  "emotionValue":7,
                                  "end":3930,
                                  "pid":0,
                                  "begin":410
                              },
                              "cid":[
                                  "31***"
                              ]
                          }
                      ],
                      "rid":"2***"
                  }
              ]
          },
          "event":"SyncResult",
          "syncQualityCheckObject":{
              "beginTime":1603959093000,
              "callId":"20201028***",
              "callType":3,
              "callee":"1760066***",
              "caller":"268822***",
              "customerServiceId":"20526561358***",
              "customerServiceName":"a***",
              "dialogue":{
                  "begin":410,
                  "channelId":0,
                  "emotionValue":7,
                  "end":3930,
                  "hourMinSec":"00:00",
                  "identity":"某客服",
                  "role":"客服",
                  "speechRate":443,
                  "words":"您好,这里是阿里云客服中心,有什么可以帮您的?"
              },
              "dialogueStatus":2,
              "dialogueTaskUuid":"202010297009ba73-635e-40a2-8245-16315***",
              "ruleIds":[
                  "254***",
                  "255***",
                  "251***"
              ],
              "skillGroupId":"zc1",
              "skillGroupName":"职场1",
              "sourceType":1,
              "taskId":"20201029C963BA7A-0DD5-45EC-AA40-4A46DC0***",
              "tid":"202010***"
          }
      }
  • SyncAllResult:实时质检全文结果,消息内容示例:

    • {
          "checkResult":{
              "result":[
                  {
                      "rules":[
                          {
                              "highlight":[
                                  {
                                      "38***":[
                                          {
                                              "val":"阿里云",
                                              "from":6,
                                              "pid":0,
                                              "to":9,
                                              "tid":"202010***",
                                              "cid":"31***"
                                          }
                                      ],
                                      "cid":"31***"
                                  }
                              ],
                              "hit":[
                                  {
                                      "keyWords":[
                                          {
                                              "val":"阿里云",
                                              "from":6,
                                              "pid":0,
                                              "to":9,
                                              "tid":"202010***",
                                              "cid":"31***"
                                          }
                                      ],
                                      "phrase":{
                                          "role":"客服",
                                          "emotionValue":7,
                                          "words":"您好,这里是阿里云客服中心,有什么可以帮您的?",
                                          "pid":0,
                                          "identity":"某客服",
                                          "end":3930,
                                          "begin":410
                                      },
                                      "cid":[
                                          "31***"
                                      ]
                                  }
                              ],
                              "rid":"25***"
                          },
                          {
                              "highlight":[
                                  {
                                      "38***":[
                                          {
                                              "val":"公测",
                                              "from":13,
                                              "pid":1,
                                              "to":15,
                                              "tid":"202010***",
                                              "cid":"31***"
                                          }
                                      ],
                                      "cid":"31***"
                                  }
                              ],
                              "hit":[
                                  {
                                      "keyWords":[
                                          {
                                              "val":"公测",
                                              "from":13,
                                              "pid":1,
                                              "to":15,
                                              "tid":"202010***",
                                              "cid":"31***"
                                          }
                                      ],
                                      "phrase":{
                                          "role":"客户",
                                          "emotionValue":6,
                                          "words":"我想要申请参加XXX产品的公测体验。",
                                          "pid":1,
                                          "identity":"某客户",
                                          "end":8000,
                                          "begin":5940
                                      },
                                      "cid":[
                                          "31***"
                                      ]
                                  }
                              ],
                              "rid":"25***"
                          }
                      ],
                      "tid":"202010***"
                  }
              ],
              "app_key":"1",
              "status":200
          },
          "event":"SyncAllResult",
          "syncQualityCheckObject":{
              "beginTime":1603959093000,
              "dialogueList":[
                  {
                      "begin":410,
                      "channelId":0,
                      "emotionValue":7,
                      "end":3930,
                      "hourMinSec":"00:00",
                      "identity":"某客服",
                      "pid":0,
                      "role":"客服",
                      "speechRate":443,
                      "words":"您好,这里是阿里云客服中心,有什么可以帮您的?"
                  },
                  {
                      "begin":5940,
                      "channelId":1,
                      "emotionValue":6,
                      "end":8000,
                      "hourMinSec":"00:23",
                      "identity":"某客户",
                      "pid":1,
                      "role":"客户",
                      "speechRate":192,
                      "words":"我想要申请参加XXX产品的公测体验。"
                  },
                  {
                      "begin":11000,
                      "channelId":0,
                      "emotionValue":5,
                      "end":15680,
                      "hourMinSec":"00:25",
                      "identity":"某客服",
                      "pid":2,
                      "role":"客服",
                      "speechRate":30,
                      "words":"好的,我记下了,稍后会有专员与你联系。"
                  }
              ],
              "dialogueStatus":3,
              "dialogueTaskUuid":"20201029a8b0ccc5d07c43e780aa702da***",
              "fileName":"202010***.wav",
              "taskId":"2020102908657590-73e0-4e4c-a34c-750***",
              "tid":"202010***",
              "voiceFileUrl":"https://sca-buck***.oss-cn-beijing.aliyuncs.com/a***st.wav"
          }
      }

消息内容为JSON格式,数据结构描述如下:

字段

类型

示例值

描述

event

String

SyncResult

消息类型,可能值:

  • SyncResult:实时质检单句结果。

  • SyncAllResult:实时质检全文结果。

  • testEvent:智能对话分析发送的测试消息。

checkResult

Object

{}

质检结果。详见下方的 checkResult结构描述。

syncQualityCheckObject

Object

{}

实时质检对象,为通话相关信息,和转写结果。详见下方的syncQualityCheckObject结构描述。

syncQualityCheckObject结构描述

字段

类型

示例值

描述

dialogueStatus

Integer

2

实时质检会话开始、结束的标识,可能值:1(开始);2(对话中)。

taskId

String

20201029C963BA7A-0DD5-45EC-AA40-4A46DC0***

任务ID。

tid

String

202010***

通话唯一标识。

customerServiceId

Long

20526561358***

客服Id。可从控制台-基础设置-人员管理页面获取,正确填入客服id,客服登录控制塔时可以查看与自己关联的录音文件。

customerServiceName

String

agent

客服姓名。

skillGroupId

Long

1231324234*

技能组Id。

skillGroupName

String

售前技能组

技能组名称。

callType

Integer

1

呼叫类型,可取值:1(呼出)(默认);3(呼入);4(其他)

callee

String

1760066***

被叫号码,呼出时指的是客户号码,呼入时指的是客服号码。

caller

String

0211234****

主叫号码,呼出时指的是客服号码,呼入时指的是客户号码。

callId

String

2020102***

通话id(acid),可以是呼叫中心系统中的通话id,或者其他可以标识通话的id,存在转接时,坐席1~n,callid是相同的,tid不同。

dialogue

Object

实时质检单句语音识别结果。详见下方的 dialogue描述。

dialogueList

Array

实时质检全文语音识别结果。见下方的 dialogue描述。

ruleIds

Array

[1321,23321]

质检时使用的质检规则的规则ID列表。

dialogue描述

属性

值类型

示例值

说明

role

String

客服

对话内容角色,取值:客服、客户、系统。

identity

String

123**

对话角色的具体身份标识,比如客服ID,客户ID等。

words

String

您好,欢迎致电**

这个角色说的一句话。

begin

Integer

3400

相对起始点的开始时间偏移,单位ms。

end

Integer

5688

相对起始点的结束时间偏移,单位ms。

emotionValue

Integer

6

情绪能量值1-10,值越高情绪越强烈。

speechRate

Integer

279

本句的平均语速,单位为每分钟字数。

checkResult结构描述

字段

类型

示例值

描述

rules

Array

[{}]

命中规则列表,详见下方 rules结构描述。

rules结构描述

字段

类型

示例值

描述

highlight

Array

[]

高亮对象列表,详见下方 HighlightObject结构描述。

hit

Array

[]

命中句子列表,详见下方 HitObject结构描述。

rid

Long

23**

规则id。

HighlightObject结构描述

字段

类型

示例值

描述

cid

Long

34***

算子id

算子id

Array

23**

该算子在当前句子中命中位置,需要高亮位置的列表,详见下方的 高亮位置结构描述。

高亮位置结构描述

字段

类型

示例值

描述

val

String

阿里云

高亮文字。

from

Integer

6

起始位置。

to

Integer

9

结束位置。

cid

Long

32**

条件id。

pid

Integer

1

句子位置编号,命中句子在所有句子中的下标值,0代表第一句,1代表第二句。

HitObject结构描述

字段

类型

示例值

描述

phrase

Object

{}

命中句子的详细信息,详见下方 phrase结构描述。

cid

Array

[34**,32**]

命中的条件ID列表。

phrase结构描述

字段

类型

示例值

描述

words

String

您好,欢迎致电**

句子内容。

begin

Integer

3477

起始相对时间,毫秒。

end

Integer

6890

结束相对时间,毫秒。

role

String

客服

角色,可能值:客服、客户。

pid

Integer

1

句子位置编号,命中句子在所有句子中的下标值,0代表第一句,1代表第二句。