智能对话分析 上传音频质检

流程说明

API调用上传音频质检 => 录音文件转文本 => 根据指定的分轨方式对文本进行角色分离(区分客服、客户) => 使用质检规则进行分析 => 质检完成。

任务执行效率说明

任务执行的快慢，取决于录音文件转文本的快慢，理想情况下，一个长度为5分钟的录音文件，可以在2分钟内转写完成，但是遇到文件转写服务排队任务较多时，会有一个排队等待的时间，一般会在6小时内转写完成，一次性上传大规模数据(半小时内上传超过500小时时长的录音)的除外。转写完成后，质检分析的速度是毫秒级的。

录音文件URL要求

• 持单轨/双轨的wav格式、mp3格式的录音文件，文件大小需要控制在512M以下
• URL必须是基于HTTP可访问的URL地址，不支持提交本地文件；录音文件访问权限需要为公开。
• URL中只能使用域名，不能使用IP地址，URL中不可包含空格，请尽量避免使用中文。
• 系统在录音转文本后，会将下载的录音文件删除，不会保存录音副本
• 若您的录音url是存在访问有效期的，例如录音存储在阿里云OSS，通过OSS生成录音url时指定了有效期，建议有效期至少为12小时，如果条件允许，最好设置为24小时。这样做是因为文件转写需要一定的时间，并且偶尔会产生排队等待，若排队时间较长，开始转写时才会下载录音，避免下载录音时录音url已失效的情况发生。
• 质检分析完成后，在控制台复核文件时，播放录音使用的仍然是您提供的URL，所以需要保证URL长期可用，否则将无法播放录音。

角色分离说明

录音转文本后，系统会自动将文本分为两个对话角色，但是系统无法判断哪个角色是客服、哪个是客户。所以需要您来根据某些规则进行角色分离。角色分离的准确性非常重要，因为我们进行质检分析时所用的规则，很多时候都有检测角色的限制（即一个规则只检测客服或者客户），如果角色分离错误，那么将对质检结果的准确性产生极大影响。

录音文件通常分为 单轨(单声道) 和 双轨(双声道/立体声) 两种：

• 单轨录音：客服、客户 两个人的声音存储在一个轨上，在录音文件转文本后，系统会通过内置算法区分为两个角色的对话，通过设置一组客服可能说的关键词列表，通过对转写文本从上到下逐句分析，当一句话命中某一个关键词时，则判定该句的角色为客服，则另一个角色就是客户，具体使用详见请求入参中的 recognizeRoleDataSetId 和 serviceChannelKeywords。由于对话内容的不可控性(比如两个角色对话存在交叉，两个人同时讲话)，所以单轨录音的角色分离无法保证100%准确，强烈建议在保存录音文件时保存为双轨录音。
• 双轨录音：客服、客户 两个人的声音分别存储在两个轨上，即使两个角色的对话存在交叉录音转文本时可以准确的区分为两个角色，所以直接通过请求参数中的 serviceChannel、clientChannel 来指定客服、客户 即可。

获取质检分析结果

由于录音文件识别是非实时的，所以需要异步获取质检分析结果，有以下2种方式获取结果：

• 回调：通过在请求参数中指定callbackUrl，在任务完成后由系统主动发起回调，接到回调后再通过getResult接口获取详细结果。
• 轮询：接口会返回任务ID(taskId)，可以用taskId轮训getResult接口异步获取结果，判断返回参数中的status是否完成，轮询间隔建议不要太短，正常情况下会在几分钟内分析完成，建议轮询间隔在30s以上。

请求参数

请求参数与Json字符串信息

jsonStr.callList 属性说明:

回调参数说明

假设调用方传入的回调地址是: http://aliyun.com/callback，那么回调时的完整url为http://aliyun.com/callback?taskId=xxx&timestamp=xxx&signature=xxx&event=xxx， 其中：

• taskId 为任务id
• timestamp 为调用时的时间戳，单位：毫秒
• aliUid 为调用方阿里云主账号uid
• signature 为签名，调用方可用来判断请求是否来自阿里云；计算说明：将taskId=xxx&timestamp=xxx&aliUid=xxx 进行md5+base64加密，注意顺序；调用方接到回调后，taskId和timestamp可以从回调url中获取，aliUid即为阿里云主账号ID，使用主账号登录访问 https://account.console.aliyun.com 会看到账号ID。，通过计算来比对自己计算出的signature，与url中的signature是否一致，详见下方Java代码示例。
• event 为事件名称，调用方可用来判断是什么事件触发的回调，取值为 TaskComplete：任务完成时的回调；

public static void signature() {
    long timestamp = System.currentTimeMillis();
    String taskId = "xxxx";
    String aliUid = "xxxxx";
    // 将 taskId=xxx&timestamp=xxx&aliUid=xxx 进行md5 + base64加密，放在signature字段
    String signature;
    try {
        signature = URLEncoder.encode(md5Base64("taskId=" + taskId + "&timestamp=" + timestamp + "&aliUid=" + aliUid), "utf-8");
        System.out.println(signature);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

public static String md5Base64(String str) throws NoSuchAlgorithmException {
    //string 编码必须为utf-8
    byte[] utfBytes = str.getBytes(StandardCharsets.UTF_8);
    MessageDigest mdTemp = MessageDigest.getInstance("MD5");
    mdTemp.update(utfBytes);
    byte[] md5Bytes = mdTemp.digest();
    return Base64.encodeBase64String(md5Bytes);
}

请求入参示例

{
    "autoSplit":1,
    "serviceChannelKeywords":[
        "留学",
        "客服老师"
    ],
    "ruleIds":[
        18128,
        15589
    ],
    "vocabId":"a7735a24c9ef4213b2fa41d****",
    "modelId":"9706",
    "callList":[
        {
            "voiceFileUrl":"https://sca-ccc-test.oss-cn-beijing.aliyuncs.com/%E7%A1%85%E8%AF%AD-%E7%95%99%E5%AD%A6%E5%BD%9B3.wav",
            "fileName":"abc.wav",
            "callStartTime":"1584535485856",
            "customerServiceId":"30",
            "customerServiceName":"Aagent",
            "skillGroupId":"34sd24",
            "skillGroupName":"售前技能组",
            "callType":1,
            "callee":18888888888,
            "caller":"01023232323",
            "callId":2345645734,
            "business":"售前一组",
            "remark1":"38节大促"
        }
    ]
}

返回数据

示例

请求示例

http(s)://qualitycheck.cn-hangzhou.aliyuncs.com/?Action=UploadAudioData
&JsonStr={“callList”:“xxxxx”}
&<公共请求参数>

正常返回示例

XML格式

<UploadAudioDataResponse>	
	  <code>200</code>
	  <data>76DB5D8C-5BD9-42A7-B527-5AF3A5F****</data>
	  <message>successful</message>
	  <requestId>76DB5D8C-5BD9-42A7-B527-5AF3***</requestId>
	  <success>true</success>
</UploadAudioDataResponse>

JSON格式

{
  "code": "200",
  "data": "76DB5D8C-5BD9-42A7-B527-5AF3A5F83***" ,
  "message": "successful",
  "requestId": "76DB5D8C-5BD9-42A7-B527-5AF3A5F83***",
  "success": true
}

错误码

访问错误中心查看更多错误码。