本文说明规则对象的结构。
推荐先在前端页面进行操作并用浏览器提供开发人员工具获取请求参数,以此为模板构建您希望的对象结构。
规则种类
规则分为两类,普通质检规则和流程质检规则,为方便说明,用规则代指普通质检规则,用流程代指流程质检规则,下面会分开介绍。
普通质检规则
普通质检规则体系分为规则、条件、算子三级,具体含义参考名词解释。
一个规则包含多个条件,一个条件对应一个算子。
RulesInfo
规则集合信息,getRuleById等接口会涉及该结构
规则
说明
data 属性说明:
属性 | 值类型 | 示例值 | 说明 |
conditions | Array | [] | 所有条件的配置信息,详见下方conditions属性说明 |
rules | Array | [] | 所有规则的配置信息,详见下方rules属性说明 |
conditions属性说明:
属性 | 值类型 | 示例值 | 说明 |
cid | String | "a" | 字母格式的条件ID,用于页面显示。 |
id | Long | 1233 | 条件id。 |
rid | String | "232" | 规则id |
check_range | Struct | 具体内容参见下方的 条件检查范围CheckRange描述 | 条件的检查范围。 |
operators | List | 具体内容参见下方的 条件所包含算子OperatorBasicInfo描述 | 条件包含的算子。 |
lambda | String | "1222" | 条件中算子的逻辑关系。 |
条件检查范围CheckRange描述:
属性 | 值类型 | 示例值 | 描述 |
role | String | 客服 | 适用角色,可能值:“客服”;“客户”;“所有 ”。 |
anchor | Anchor | 具体内容参见下方的 前置条件Anchor描述 | 前置条件详细信息。 |
range | String | {"from": 1, "to": 3} | 检测范围 |
前置条件Anchor描述:
属性 | 值类型 | 示例值 | 描述 |
cid | String | "a" | 前置条件的条件id(cid),用于确定anchor的条件。 |
location | String | AROUND | 用来指定前置条件命中时,当前条件检测前置条件命中句子的之前XX句、之后XX句、前后部分句子、当前句,可能值:BEFORE(前置条件命中句子之前)、AROUND(前置条件命中位置前后)、AFTER(前置条件命中句子之后)、CURRENT(前置条件命中的当前句)。通过该字段限定一个范围,然后配合上面的range中的from、to来指定具体的句子。 |
hit_time | Integer | 3 | 前置条件的命中次数,返回值有以下三种情况:1. 正整数1~N代表前置条件第一(N)次命中; 2. 0代表前置条件每次命中; 3. -1代表前置条件任意一次命中。 |
条件所包含算子OperatorBasicInfo描述:
属性 | 值类型 | 示例值 | 描述 |
oid | String | "1222" | 算子的ID |
name | String | 我是算子名称 | 算子名称、描述。 |
type | String | INCLUDE_KEYWORDS | 算子类型,详见新增规则。 |
param | Param | 算子表达式具体内容,详见新增规则。 |
rules属性说明:
属性 | 值类型 | 示例值 | 描述 |
rid | String | 1 | 规则的ID |
lambda | String | a&&b&&c | 规则中条件的逻辑关系 |
business | List | 具体内容参见下方的 规则所属业务字段BusinessCategoryBasicInfo描述 | 规则的适用业务。 |
type | Integer | 1 | 规则的类型 |
triggers | List | ["a","b","c"] | 规则中需要返回内容的条件ID(cid)。 |
name | String | "用户可能要投诉" | 规则名称。 |
scoreSubId | Integer | 3678 | 规则绑定的评分项子项的id |
ruleScoreType | Integer | 3 | 该规则所绑定的评分项是否进行计分(1:不计分 3:计分)。 |
level | Integer | 2 | 重要程度: 0(重度违规);1(中度违规);2(轻度违规) |
fullCycle | Integer | 1 | 设置规则的生效时间的类型: 0(特定周期生效,特定的时间范围内生效);1(全周期生效,始终生效) |
effectiveStartTime | Date | 1640620800000 | 规则生效时间为特定周期生效时的生效开始时间。 |
effectiveEndTime | Date | 1640620800000 | 规则生效时间为特定周期生效时的生效结束时间。 |
autoReview | Integer | 1 | 是否自动审核,可能值:1(否);3(是) |
comments | String | 检测是否出现了禁用语 | 规则的备注信息。 |
qualityCheckType | Integer | 0 | 是否为实时质检规则,可能值:0(否);1(是) |
businessCategoryBasicInfoList属性说明:
属性 | 值类型 | 示例值 | 说明 |
bid | Long | 574599480 | 适用业务id |
name | String | 售前业务 | 使用业务名称 |
例子-规则
{
"data": {
"conditions": [
{
"check_range": {},
"cid": "a",
"id": 92495,
"lambda": "93289",
"operators": [
{
"id": 93289,
"oid": "93289",
"param": {
"contextChatMatch": false,
"in_sentence": false,
"keywordMatchSize": 1,
"keywords": [
"你好"
],
"near_dialogue": false,
"useEasAlgorithm": false
},
"type": "HIT_ANY_KEYWORDS"
}
],
"rid": "30526"
},
{
"check_range": {},
"cid": "b",
"id": 92496,
"lambda": "93290",
"operators": [
{
"id": 93290,
"oid": "93290",
"param": {
"average": false,
"minWordSize": 4,
"near_dialogue": false,
"useEasAlgorithm": false,
"velocity": 0.005,
"velocityInMint": 300
},
"type": "SPEECH_SPEED_CHECK"
}
],
"rid": "30526"
}
],
"count": 1,
"rules": [
{
"autoReview": 1,
"comments": "这是一个规则Demo!",
"configType": 1,
"createEmpid": "374915893923532146",
"createTime": 1663654165000,
"expectedScore": 0.7,
"fullCycle": 1,
"isDelete": 0,
"isOnline": 0,
"lambda": "a&&b",
"lastUpdateEmpid": "374915893923532146",
"lastUpdateTime": 1663654165000,
"level": 2,
"meet": 1,
"name": "规则Demo",
"qualityCheckType": 0,
"rid": "30526",
"ridLong": 30526,
"ruleCategoryName": "服务规范",
"ruleScoreType": 3,
"ruleType": 1,
"scoreNum": 10,
"scoreNumType": 0,
"scoreRuleHitType": 0,
"scoreType": 3,
"status": 0,
"targetType": 10,
"taskFlowId": -1,
"triggers": [
"a",
"b"
],
"type": 1
}
]
}
}