在使用前,请先开通 消息队列 RocketMQ 服务。
概述
智能对话分析服务作为消息的生产者,通过向您的阿里云消息队列RocketMQ服务中发送消息的方式推送相关信息给您,您作为消息的消费者从RocketMQ中接收并消费消息,从而实现低延迟、高并发、高可用的消息推送。
授权
需要您授权,允许智能对话分析服务向您的消息队列RocketMQ中发送消息。请使用阿里云主账号登录,点击智能对话分析控制台左侧导航中的基础设置-消息队列,如下图,先点击 前往授权 按钮,请详细阅读弹出窗口中的内容,确认无误后中点击 确认 按钮完成授权。
消息队列配置信息
授权成功后,会显示如上图页面,点击编辑按钮,开始填写 消息队列配置信息
配置信息的内容,您可以从 消息队列RocketMQ控制台 获取,需要注意的是,消息队列RocketMQ服务的实例所属地域需要为 公网。
接入点:接入点地址需要填写TCP协议的地址,因为我们发送消息时使用的是RocketMQ官方推荐的TCP协议。
实例ID:消息队列服务的实例ID,实例所在地域需要为 公网。
Topic:Topic 在创建时消息类型需要选择为 顺序消息-全局顺序消息
Group ID:
以上配置信息填写完毕后,点击测试按钮,测试您所填写的消息队列服务配置是否可用,我们会发送一条消息来测试服务连通性,结果如下图:
发送消息的类型,目前支持以下三种:
实时质检单句语音识别结果:一个实时质检会话会推送N次,也就是每调用一次 SyncQualityCheck(实时质检) 接口,就会推送一次单句语音识别结果。
实时质检全文语音识别结果:通话结束后,推送一个实时质检会话完整的语音识别结果,一个通话仅推送一次,也就是调用 UpdateSyncQualityCheckData(维护录音信息)接口后进行推送。
实时质检对话分析结果:也就是质检结果(规则命中信息),不支持单独发送,需要与 实时质检单句语音识别结果 或 实时质检全文语音识别结果 类型的消息一起发送,也就会说在发送语音识别结果消息时携带质检结果。
消息推送的类型及消息结构说明
下图为通过消息队列服务控制台查询消息,可以看到智能对话分析目前会推送三种不同Tag的消息,您可以根据Tag的不同进行不同的处理。
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 | 消息类型,可能值:
|
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代表第二句。 |