调用GetResult查询质检结果。

可以查询通过 UploadAudioDataUploadData 上传的数据,也可以查询数据集质检任务SubmitQualityCheckTask的数据。可以根据任务ID(taskId)查询,也可以根据时间范围查询。

此接⼝返回结果中默认只返回部分参数,可通过请求参数中的 requiredFields 来⾃定义设置返回参数中需要返回哪些字段。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
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 来指定区间的开始值。

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

关键字。

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

Remark2 String XXX

自定义数据2

Remark3 String XXX

自定义数据3

Remark4 String XXX

自定义数据4

Remark5 Long 1232

自定义数据5

Remark6 String XXX

自定义数据6

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表示失败。

示例

请求示例

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"}

错误码

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