获取质检结果 - 智能对话分析

调用GetResult查询质检结果。服务地址(Region)请选择为杭州(cn-hangzhou)。

可以查询通过 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。当查询超过10000条之后的数据时，不支持跳页查询，仅支持向下连续翻页，并且需要传入lastDataId参数。(例如：当前返回每页显示100条，当前为101页，那么后续查询只能查询102页，不可直接查询103页)
lastDataId	String	否	上次查询到的数据中最后一条数据的lastDataId的值，当通过GetResult查询超过10000条以上的数据时，每次请求入参中需要携带上一次查询结果中最后一条数据的lastDataId的值。
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，只返回该客服的结果。
ruleIds	List	否	命中的质检规则ID集合，返回命中了这些规则中任意一个或多个的结果。
resolver	String	否	复核员的账号id，只返回该复核员复核的结果。
reviewer	String	否	分配的质检员的账号id，只返回分配该质检员的结果。
assignmentTimeDisplay	Boolean	否	是否返回分配时间。
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一起根据质检得分筛选，分值。
duration	Integer	否	通话时长，单位：秒。需配合durationType、endDuration 一起使用。
durationType	Integer	否	通话时长查询的范围类型，可选值：1(等于)、3(大于)、5(小于)、7(区间)。
endDuration	Integer	否	通话时长按区间范围查询时的结束值，此时使用 duration 来指定区间的开始值。
dialogueSize	Integer	否	对话轮数。需配合dialogueSizeType、endDialogueSize 一起使用。
dialogueSizeType	Integer	否	对话轮数查询的范围类型，可选值：1(等于)、3(大于)、5(小于)、7(区间)。
endDialogueSize	Integer	否	对话轮数按区间范围查询时的结束值，此时使用 dialogueSize 来指定区间的开始值。
remark5	Long	否	自定义数据5，调用UploadAudioData接口上传质检数据时所提供。该字段支持精准查询，也支持按范围查询，需配合 remark5Type 、endRemark5 一起使用。
remark5Type	Integer	否	自定义数据5按范围查询时的范围类型：3(大于)、5(小于)、7(区间)，默认为等于(精确查询)。
endRemark5	Long	否	自定义数据5按区间查询时的结束值，此时使用 remark5 来指定区间的开始值。
fileName	String	否	文件完整名称，不支持模糊搜索。
remark1	String	否	自定义数据1，调用UploadAudioData接口上传质检数据时所提供。
remark2	String	否	自定义数据2，调用UploadAudioData接口上传质检数据时所提供。
remark3	String	否	自定义数据3，调用UploadAudioData接口上传质检数据时所提供。
remark4	String	否	自定义数据4，调用UploadAudioData接口上传质检数据时所提供。
remark5	Long	否	自定义数据5，调用UploadAudioData接口上传质检数据时所提供。该字段支持精准查询，也支持按范围查询，需配合 remark5Type 和 endRemark5 一起使用。)
remark5Type	Integer	否	自定义数据5按范围查询时的范围类型：3(大于)、5(小于)、7(区间)，默认为等于(精确查询)。
endRemark5	Long	否	自定义数据5按区间查询时的结束值，此时使用 remark5 来指定区间的开始值。
remark7	String	否	自定义数据7，调用UploadAudioData接口上传质检数据时所提供。
sortField	String	否	按指定参数进行排序，目前仅质检得分以及自定义数据1/2/3/4/5 支持排序，所以可输入的值为：score/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	对话内容。
AssignmentTime	String	2021-03-02T14:37Z	分配时间（分配质检员的分配时间）。
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	评分项的分数，正数表示加分，负分表示减分。
LastDataId	String	4498420@a_z@93EAADF1-01D3-44BD-8AC9-F57F447EFCE8_1614*****	本条数据标志信息，当通过GetResult查询超过10000条以上的数据时，每次请请求入参中需要携带上一次查询结果最后一条数据的lastDataId的值。
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	文件所属数据集，当文件是数据集上传时有值。
DialogueSize	Integer	32	对话轮数。
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	最后一次复核提交的时间(时间戳格式)。
ReviewType	Integer	1	复核状态，可能值：1（自动复核）；2（人工复核）。
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"}

错误码

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