文本实时质检。
接口说明
将特定格式的待检文本数据推送到 SCA,根据用户指定的规则对文本数据进行实时质检分析,并同步返回分析结果。相比于上传文本质检,上传文本质检通常是一个对话结束后,将完整的对话文本上传,而文本实时质检,可以在一个角色讲完一句话或多句话后,就推送到 SCA 进行分析,实时性更高。特殊说明:
- 如果推送的文本是一个角色的一句话,因为缺少对话上下文,规则中的部分算子会失效,例如上下文重复检查、抢话检查、通话静音检查等。
- 实时质检会同步返回分析结果,SCA 不会保存调用记录,所以无法通过 API 查询质检结果。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
JsonStr | string | 是 | jsonStr 是一个 JSON 字符串,里面是该接口所有的自定义参数,具体内容参见下方的jsonStr 属性说明。 | {"tickets":xxx} |
BaseMeAgentId | long | 否 | 业务空间 Id |
jsonStr 属性说明:
属性 | 值类型 | 是否必须 | 说明 |
---|---|---|---|
tickets | List | 是 | 待检文本数据信息,一次调用可以上传多段文本数据,详见下方的tickets 属性说明。 |
commonRuleIds | List | 否 | 指定规则 ID,若不指定,则使用所有规则进行分析,如果规则总数大于 100,则最多使用规则列表前 100 条规则进行分析。强烈建议您指定质检规则,否则每次都使用大量规则进行分析,会增加接口返回的延时。(只能使用离线质检规则,不可使用实时质检规则) |
tickets 属性说明:
属性 | 值类型 | 是否必须 | 说明 |
---|---|---|---|
tid | String | 是 | 本段文本的 ID,可以使用对应的电话或工单数据 ID,注意不要重复。 |
dialogue | List | 是 | 本段文本对话的详细内容,详见下方的dialogue 属性说明。 |
dialogue 属性说明:
属性 | 值类型 | 是否必须 | 说明 |
---|---|---|---|
role | String | 是 | 对话内容角色,取值:客服、客户。 |
identity | String | 否 | 对话角色的具体身份标识。 |
words | String | 是 | 这个角色说的一句话。 |
begin | Integer | 是 | 本句话的开始时间,是相对起始点的开始时间偏移,单位 ms。 |
end | Integer | 是 | 本句话的结束时间,是相对起始点的结束时间偏移,单位 ms。 |
beginTime | Date | 是 | 这句话的开始时间,示例值:2019-11-25 15:37:16。 |
返回参数
示例
正常返回示例
JSON
格式
{
"Code": "200",
"Message": "successful",
"RequestId": "4987D326-83D9-4A42-B9A5-0B27F9B***",
"Success": true,
"Data": {
"ResultInfo": [
{
"Score": 100,
"Rules": {
"RuleHitInfo": [
{
"Tid": "88888888",
"Rid": "801",
"Hit": {
"ConditionHitInfo": [
{
"HitKeyWords": {
"HitKeyWord": [
{
"To": 1,
"From": 1,
"Val": "嗯",
"Tid": "1",
"Pid": 1
}
]
},
"HitCids": {
"CidItem": [
"[\"3265\"]"
]
},
"Phrase": {
"Words": "你好",
"Identity": "1",
"Begin": 0,
"BeginTime": "1564574",
"End": 2090,
"Role": "客服"
}
}
]
},
"ConditionInfo": {
"ConditionBasicInfo": [
{
"ConditionInfoCid": "xxx"
}
]
}
}
]
},
"HandScoreIdList": {
"HandScoreIdList": [
"[]"
]
}
}
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 | ||
---|---|---|---|---|
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
| ||||
2023-08-01 | API 内部配置变更,不影响调用 | 看变更集 | ||
|