全部产品
云市场

获取结果

更新时间:2019-07-25 12:15:55

接口说明

查询质检结果,可以根据某个taskId查询,也可以根据时间范围查询。

入参GetResultRequest说明

属性 值类型 是否必须 说明
jsonStr String 完整Json字符串信息,具体内容参见以下详细信息

请求参数Json字符串信息

属性 值类型 是否必须 说明
taskId String 上传待检数据后回传的taskId,一般来说,要么根据taskId查询,要么根据时间范围进行查询,所以taskId与startTime/endTime2者必选其一
startTime String 分析时间查询区间之开始时间,会根据待检数据上传时间进行查询,格式’yyyy-MM-dd HH:mm:ss’
endTime String 分析时间查询区间之结束时间,会根据待检数据上传时间新型查询,格式’yyyy-MM-dd HH:mm:ss’
pageSize Integer 每页返回的数据数,要求大于0,小于100,默认10
pageNumber Integer 要求返回的第几页的数据,默认1
fileId String 对应相应的电话或工单数据ID,返回结果中只包含该fileId的数据
countTotal Boolean 是否计算总数据量,默认true
requiredFields String 返回结果需要包括哪些字段,多个字段用逗号分隔,请按需选择; 可选字段:taskId(任务id), score(得分), status(状态), recording(文件信息), recording.dataSet(数据集名称), asrResult(转写结果), hitResult(质检结果),comments(复核意见), agent(坐席信息);默认值:score,status,taskId,hitResult
excludeFields String 返回结果中不需要包括哪些字段,通常是子字段,多个字段用逗号分隔;取值:hitResult.hits,
sourceType Integer 文件来源,0: 呼叫中心(即api上传);3:数据集
datasetId Long 当sourceType=3时,可以指定文件来自哪个数据集
dataType Integer 文件类型,0: 文本;1:音频
customerServiceName String 客服姓名,只返回该客服的结果
customerServiceId String 客服ID,只返回该客服的结果
caller String 主叫号码
callee String 被叫号码
callId String 通话ID
skillGroupName String 技能组名称
hitStatus Integer 命中状态,0: 无规则命中;1:有规则命中
reviewStatus Integer 复核状态,0: 未复核;1:已复核
scoreType Integer 与totalScore一起根据质检得分筛选,1:返回等于totalScore的记录;2:返回小于totalScore的记录;3:返回大于totalScore的记录
totalScore Integer 与scoreType一起根据质检得分筛选,分值
durationType Integer 与duration一起根据录音时长筛选,1:返回等于duration的记录;2:返回小于duration的记录;3:返回大于duration的记录
duration Integer 与durationType一起根据录音时长筛选,录音时长,单位:秒
fileName String 文件完整名称, 不支持模糊搜索

返回参数说明

返回参数JSON字符串:

属性 值类型 是否必须 说明
code String 结果代码,200表示成功,若为别的值则表示失败,调用方可根据此字段判断失败原因
message String 出错时表示出错详情,成功时为successful
requestId String 请求id,提工单时可提供此字段值用于排查问题
success Boolean 请求是否成功,调用方可根据此字段来判断请求是否成功:true表示成功;false/null表示失败
pageSize Integer 每页条数
pageNumber Integer 当前页
count Integer 总条数
data List 返回结果,各字段详见下面描述

分析结果信息字段ResultInfo描述

属性 值类型 是否必须 说明
status Integer 任务当前状态;0:未完成;1:已完成;调用方可根据此字段判断任务是否完成;非0、1表示出错,错误详情可查看errorMessage字段
errorMessage String 当status是非0、1时表示错误详情
reviewStatus Integer 复核状态;0:未复核;1:已复核
reviewResult Integer 复核准确性;0:错误;1:正确
score Integer 文件最终得分,满分100
comments String 复核意见
taskId String 任务id
taskName String 任务名称,数据集任务有值
reviewer String 分配的质检员
resolver String 实际复核的质检员
agent Agent 客服相关信息,字段详见下面描述
recording Recording 录音文件信息,字段详见下面描述
asrResult AsrResult 文件转写结果,字段详见下面描述
hitResult HitResult 规则命中结果,字段详见下面描述

ResultInfo中字段Agent描述

属性 值类型 是否必须 说明
id String 客服id
name String 客服姓名
skillGroup String 技能组名称

ResultInfo中字段Recording描述

属性 值类型 是否必须 说明
id String 文件ID,即请求参数中的callId,若未指定则会随机生成一个
name String 文件名称
url String 文件地址
duration Long 通话时长,单位:秒
dataSetName String 文件所属数据集,当文件是数据集上传时有值
callTime String 录音生成时间戳,精确到毫秒
callType Integer 呼叫类型, 1: 呼出;3:呼入
caller String 主叫号码
callee String 被叫号码
callId String 通话ID

ResultInfo中字段AsrResult描述

属性 值类型 是否必须 说明
role String 本句的角色,取值:客服、客户
words String 对话内容
begin Long 本句相对于整个对话的开始时间,单位:毫秒
end Long 本句相对于整个对话的结束时间,单位:毫秒
emotionValue Integer 本句的情绪值,0-10,值最大情绪越高
speechRate Integer 本句语速,单位:字/分钟

ResultInfo中字段HitResult描述

属性 值类型 是否必须 说明
rid String 命中的规则ID
name String 命中的规则名称
hits Hit 命中详情

ResultInfo中字段HitResult.Hit描述

属性 值类型 是否必须 说明
cid List 命中的条件ID
keyWords KeyWord 命中的关键字(针对关键字、正则类型的算子)
phrase Phrase 命中的句子信息

ResultInfo中字段HitResult.Hit.KeyWord描述

属性 值类型 是否必须 说明
cid String 命中的条件ID
from String 关键字的起始位置
to String 关键字的结束位置
val Hit 关键字

ResultInfo中字段HitResult.Hit.Phrase描述

属性 值类型 是否必须 说明
role String 本句的角色,取值:客服、客户
words String 对话内容
begin Long 本句相对于整个对话的开始时间,单位:毫秒
end Long 本句相对于整个对话的结束时间,单位:毫秒
emotionValue Integer 本句的情绪值,0-10,值越大情绪越高
speechRate Integer 本句语速,单位:字/分钟

调用示例

  1. public GetResultResponse getResult(String taskId, String startTime, String endTime) throws ClientException {
  2. GetResultRequest request = new GetResultRequest();
  3. Map<String, Object> param = new HashMap<>(2);
  4. param.put("taskId", taskId);
  5. // taskId与startTime/endTime只需要2者之一即可
  6. param.put("startTime", startTime);
  7. param.put("endTime", endTime);
  8. param.put("pageNumber", 1);
  9. param.put("pageSize", 10);
  10. param.put("countTotal", true);
  11. param.put("requiredFields", "score,status,taskId,recording,hitResult");
  12. request.setJsonStr(JSON.toJSONString(param));
  13. return client.getAcsResponse(request);
  14. }

返回示例

  1. {
  2. "code":"200",
  3. "pageNumber":1,
  4. "data":[
  5. {
  6. "score":90,
  7. "agent":{
  8. "skillGroup":"质检技能组勿删",
  9. "name":"智能对话分析客服勿删",
  10. "id":"282408763939515643"
  11. },
  12. "asrResult":[
  13. ],
  14. "createTime":"2019-07-24T19:31Z",
  15. "reviewResult":0,
  16. "recording":{
  17. "duration":40,
  18. "bizUrl":"http://ccc.aliyun.com/record/DownloadRecord.json?request={"connectId":"2393853621","instanceId":"mybank-debt","fileName":"156396769917400080392292.wav"}",
  19. "callee":"17600668806",
  20. "name":"2393853622-11-28-19.mkv",
  21. "id":"158126f2-ecb5-4e6b-82c0-290a3405c26d",
  22. "primaryId":"3437500",
  23. "callTime":"1563967699000",
  24. "callType":1,
  25. "url":"http://ccc.aliyun.com/record/DownloadRecord.json?request={"connectId":"2393853621","instanceId":"mybank-debt","fileName":"156396769917400080392292.wav"}"
  26. },
  27. "reviewStatus":1,
  28. "hitResult":[
  29. {
  30. "hits":[
  31. ],
  32. "name":"20190417回归3",
  33. "rid":"1277"
  34. },
  35. {
  36. "hits":[
  37. ],
  38. "reviewResult":1,
  39. "name":"20190417回归2",
  40. "rid":"1276",
  41. "type":"0417回归类型"
  42. },
  43. {
  44. "hits":[
  45. ],
  46. "reviewResult":1,
  47. "name":"【预置】开头与结尾未用礼貌用语",
  48. "rid":"1346"
  49. },
  50. {
  51. "hits":[
  52. ],
  53. "reviewResult":1,
  54. "name":"0710回归0710回归0710回归0710回归0710回归0710回归0710回归0710回归0710回归0710回归0710回归",
  55. "rid":"1356",
  56. "type":"0417回归类型"
  57. },
  58. {
  59. "hits":[
  60. ],
  61. "reviewResult":1,
  62. "name":"【预置】让客户等待后未致歉",
  63. "rid":"1343"
  64. }
  65. ],
  66. "taskId":"7A6BEC8D-9A5B-4BE5-8432-4F635E602351",
  67. "status":1
  68. }
  69. ],
  70. "requestId":"3CEA0495-341B-4482-9AD9-8191EF4E3607",
  71. "success":true,
  72. "count":1,
  73. "pageSize":10,
  74. "message":"successful"
  75. }