GetResultToReview - 获取质检结果详情用于复核

获取指定文件的质检结果详情数据,用于文件复核。详情数据包括:转写文本、录音地址、命中检测项信息,有了这些信息,就可以听录音、查看转写文本、查看检测项的命中位置,进行文件复核了。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
sca:GetResultToReviewget
*全部资源
*

请求参数

名称类型必填描述示例值
JsonStrstring

完整 JSON 字符串信息,具体内容参见以下详细信息。

{"taskId":"任务ID",“ fileId”:"文件ID"}
BaseMeAgentIdlong

业务空间 Id

入参 GetResultToReviewRequest 说明

属性值类型是否必须说明
taskIdString任务 ID,上传待检数据后返回的任务 ID
fileIdString文件 ID,通过获取质检结果(GetResult)可以获取到,即返回结果中的 recording.id。

返回参数

名称类型描述示例值
object
Codestring

结果代码,200 表示成功,若为别的值则表示失败,调用方可根据此字段判断失败原因。

200
Messagestring

出错时表示出错详情,成功时为 successful

successful
RequestIdstring

请求 ID。

82C91484-B2D5-4D2A-A21F-A6D73F4***
Successboolean

请求是否成功,调用方可根据此字段来判断请求是否成功:true 表示成功;false/null表示失败。

true
Dataobject

详细返回数据。

Statusinteger

任务当前状态;0:未完成;1:已完成;调用方可根据此字段判断任务是否完成;非 0、1 表示出错。

1
AudioSchemestring

音频 URL 的协议,可能值:http、https。

https
AudioURLstring

音频 URL,不含 http://、https://,与 AudioSchedme 组成完整的 URL。

sca-ccc-test.oss-cn-beijing.aliyuncs.com/xxxxx
TotalScoreinteger

质检得分。

99
FileIdstring

文件 ID。

e790e6c919d84b82b64ee*****
FileMergeNamestring

文件名称。

xxx.wav
Commentsstring

复核意见。

xxx
Vidstring

文件 ID。

6fa76916-3ce6-45d8-ac64-01b7f31***
Dialoguesarray<object>

对话数据。

Dialogueobject

对话数据。

Wordsstring

对话内容

你好有什么可以帮您
Identitystring

角色标识,离线语音场景下角色只有客服/客户,离线文本质检场景下,显示的是上传数据时传入的 identity。

客服
Beginlong

这句话的开始时间相对对话整体开始时间的偏移量,毫秒级,例如录音总时长为 2 分 10 秒,客户的谋一句话是在 1 分 12 秒时开始讲的,1 分 20 秒时讲完,则 begin 的值为 72000,end 的值为 80000。

72000
BeginTimestring

这句话开始讲话时的绝对时间。

2019-10-01 11:12:01
EmotionValueinteger

情绪能量值,取值为音量分贝值/10。取值范围:[1,10]。值越高情绪越强烈。

7
Endlong

这句话的开始时间相对对话整体开始时间的偏移量,毫秒级,例如录音总时长为 2 分 10 秒,客户的谋一句话是在 1 分 12 秒时开始讲的,1 分 20 秒时讲完,则 begin 的值为 72000,end 的值为 80000。

80000
SpeechRateinteger

本句的平均语速,单位:字数/分钟。

200
Rolestring

该句话的角色,可能值:客服;客户。

客服
SilenceDurationinteger

相同角色的两个相邻句子之间的静音时长,单位为秒。

1
HourMinSecstring

这句话的时分秒格式的开始时间,格式:hh:mm:ss

00:08
HitRuleReviewInfoListarray<object>

命中检测项信息。

HitRuleReviewInfoobject

命中规则信息。

ScoreSubNamestring

历史遗留字段,请忽略。

xxx
ScoreNuminteger

评分的分值。

-10
AutoReviewinteger

是否自动审核,可能值:1:不自动审核,3:自动审核。

1
ScoreSubIdlong

历史遗留字段,请忽略。

xxx
Complainableboolean

当前评分项坐席是否可以提交申诉(终审后不可再次申诉)。

true
ScoreIdlong

历史遗留字段,请忽略。

xxx
RuleNamestring

检测项名称。

你好
Ridlong

检测项 ID

451
ConditionHitInfoListarray<object>

命中的条件信息。

ConditionHitInfoobject
KeyWordsarray<object>

命中的关键信息,在复核页面上高亮展示的信息,例如关键词检查算子命中的关键词、客服模型检查算子命中的具体类别信息等。

KeyWordobject
Frominteger

需要高亮展示的关键字从第几个字符开始,取值范围从 0 开始,最大值为当句话字符总数减 1。高亮的字包含 from。

1
Valstring

算子命中的关键信息,详见下方返回参数说明中的关键信息 Val 详解

你好
Pidinteger

当前句子在所有句子中的下标值,即当前句子是请求参数中 dialogue 数组中的第几个,从 0 开始。

2
Tidstring

语音 ID。

6fa76916-3ce6-45d8-ac64-01b7f31c7295
Cidstring

条件 ID。

2000
Tointeger

需要高亮展示的关键字到第几个字符结束,最大值为当句话字符总数减 1。高亮的字不包含 to,例如一句话为“不可能给你退货的”,from=0,to=3,那么需要高亮的关键字就是“不可能”三个字。

3
CustomizeCodestring

内部字段,请忽略。

xxx
Cidarray

命中的条件 ID 列表。

Cidstring

条件 ID。

2000
Phraseobject

当前命中检测项的句子详情

Wordsstring

对话内容。

你好,请问有什么可以帮您
Beginlong

这句话的开始时间相对对话整体开始时间的偏移量,毫秒级,例如录音总时长为 2 分 10 秒,客户的谋一句话是在 1 分 12 秒时开始讲的,1 分 20 秒时讲完,则 begin 的值为 72000,end 的值为 80000。

72000
Identitystring

角色标识,离线语音场景下角色只有客服/客户,离线文本质检场景下,显示的是上传数据时传入的 identity。

客服
Pidinteger

当前句子在所有句子中的下标值,即当前句子是请求参数中 dialogue 数组中的第几个,从 0 开始。

3
EmotionValueinteger

情绪能量值,取值为音量分贝值/10。取值范围:[1,10]。值越高情绪越强烈。

7
Endlong

这句话的开始时间相对对话整体开始时间的偏移量,毫秒级,例如录音总时长为 2 分 10 秒,客户的谋一句话是在 1 分 12 秒时开始讲的,1 分 20 秒时讲完,则 begin 的值为 72000,end 的值为 80000。

80000
Rolestring

本句的角色,取值:客服、客户。

客服
ComplainHistoriesarray<object>

申诉历史信息。

ComplainHistoriesobject
Commentsstring

申诉理由/申诉处理理由。

请听一下录音,重新判定。
Operatorlong

申诉发起人/处理人的账号 ID。

123456
OperationTimestring

处理时间。

2020-10-16T11:13Z
OperationTypeinteger

状态:3(申诉中);4(申诉驳回);5(申诉通过)。

5
OperatorNamestring

申诉发起人/处理人的用户名。

张三
ReviewInfoobject

复核信息。

ReviewResultinteger

复核结果,0:错误;1:正确。

1
ReviewTimestring

复核时间,yyyy-mm-ddhh:mm:ss。

2019-10-12 17:06:00
HitIdstring

命中 ID。

013c68142fec4f0899fa6ee0exxx
Reviewerstring

复核员 ID。

123
Ridlong

检测项 ID。

451
ManualScoreInfoListarray<object>

人工添加的检测项。

ManualScoreInfoobject
ScoreSubNamestring

历史遗留字段,请忽略。

投诉
Complainableboolean

当前评分项坐席是否可以提交申诉(终审后不可再次申诉)。

true
ScoreNuminteger

分数

-10
ScoreSubIdlong

历史遗留字段,请忽略。

xxx
ScoreIdlong

历史遗留字段,请忽略。

xxx
ComplainHistoriesarray<object>

申诉历史信息。

ComplainHistoriesobject
Commentsstring

申诉理由/申诉处理理由。

请听一下录音,重新判定。
Operatorlong

申诉发起人/处理人的账号 ID。

123456
OperationTimestring

处理时间。

2020-10-16T11:13Z
OperationTypeinteger

状态:3(申诉中);4(申诉驳回);5(申诉通过)。

5
OperatorNamestring

申诉发起人/处理人的用户名。

张三
ReviewHistoryListarray<object>

复核历史。

ReviewHistoryobject
Typeinteger

复核类型,0:自动复核;1:手工复核。

1
OperatorNamestring

复核员用户名。

张三
TimeStrstring

复核时间,yyyy-mm-ddhh:mm:ss。

2019-10-28 15:21:00
Scoreinteger

复核后的得分。

95
ReviewResultinteger

复核结果,1:全部检测项都正确;0:有至少一个检测项错误。

1
ComplainResultinteger

申诉处理结果,1:全部申诉都通过;0:至少有一个不通过。

1
OldScoreinteger

复核前的得分。

90

关键信息 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-01 11:12:01",
          "EmotionValue": 7,
          "End": 80000,
          "SpeechRate": 200,
          "Role": "客服",
          "SilenceDuration": 1,
          "HourMinSec": "00:08"
        }
      ]
    },
    "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"
                    }
                  ]
                },
                "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
          }
        }
      ]
    },
    "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": 0,
          "Comments": "",
          "ReviewRightRule": {
            "ReviewRightRule": [
              {
                "ruleName": "",
                "rid": 0
              }
            ]
          },
          "Operator": 0
        }
      ]
    },
    "ReviewTypeIdList": {
      "ReviewTypeIdList": [
        {
          "ReviewKeyIdList": {
            "ReviewKeyIdList": [
              0
            ]
          },
          "ReviewTypeId": 0
        }
      ]
    }
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-07-22OpenAPI 返回结构发生变更查看变更详情
2024-07-15OpenAPI 返回结构发生变更查看变更详情
2024-07-15OpenAPI 返回结构发生变更查看变更详情
2024-07-15OpenAPI 返回结构发生变更查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情
2023-08-01API 内部配置变更,不影响调用查看变更详情