UploadDataSync_智能对话分析_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

将特定格式的待检文本数据推送到 SCA,根据用户指定的规则对文本数据进行实时质检分析,并同步返回分析结果。相比于上传文本质检,上传文本质检通常是一个对话结束后,将完整的对话文本上传,而文本实时质检,可以在一个角色讲完一句话或多句话后,就推送到 SCA 进行分析,实时性更高。特殊说明:

  • 如果推送的文本是一个角色的一句话,因为缺少对话上下文,规则中的部分算子会失效,例如上下文重复检查、抢话检查、通话静音检查等。
  • 实时质检会同步返回分析结果,SCA 不会保存调用记录,所以无法通过 API 查询质检结果。

流控信息

请求速率为6000/60(s)。更多流控信息,请前往配额中心查看

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
JsonStrstring

jsonStr 是一个 JSON 字符串,里面是该接口所有的自定义参数,具体内容参见下方的jsonStr 属性说明

示例值:{"tickets":xxx}
BaseMeAgentIdinteger<int64>

业务空间 Id

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。

请求说明

jsonStr 属性说明:

属性值类型是否必须说明
ticketsList待检文本数据信息,一次调用可以上传多段文本数据,详见下方的tickets 属性说明
commonRuleIdsList指定规则 ID,若不指定,则使用所有规则进行分析,如果规则总数大于 100,则最多使用规则列表前 100 条规则进行分析。强烈建议您指定质检规则,否则每次都使用大量规则进行分析,会增加接口返回的延时。(只能使用离线质检规则,不可使用实时质检规则)

tickets 属性说明:

属性值类型是否必须说明
tidString本段文本的 ID,可以使用对应的电话或工单数据 ID,注意不要重复。
dialogueList本段文本对话的详细内容,详见下方的dialogue 属性说明

dialogue 属性说明:

属性值类型是否必须说明
roleString对话内容角色,取值:客服、客户。
identityString对话角色的具体身份标识。
wordsString这个角色说的一句话。
beginInteger本句话的开始时间,是相对起始点的开始时间偏移,单位 ms。
endInteger本句话的结束时间,是相对起始点的结束时间偏移,单位 ms。
beginTimeDate这句话的开始时间,示例值:2019-11-25 15:37:16。

返回参数

字段名称字段详情
Codestring

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

示例值:200
Messagestring

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

示例值:successful
RequestIdstring

请求 ID。

示例值:4987D326-83D9-4A42-B9A5-0B27F9B***
Successboolean

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

示例值:true
Dataobject

返回示例

变更历史

变更时间变更内容概要操作
2023-08-01
变更请求参数BaseMeAgentId

相关示例