调用GetResult查询质检结果。
可以查询通过 UploadAudioData、 UploadData 上传的数据,也可以查询数据集质检任务SubmitQualityCheckTask的数据。可以根据任务ID(taskId)查询,也可以根据时间范围查询。
此接⼝返回结果中默认只返回部分参数,可通过请求参数中的 requiredFields 来⾃定义设置返回参数中需要返回哪些字段。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetResult |
系统规定参数。取值:GetResult。 |
JsonStr | String | 是 | {"pageNumber":1,"pageSize":10,"excludeFields":"hitResult.hits, recording.url","requiredFields":"agent,status,errorMessage,reviewStatus,reviewResult,score,taskId,reviewer,resolver,recording.name,recording.duration,hitResult,business","dataType":1,"sourceType":0,"startTime":"2020-06-25 00:00:00","endTime":"2020-07-01 23:59:59"} |
完整Json字符串信息,具体内容参见以下详细信息。 |
请求参数Json字符串信息
属性 |
值类型 |
是否必须 |
说明 |
---|---|---|---|
taskId |
String |
否 |
上传待检数据后回传的taskId,一般来说,要么根据taskId查询,要么根据时间范围进行查询,所以taskId与startTime/endTime2者必选其一。 |
startTime |
String |
否 |
按任务上传时间(API调用时间)区间查询,区间的 开始时间,格式'yyyy-MM-dd HH:mm:ss'。 |
endTime |
String |
否 |
按任务上传时间(API调用时间)区间查询,区间的 结束时间,格式'yyyy-MM-dd HH:mm:ss'。 |
callStartTime |
String |
否 |
按录音发生时间(上传数据时接口中指定的)区间查询,区间的 开始时间,格式'yyyy-MM-dd HH:mm:ss'。 |
callEndTime |
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 |
否 |
文件完整名称, 不支持模糊搜索。 |
remark1 |
String |
否 |
自定义数据1,调用UploadAudioData接口上传质检数据时所提供 。 |
remark2 |
String |
否 |
自定义数据2,调用UploadAudioData接口上传质检数据时所提供。 |
remark3 |
String |
否 |
自定义数据3,调用UploadAudioData接口上传质检数据时所提供。 |
remark4 |
String |
否 |
自定义数据4,调用UploadAudioData接口上传质检数据时所提供 。 |
remark5 |
Long |
否 |
自定义数据5,调用UploadAudioData接口上传质检数据时所提供。该字段支持精准查询,也支持按范围查询,需配合 remark5Type、endRemark5,一起使用。(remark6不支持搜索。) |
remark5Type |
Integer |
否 |
自定义数据5按范围查询时的范围类型:3(大于)、5(小于)、7(区间),默认为 等于(精确查询)。 |
endRemark5 |
Long |
否 |
自定义数据5按区间查询时的结束值,此时使用 remark5 来指定区间的开始值。 |
remark7 |
String |
否 |
自定义数据7,调用UploadAudioData接口上传质检数据时所提供 。 |
sortField |
String |
否 |
按指定参数进行排序,目前仅 自定义数据1/2/3/4/5 支持排序,所以可输入的值为:remark1/remark2/remark3/remark4/remark5。 |
sortType |
String |
否 |
排序规则,可输入值为:desc/asc, desc: 降序,asc:升序。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 |
结果代码,200表示成功,若为别的值则表示失败,调用方可根据此字段判断失败原因。 |
Count | Integer | 1 |
总数。 |
Data | Array of ResultInfo |
查询结果。 |
|
ResultInfo | |||
Agent | Struct |
客服相关信息。 |
|
Id | String | 282408763939515643 |
客服ID。 |
Name | String | 智能对话分析客服 |
客服姓名。 |
SkillGroup | String | 质检技能 |
技能组名称。 |
AsrResult | Array of AsrResult |
文件转写结果。 |
|
AsrResult | |||
Begin | Long | 10000 |
本句相对于整个对话的开始时间,单位:毫秒。 |
EmotionValue | Integer | 1 |
本句的情绪值,0-10,值最大情绪越高。 |
End | Long | 0 |
本句相对于整个对话的结束时间,单位:毫秒。 |
Role | String | 客户 |
本句的角色,取值:客服、客户。 |
SpeechRate | Integer | 50 |
本句语速,单位:字/分钟。 |
Words | String | xx |
对话内容。 |
Comments | String | xx |
复核意见。 |
CreateTime | String | 2019-07-24T19:31Z |
任务创建时间。 |
CreateTimeLong | String | 1602743090 |
任务创建时间(时间戳格式)。 |
ErrorMessage | String | xxx |
当status是非0、1时表示错误详情。 |
HitResult | Array of HitResult |
规则命中结果。 |
|
HitResult | |||
Hits | Array of Hit |
命中规则。 |
|
Hit | |||
Cid | List | xxxx |
命中的条件ID。 |
KeyWords | Array of KeyWord |
命中的关键字(针对关键字、正则类型的算子)。 |
|
KeyWord | |||
Cid | String | xxxx |
命中的条件ID。 |
From | Integer | 1 |
关键字的起始位置。 |
To | Integer | 2 |
关键字的结束位置 |
Val | String | test |
算子命中的关键信息,详见下方 返回参数说明 中的 关键信息Val详解。 |
Phrase | Struct |
命中的句子信息。 |
|
Begin | Long | 300 |
本句相对于整个对话的开始时间,单位:毫秒。 |
EmotionValue | Integer | 0 |
本句的情绪值,0-10,值越大情绪越高。 |
End | Integer | 300 |
本句相对于整个对话的结束时间,单位:毫秒。 |
Role | String | 客服 |
本句的角色,取值:客服、客户。 |
Words | String | xxx |
对话内容。 |
Name | String | 20190417回归3 |
命中的规则名称。 |
ReviewResult | Integer | 0 |
复核准确性;0:错误;1:正确。 |
Rid | String | 1276 |
命中的规则ID。 |
Type | String | 0417回归类型 |
命中规则分类。 |
HitScore | Array of HitScore |
当前文件命中的评分项信息,包含命中规则所关联的评分项以及人工添加的评分项。 |
|
HitScore | |||
RuleId | String | 123 |
命中规则的规则id,若存在,则表示是规则关联的评分项;不存在则表示是人工添加的评分项。 |
ScoreId | String | 123456 |
评分项id。 |
ScoreName | String | 投诉 |
评分项的名称。 |
ScoreNumber | String | -20 |
评分项的分数,正数表示加分,负分表示减分。 |
Recording | Struct |
录音文件信息文件信息。 |
|
Business | String | 客服业务线 |
业务线名称,用于分类统计 |
CallId | String | XXXX |
通话ID。 |
CallTime | String | 1563967699000 |
录音生成时间戳,精确到毫秒。 |
CallType | Integer | 1 |
呼叫类型, 1: 呼出;3:呼入。 |
Callee | String | 18888888888 |
被叫号码。 |
Caller | String | 01088888888 |
主叫号码。 |
DataSetName | String | XXXX |
文件所属数据集,当文件是数据集上传时有值。 |
Duration | Long | 60 |
通话时长,单位:秒。 |
Id | String | XXXXX |
文件ID,即请求参数中的callId,若未指定则会随机生成一个。 |
Name | String | 123456.mkv |
录音文件名称。 |
PrimaryId | String | 3437500 |
录音文件ID。 |
Remark1 | String | XXX |
自定义数据1 |
Remark10 | String | XXX |
自定义数据10。 |
Remark11 | String | XXX |
自定义数据11。 |
Remark12 | String | XXX |
自定义数据12。 |
Remark13 | String | XXX |
自定义数据13。 |
Remark2 | String | XXX |
自定义数据2 |
Remark3 | String | XXX |
自定义数据3 |
Remark4 | String | XXX |
自定义数据4 |
Remark5 | Long | 1232 |
自定义数据5 |
Remark6 | String | XXX |
自定义数据6 |
Remark7 | String | XXX |
自定义数据7。 |
Remark8 | String | XXX |
自定义数据8。 |
Remark9 | String | XXX |
自定义数据9。 |
Url | String | http://aliyun.com/audio.wav |
文件地址。 |
Resolver | String | XXX |
实际复核的质检员。 |
ReviewResult | Integer | 0 |
复核准确性,可能值:0(错误);1(正确);2(部分正确);3(待复核)。 |
ReviewStatus | Integer | 1 |
复核状态;0:未复核;1:已复核。 |
ReviewTime | String | 2019-07-24T19:31Z |
最后一次复核提交的时间。 |
ReviewTimeLong | String | 1602743090 |
最后一次复核提交的时间(时间戳格式)。 |
Reviewer | String | xxx |
分配的质检员。 |
Score | Integer | 100 |
文件最终得分,满分100。 |
Status | Integer | 0 |
任务当前状态;0:未完成;1:已完成;调用方可根据此字段判断任务是否完成;非0、1表示出错,错误详情可查看errorMessage字段。 |
TaskId | String | A6BEC8D-9A5B-4BE5-8432-4F635E*** |
任务ID。 |
TaskName | String | test |
任务名称。 |
Message | String | successful |
出错时表示出错详情,成功时为successful。 |
PageNumber | Integer | 1 |
当前页。 |
PageSize | Integer | 10 |
每页条数。 |
RequestId | String | 3CEA0495-341B-4482-9AD9-8191EF4*** |
请求id,提工单时可提供此字段值用于排查问题。 |
ResultCountId | String | XXX |
预留字段,暂时没有用途,请忽略。 |
Success | Boolean | true |
请求是否成功,调用方可根据此字段来判断请求是否成功:true表示成功;false/null表示失败。 |
关键信息Val详解
算子名称 |
val值示例 |
说明 |
---|---|---|
文字检查-关键字检查 |
你好 |
当前句子中命中该算子的文本,即为复核页面查看命中位置时,句子中红色高亮的文本内容 |
文字检查-文本相似度检查 |
82 |
相似度值 |
文字检查-正则表达式检查 |
你好 |
当前句子中命中该算子的文本,即为复核页面查看命中位置时,句子中红色高亮的文本内容 |
文字检查-上下文重复检查 |
你好 |
当前句子中命中该算子的文本,即为复核页面查看命中位置时,句子中红色高亮的文本内容 |
语音检查-通话静音检查 |
3200 |
静音时长(毫秒) |
语音检查-语速检查 |
365 |
当前句子的语速值 |
语音检查-抢话检查 |
2:8 |
类型为"m:n",m为抢话时长(秒),即客服与客户说话交叉时间;n为当前句子的字数 |
语音检查-角色判断 |
你好 |
当前句子中命中该算子的文本,即为复核页面查看命中位置时,句子中红色高亮的文本内容 |
语音检查-非正常挂机 |
3567 |
最后一句的话结束时间,到挂机时间的毫秒数 |
语音检查-录音时长检查 |
56088 |
录音时长的毫秒数 |
模型检查-情绪识别模型 |
辱骂 |
情绪的具体类型,例如 辱骂、高危 |
模型检查-客服违规检测模型 |
讥讽 |
客服违规的具体类型,例如 讥讽、反问、辱骂 |
示例
请求示例
http(s)://qualitycheck.cn-hangzhou.aliyuncs.com/?Action=GetResult
&JsonStr={“pageSize”:“10”}
&<公共请求参数>
正常返回示例
XML
格式
<GetResultResponse>
<code>200</code>
<pageNumber>1</pageNumber>
<data>
<score>105</score>
<agent>
<skillGroup>Default</skillGroup>
<name>张三</name>
<id>88888888</id>
</agent>
<createTime>2019-11-22T16:46Z</createTime>
<reviewResult>0</reviewResult>
<recording>
<callId>88888</callId>
<duration>14</duration>
<callee>18888888888</callee>
<name>audio.wav</name>
<id>5defd588-6162-449f-a24f-cea***</id>
<primaryId>123</primaryId>
<callTime>1574412217000</callTime>
<callType>1</callType>
<url>http://aliyun.com/audio.wav</url>
</recording>
<reviewStatus>0</reviewStatus>
<hitResult>
<name>20190417回归3</name>
<rid>1277</rid>
</hitResult>
<taskId>EB414A60-815F-441A-B0A8-BD14****</taskId>
<status>1</status>
</data>
<requestId>5AFBE205-A482-4EFE-9CE0-26A9542AE8F7</requestId>
<success>true</success>
<count>2</count>
<pageSize>10</pageSize>
<message>successful</message>
</GetResultResponse>
JSON
格式
{"RequestId":"3CEA0495-341B-4482-9AD9-8191EF4***","Message":"successful","PageSize":"10","PageNumber":"1","Data":{"ResultInfo":[{"Status":"0","Score":"100","TaskId":"A6BEC8D-9A5B-4BE5-8432-4F635E***","Resolver":"XXX","TaskName":"test","Comments":"xx","ReviewStatus":"1","CreateTime":"2019-07-24T19:31Z","ReviewResult":"0","ErrorMessage":"xxx","Reviewer":"xxx"},{"HitResult":{"HitResult":[{"Role":"客户","Words":"xx","SilenceDuration":"20","Begin":"10000","End":"0","SpeechRate":"50","EmotionValue":"1"},{"Type":"0417回归类型","ReviewResult":"0","Rid":"1276","Name":"20190417回归3"},{}]},"AsrResult":{"AsrResult":[{"Role":"客户","Words":"xx","SilenceDuration":"20","Begin":"10000","End":"0","SpeechRate":"50","EmotionValue":"1"},{"Type":"0417回归类型","ReviewResult":"0","Rid":"1276","Name":"20190417回归3"},{}]}},{"Agent":{"Callee":"18888888888","SkillGroup":"质检技能","CallId":"XXXX","CallType":"1","Duration":"60","Url":"http://aliyun.com/audio.wav","DataSetName":"XXXX","Name":"智能对话分析客服","Remark2":"XXX","Caller":"01088888888","Remark3":"XXX","Remark1":"XXX","Id":"282408763939515643","CallTime":"1563967699000","PrimaryId":"3437500","Business":"客服业务线"},"Recording":{"Callee":"18888888888","SkillGroup":"质检技能","CallId":"XXXX","CallType":"1","Duration":"60","Url":"http://aliyun.com/audio.wav","DataSetName":"XXXX","Name":"智能对话分析客服","Remark2":"XXX","Caller":"01088888888","Remark3":"XXX","Remark1":"XXX","Id":"282408763939515643","CallTime":"1563967699000","PrimaryId":"3437500","Business":"客服业务线"}}]},"Count":"1","Code":"200","Success":"true","ResultCountId":"XXX"}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交