GetResultToReview - 获取质检结果详情用于复核
获取指定文件的质检结果详情数据,用于文件复核。详情数据包括:转写文本、录音地址、命中检测项信息,有了这些信息,就可以听录音、查看转写文本、查看检测项的命中位置,进行文件复核了。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| JsonStr |
string |
是 |
完整 JSON 字符串信息,具体内容参见以下详细信息。 |
{"taskId":"任务ID",“ fileId”:"文件ID"} |
| BaseMeAgentId |
integer |
否 |
业务空间 Id |
12345 |
入参 GetResultToReviewRequest 说明
| 属性 | 值类型 | 是否必须 | 说明 |
| taskId | String | 是 | 任务 ID,上传待检数据后返回的任务 ID |
| fileId | String | 是 | 文件 ID,通过获取质检结果(GetResult)可以获取到,即返回结果中的 recording.id。 |
请求入参示例
{
"taskId": "20250108-038D8892-C18A-1E29-8809-402D286DD899",
"fileId": "97ae1805ed2c4c438f480bb9def541ab"
}
请求代码示例
import com.alibaba.fastjson.JSONObject;
import com.aliyun.qualitycheck20190115.Client;
import com.aliyun.qualitycheck20190115.models.*;
import com.aliyun.teaopenapi.models.Config;
public class sca {
private static String ak = "YOUR_ACCESS_KEY_ID";
private static String sk = "YOUR_ACCESS_KEY_SECRET";
private static void getResultToReview() throws Exception {
Config config = new Config();
config.setAccessKeyId(ak).setAccessKeySecret(sk)
.setEndpoint("qualitycheck.cn-hangzhou.aliyuncs.com")
.setRegionId("cn-hangzhou").setProtocol("HTTPS");
Client client = new Client(config);
GetResultToReviewRequest result = new GetResultToReviewRequest();
String rr = "{\"taskId\":\"20250108-038D8892-C18A-1E29-8809-402D286DD899\",\"fileId\":\"97ae1805ed2c4c438f480bb9def541ab\"}";
result.setJsonStr(rr);
GetResultToReviewResponse response = client.getResultToReview(result);
System.out.println(JSONObject.toJSONString(response));
}
public static void main(String[] args) throws Exception {
getResultToReview();
}
}
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Code |
string |
结果代码,200 表示成功,若为别的值则表示失败,调用方可根据此字段判断失败原因。 |
200 |
| Message |
string |
出错时表示出错详情,成功时为 successful。 |
successful |
| RequestId |
string |
请求 ID。 |
82C91484-B2D5-4D2A-A21F-A6D73F4*** |
| Success |
boolean |
请求是否成功,调用方可根据此字段来判断请求是否成功:true 表示成功;false/null表示失败。 |
true |
| Data |
object |
详细返回数据。 |
|
| Status |
integer |
任务当前状态;0:未完成;1:已完成;调用方可根据此字段判断任务是否完成;非 0、1 表示出错。 |
1 |
| AudioScheme |
string |
音频 URL 的协议,可能值:http、https。 |
https |
| AudioURL |
string |
音频 URL,不含 http://、https://,与 AudioSchedme 组成完整的 URL。 |
sca-ccc-test.oss-cn-beijing.aliyuncs.com/xxxxx |
| TotalScore |
integer |
质检得分。 |
99 |
| FileId |
string |
文件 ID。 |
e790e6c919d84b82b64ee***** |
| FileMergeName |
string |
文件名称。 |
xxx.wav |
| Comments |
string |
复核意见。 |
xxx |
| Vid |
string |
文件 ID。 |
6fa76916-3ce6-45d8-ac64-01b7f31*** |
| Dialogues |
object |
||
| Dialogue |
array<object> |
对话数据。 |
|
|
object |
对话数据。 |
||
| Words |
string |
对话内容 |
你好有什么可以帮您 |
| Identity |
string |
角色标识,离线语音场景下角色只有客服/客户,离线文本质检场景下,显示的是上传数据时传入的 identity。 |
客服 |
| Begin |
integer |
这句话的开始时间相对对话整体开始时间的偏移量,毫秒级,例如录音总时长为 2 分 10 秒,客户的谋一句话是在 1 分 12 秒时开始讲的,1 分 20 秒时讲完,则 begin 的值为 72000,end 的值为 80000。 |
72000 |
| BeginTime |
string |
这句话开始讲话时的绝对时间。 重要 格式为 TZ,推荐使用 BeginTimeMs |
2019-10-01T11:12Z |
| EmotionValue |
integer |
情绪能量值,取值为音量分贝值/10。取值范围:[1,10]。值越高情绪越强烈。 |
7 |
| End |
integer |
这句话的开始时间相对对话整体开始时间的偏移量,毫秒级,例如录音总时长为 2 分 10 秒,客户的谋一句话是在 1 分 12 秒时开始讲的,1 分 20 秒时讲完,则 begin 的值为 72000,end 的值为 80000。 |
80000 |
| SpeechRate |
integer |
本句的平均语速,单位:字数/分钟。 |
200 |
| Role |
string |
该句话的角色,可能值:客服;客户。 |
客服 |
| SilenceDuration |
integer |
相同角色的两个相邻句子之间的静音时长,单位为秒。 |
1 |
| HourMinSec |
string |
这句话的时分秒格式的开始时间,格式:hh:mm:ss |
00:08 |
| BeginTimeMs |
integer |
这句话开始讲话时的绝对时间。格式为毫秒时间戳。 |
1569899521000 |
| HitRuleReviewInfoList |
object |
||
| HitRuleReviewInfo |
array<object> |
命中检测项信息。 |
|
|
array<object> |
命中规则信息。 |
||
| ScoreSubName |
string |
历史遗留字段,请忽略。 |
xxx |
| ScoreNum |
integer |
评分的分值。 |
-10 |
| AutoReview |
integer |
是否自动审核,可能值:1:不自动审核,3:自动审核。 |
1 |
| ScoreSubId |
integer |
历史遗留字段,请忽略。 |
xxx |
| Complainable |
boolean |
当前评分项坐席是否可以提交申诉(终审后不可再次申诉)。 |
true |
| ScoreId |
integer |
历史遗留字段,请忽略。 |
xxx |
| RuleName |
string |
检测项名称。 |
你好 |
| Rid |
integer |
检测项 ID |
451 |
| ConditionHitInfoList |
object |
||
| ConditionHitInfo |
array<object> |
命中的条件信息。 |
|
|
array<object> |
|||
| KeyWords |
object |
||
| KeyWord |
array<object> |
命中的关键信息,在复核页面上高亮展示的信息,例如关键词检查算子命中的关键词、客服模型检查算子命中的具体类别信息等。 |
|
|
object |
|||
| From |
integer |
需要高亮展示的关键字从第几个字符开始,取值范围从 0 开始,最大值为当句话字符总数减 1。高亮的字包含 from。 |
1 |
| Val |
string |
算子命中的关键信息,详见下方返回参数说明中的关键信息 Val 详解。 |
你好 |
| Pid |
integer |
当前句子在所有句子中的下标值,即当前句子是请求参数中 dialogue 数组中的第几个,从 0 开始。 |
2 |
| Tid |
string |
语音 ID。 |
6fa76916-3ce6-45d8-ac64-01b7f31c7295 |
| Cid |
string |
条件 ID。 |
2000 |
| To |
integer |
需要高亮展示的关键字到第几个字符结束,最大值为当句话字符总数减 1。高亮的字不包含 to,例如一句话为“不可能给你退货的”,from=0,to=3,那么需要高亮的关键字就是“不可能”三个字。 |
3 |
| CustomizeCode |
string |
内部字段,请忽略。 |
xxx |
| IsMatch |
boolean |
||
| Cid |
object |
||
| Cid |
array |
命中的条件 ID 列表。 |
|
|
string |
条件 ID。 |
2000 |
|
| Phrase |
object |
当前命中检测项的句子详情 |
|
| Words |
string |
对话内容。 |
你好,请问有什么可以帮您 |
| Begin |
integer |
这句话的开始时间相对对话整体开始时间的偏移量,毫秒级,例如录音总时长为 2 分 10 秒,客户的谋一句话是在 1 分 12 秒时开始讲的,1 分 20 秒时讲完,则 begin 的值为 72000,end 的值为 80000。 |
72000 |
| Identity |
string |
角色标识,离线语音场景下角色只有客服/客户,离线文本质检场景下,显示的是上传数据时传入的 identity。 |
客服 |
| Pid |
integer |
当前句子在所有句子中的下标值,即当前句子是请求参数中 dialogue 数组中的第几个,从 0 开始。 |
3 |
| EmotionValue |
integer |
情绪能量值,取值为音量分贝值/10。取值范围:[1,10]。值越高情绪越强烈。 |
7 |
| End |
integer |
这句话的开始时间相对对话整体开始时间的偏移量,毫秒级,例如录音总时长为 2 分 10 秒,客户的谋一句话是在 1 分 12 秒时开始讲的,1 分 20 秒时讲完,则 begin 的值为 72000,end 的值为 80000。 |
80000 |
| Role |
string |
本句的角色,取值:客服、客户。 |
客服 |
| ComplainHistories |
object |
||
| ComplainHistories |
array<object> |
申诉历史信息。 |
|
|
object |
|||
| Comments |
string |
申诉理由/申诉处理理由。 |
请听一下录音,重新判定。 |
| Operator |
integer |
申诉发起人/处理人的账号 ID。 |
123456 |
| OperationTime |
string |
处理时间。 |
2020-10-16T11:13Z |
| OperationType |
integer |
状态:3(申诉中);4(申诉驳回);5(申诉通过)。 |
5 |
| OperatorName |
string |
申诉发起人/处理人的用户名。 |
张三 |
| ReviewInfo |
object |
复核信息。 |
|
| ReviewResult |
integer |
复核结果,0:错误;1:正确。 |
1 |
| ReviewTime |
string |
复核时间,yyyy-mm-ddhh:mm:ss。 |
2019-10-12 17:06:00 |
| HitId |
string |
命中 ID。 |
013c68142fec4f0899fa6ee0exxx |
| Reviewer |
string |
复核员 ID。 |
123 |
| Rid |
integer |
检测项 ID。 |
451 |
| Comment |
string |
||
| SentenceReviewResults |
object |
||
| SentenceReviewResults |
array<object> |
||
|
object |
|||
| Sid |
integer |
1 |
|
| Rid |
integer |
1 |
|
| Cid |
integer |
1 |
|
| Pid |
string |
1 |
|
| HitStatus |
integer |
1 |
|
| ReviewDimensionType |
string |
2 |
|
| OriginTaskId |
string |
122-122-22-333 |
|
| OriginVid |
string |
1001 |
|
| Comment |
string |
无意见 |
|
| Changed |
boolean |
||
| MachineHitResult |
integer |
||
| ReviewHitResult |
integer |
||
| ManualScoreInfoList |
object |
||
| ManualScoreInfo |
array<object> |
人工添加的检测项。 |
|
|
array<object> |
|||
| ScoreSubName |
string |
历史遗留字段,请忽略。 |
投诉 |
| Complainable |
boolean |
当前评分项坐席是否可以提交申诉(终审后不可再次申诉)。 |
true |
| ScoreNum |
integer |
分数 |
-10 |
| ScoreSubId |
integer |
历史遗留字段,请忽略。 |
xxx |
| ScoreId |
integer |
历史遗留字段,请忽略。 |
xxx |
| ComplainHistories |
object |
||
| ComplainHistories |
array<object> |
申诉历史信息。 |
|
|
object |
|||
| Comments |
string |
申诉理由/申诉处理理由。 |
请听一下录音,重新判定。 |
| Operator |
integer |
申诉发起人/处理人的账号 ID。 |
123456 |
| OperationTime |
string |
处理时间。 |
2020-10-16T11:13Z |
| OperationType |
integer |
状态:3(申诉中);4(申诉驳回);5(申诉通过)。 |
5 |
| OperatorName |
string |
申诉发起人/处理人的用户名。 |
张三 |
| ReviewHistoryList |
object |
||
| ReviewHistory |
array<object> |
复核历史。 |
|
|
array<object> |
|||
| Type |
integer |
复核类型,0:自动复核;1:手工复核。 |
1 |
| OperatorName |
string |
复核员用户名。 |
张三 |
| TimeStr |
string |
复核时间,yyyy-mm-ddhh:mm:ss。 |
2019-10-28 15:21:00 |
| Score |
integer |
复核后的得分。 |
95 |
| ReviewResult |
integer |
复核结果,1:全部检测项都正确;0:有至少一个检测项错误。 |
1 |
| ComplainResult |
integer |
申诉处理结果,1:全部申诉都通过;0:至少有一个不通过。 |
1 |
| OldScore |
integer |
复核前的得分。 |
90 |
| ReviewManagerType |
string |
复核类型详情 |
[一个类别][二类别:第一类目,第一类目->下一集] |
| Time |
integer |
用于显示时间戳。 |
1722396376000 |
| Comments |
string |
评论 |
请写明学校名称,谢谢 |
| ReviewRightRule |
object |
||
| ReviewRightRule |
array<object> |
复核后正确命中规则 |
|
|
object |
复核后正确命中规则 |
||
| ruleName |
string |
规则名字。 |
问候语规则 |
| rid |
integer |
规则 id |
12恶 |
| Operator |
integer |
操作人 id |
78404 |
| ReviewTypeIdList |
object |
||
| ReviewTypeIdList |
array<object> |
复核类型 id 列表 |
|
|
array<object> |
复核类型 id 列表 |
||
| ReviewKeyIdList |
object |
||
| ReviewKeyIdList |
array |
复核标签 id 列表 |
|
|
integer |
复核标签 id 列表 |
[4, 5] |
|
| ReviewTypeId |
integer |
复核大类 id |
1 |
关键信息 Val 详解
| 算子名称 | val 值示例 | 说明 |
| 文字检查-关键字检查 | 你好 | 当前句子中命中该算子的文本,即为复核页面查看命中位置时,句子中红色高亮的文本内容 |
| 文字检查-文本相似度检查 | 82 | 相似度值 |
| 文字检查-正则表达式检查 | 你好 | 当前句子中命中该算子的文本,即为复核页面查看命中位置时,句子中红色高亮的文本内容 |
| 文字检查-上下文重复检查 | 你好 | 当前句子中命中该算子的文本,即为复核页面查看命中位置时,句子中红色高亮的文本内容 |
| 语音检查-通话静音检查 | 3200 | 静音时长(毫秒) |
| 语音检查-语速检查 | 365 | 当前句子的语速值 |
| 语音检查-抢话检查 | 2:8 | 类型为"m:n",m 为抢话时长(秒),即客服与客户说话交叉时间;n 为当前句子的字数 |
| 语音检查-角色判断 | 你好 | 当前句子中命中该算子的文本,即为复核页面查看命中位置时,句子中红色高亮的文本内容 |
| 语音检查-非正常挂机 | 3567 | 最后一句的话结束时间,到挂机时间的毫秒数 |
| 语音检查-录音时长检查 | 56088 | 录音时长的毫秒数 |
| 模型检查-情绪识别模型 | 辱骂 | 情绪的具体类型,例如辱骂、高危 |
| 模型检查-客服违规检测模型 | 讥讽 | 客服违规的具体类型,例如讥讽、反问、辱骂 |
示例
正常返回示例
JSON格式
{
"Code": "200",
"Message": "successful",
"RequestId": "82C91484-B2D5-4D2A-A21F-A6D73F4***",
"Success": true,
"Data": {
"Status": 1,
"AudioScheme": "https",
"AudioURL": "sca-ccc-test.oss-cn-beijing.aliyuncs.com/xxxxx",
"TotalScore": 99,
"FileId": "e790e6c919d84b82b64ee*****",
"FileMergeName": "xxx.wav",
"Comments": "xxx",
"Vid": "6fa76916-3ce6-45d8-ac64-01b7f31***",
"Dialogues": {
"Dialogue": [
{
"Words": "你好有什么可以帮您",
"Identity": "客服",
"Begin": 72000,
"BeginTime": "2019-10-01T11:12Z",
"EmotionValue": 7,
"End": 80000,
"SpeechRate": 200,
"Role": "客服",
"SilenceDuration": 1,
"HourMinSec": "00:08",
"BeginTimeMs": 1569899521000
}
]
},
"HitRuleReviewInfoList": {
"HitRuleReviewInfo": [
{
"ScoreSubName": "xxx",
"ScoreNum": -10,
"AutoReview": 1,
"ScoreSubId": 0,
"Complainable": true,
"ScoreId": 0,
"RuleName": "你好",
"Rid": 451,
"ConditionHitInfoList": {
"ConditionHitInfo": [
{
"KeyWords": {
"KeyWord": [
{
"From": 1,
"Val": "你好",
"Pid": 2,
"Tid": "6fa76916-3ce6-45d8-ac64-01b7f31c7295",
"Cid": "2000",
"To": 3,
"CustomizeCode": "xxx",
"IsMatch": true
}
]
},
"Cid": {
"Cid": [
"2000"
]
},
"Phrase": {
"Words": "你好,请问有什么可以帮您",
"Begin": 72000,
"Identity": "客服",
"Pid": 3,
"EmotionValue": 7,
"End": 80000,
"Role": "客服"
}
}
]
},
"ComplainHistories": {
"ComplainHistories": [
{
"Comments": "请听一下录音,重新判定。",
"Operator": 123456,
"OperationTime": "2020-10-16T11:13Z",
"OperationType": 5,
"OperatorName": "张三"
}
]
},
"ReviewInfo": {
"ReviewResult": 1,
"ReviewTime": "2019-10-12 17:06:00",
"HitId": "013c68142fec4f0899fa6ee0exxx",
"Reviewer": "123",
"Rid": 451,
"Comment": "",
"SentenceReviewResults": {
"SentenceReviewResults": [
{
"Sid": 1,
"Rid": 1,
"Cid": 1,
"Pid": "1",
"HitStatus": 1,
"ReviewDimensionType": "2",
"OriginTaskId": "122-122-22-333",
"OriginVid": "1001",
"Comment": "无意见",
"Changed": true
}
]
}
},
"MachineHitResult": 0,
"ReviewHitResult": 0
}
]
},
"ManualScoreInfoList": {
"ManualScoreInfo": [
{
"ScoreSubName": "投诉",
"Complainable": true,
"ScoreNum": -10,
"ScoreSubId": 0,
"ScoreId": 0,
"ComplainHistories": {
"ComplainHistories": [
{
"Comments": "请听一下录音,重新判定。",
"Operator": 123456,
"OperationTime": "2020-10-16T11:13Z",
"OperationType": 5,
"OperatorName": "张三"
}
]
}
}
]
},
"ReviewHistoryList": {
"ReviewHistory": [
{
"Type": 1,
"OperatorName": "张三",
"TimeStr": "2019-10-28 15:21:00",
"Score": 95,
"ReviewResult": 1,
"ComplainResult": 1,
"OldScore": 90,
"ReviewManagerType": "[一个类别][二类别:第一类目,第一类目->下一集]",
"Time": 1722396376000,
"Comments": "请写明学校名称,谢谢",
"ReviewRightRule": {
"ReviewRightRule": [
{
"ruleName": "问候语规则",
"rid": 0
}
]
},
"Operator": 78404
}
]
},
"ReviewTypeIdList": {
"ReviewTypeIdList": [
{
"ReviewKeyIdList": {
"ReviewKeyIdList": [
0
]
},
"ReviewTypeId": 1
}
]
}
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。