智能对话分析 创建规则

请求参数

请求参数Json字符串信息

一、条件的详细配置信息字段ConditionBasicInfo说明

条件检查范围CheckRange描述:

前置条件Anchor描述:

条件所包含算子OperatorBasicInfo描述:

算子类型以及以及算子具体内容Param描述：

param中的属性较多，有一些是公用属性，有一些是特定算子类型专用的，所以我们按照算子类型维度，来逐一说明每个算子类型都可以使用哪些属性，并且提供配置示例供您参考，以下标题为 算子名称(name)、算子类型(type)，内容为该算子可用参数列表，以及使用示例：

1.关键词检查：包含任意一个关键字(HIT_ANY_KEYWORDS) 、 包含全部关键字/包含任意N个关键字/全部不包含(INCLUDE_KEYWORDS)

分析方式详细说明

• 单句分析、多句分析针对的是当前条件所限定的句子。
• 限定句子：通过当前条件的适用角色、前置条件及检测范围所限定的1个或多个句子。
• 单句分析：对限定句子逐句进行分析，例如检测包含全部关键词，只有限定句子中的某一句包含了全部的关键词，才算命中。
• 多句分析：将限定句子合并为一个段落进行一次分析，例如检测包含全部关键词，只要合并后的段落中包含全部的关键词就算命中

请求示例：

①单句分析、包含任意一个关键字

{
    "keywords":[
        "您好",
        "你好",
        "上午好"
    ],
    "contextChatMatch":false,
}

②多句分析、包含全部关键字

{
    "keywordMatchSize":-1,
    "keywords":[
        "您好",
        "你好",
        "上午好"
    ],
    "contextChatMatch":true
}

③单句分析、包含任意2个关键字、单句话内生效、开启同义词扩展

{
    "keywordMatchSize":2,
    "keywordExtension":1,
    "keywords":[
        "您好",
        "你好",
        "上午好"
    ],
    "in_sentence":true,
    "contextChatMatch":false
}

④单句分析、全部不包含

{
    "keywordMatchSize":0,
    "keywords":[
        "您好",
        "你好",
        "上午好"
    ],
    "contextChatMatch":false
}

2. 正则表达式检查（REGULAR_EXPRESSION）

{
    "regex":"请问.*(车牌号|发动机号|驾驶证号码)",
    "notRegex":"发一下|告诉我",
    "in_sentence":true
}

3. 文本相似度检查（SIMILAR_MATCH）

{
    "score":80,
    "similarlySentences":[
        "我想投诉你们部门",
        "我要投诉你们",
        "我要举报你们部门",
        "我要打12315举报你们",
        "我要到工商管理部门投诉你们"
    ]
}

4. 上下文重复（ADVANCED_REPEAT_DETECT）

{
    "from":3,
    "hit_time":2,
    "threshold":5,
    "excludes":[
        "好的好的我知道了",
        "好的我知道了"
    ]
}

5. 通话静音检查（INTERVAL_GREATER）

{
    "interval":5000,
    "different_role":false,
    "target":1,
    "from_end":false
}

6. 语速检查（SPEECH_SPEED_CHECK）

{
    "velocityInMint":370,
    "average":false,
    "minWordSize":4
}

7. 抢话检查（GRAB_WORDS）

{
    "interval":3000,
    "threshold":4
}

8. 角色判断（ROLE_CHECK）

该算子较为特殊，需要涉及到check_range的改动，详见完整的条件配置示例：

{
    "cid":"1",
    "lambda":"1",
    "check_range":{
        "absolute":true, // 固定值
        "alSentencesSatisfy":true, // 固定值
        "range":{ // 指定要检测的句子位置，from与to的值需要一致
            "from":2,
            "to":2
        }
    },
    "operators":[
        {
            "oid":1,
            "type":"ROLE_CHECK",
            "param":{
                "target_role":"客服"
            }
        }
    ]
}

9. 非正常挂机（DURATION）

根据最后一句话的角色，以及最后一句话的结束时间到挂机的时间间隔来判断是否为非正常挂机，此时check_range.range中的from和to都需要指定为-1，来表示检测最后一句话，详见完整的条件配置示例：

{
    "cid":"1",
    "lambda":"1",
    "check_range":{
        "range":{
            "from":-1, // 固定为-1，表示检测最后一句话
            "to":-1， // 固定为-1，表示检测最后一句话
        }
    },
    "operators":[
        {
            "oid":1,
            "type":"DURATION",
            "param":{
                "interval":3000,
                "beginType":"DIALOGUE",
                "target_role":"客户"
            }
        }
    ]
}

10. 录音时长检查（DURATION）

{
    "interval":60000,
    "compareOperator":"lt"
}

11. 能量检测（ASR_EMOTION）

12. 通用检测模型（EMOTION_MODEL）

由系统内置的算法模型进行分析，目前可检测的类型有：辱骂检测模型、高危检测模型。

13. 客户检测模型（CUSTOMER_CHECK_MODEL）

由系统内置的算法模型进行分析，目前可检测的类型有：扬言投诉客服、扬言找客服主管、质疑客服态度差、内部投诉检测、公共舆情检测。

14. 客服检测模型（ABUSE_MODEL）

由系统内置的算法模型进行分析，无需配置param。

二、规则的配置信息字段RuleInfo说明

规则所属业务字段BusinessCategoryBasicInfo描述：

检测范围range使用说明

检测范围是通过一个数字区间来筛选出当前条件生效的范围，具体说明如下：

一、无前置条件时

1.{"from": 1, "to": 3}，代表所检测角色所说的前三句；

2.{"from": -1, "to": -3}，代表所检测角色所说的最后三句话；

3.{"from": 3, "to": -3}，代表所检测角色所说的正数第三句到倒数第三句。

二、有前置条件时

存在前置条件时，系统会将所有句子，以前置条件命中句为分割点，切分为三个段落：前置条件命中句之前的所有句子、前置条件命中句之后的所有句子、前置条件命中句前后的部分句子，详见下图中所标示的三个段落。需要您先选择一个段落，然后再通过数字区间在该段落内来筛选具体的生效范围。

前置条件命中位置之前(anchor.location的值为 BEFORE)

1.{"from": 1, "to": 3}，代表所检测角色在当前段落内所说的前三句（紧邻前置条件命中句的句子的是第一句）

2.{"from": -1, "to": -3}，代表所检测角色在当前段落内所说的最后三句(倒数第一句到倒数第三句)（距离前置条件命中句最远的是最后一句）

3.{"from": 1, "to": -1}，代表所检测角色在前置条件命中句 之前 的所有句子；

4.{"from": 0, "to": 2}，代表前置条件命中句当句，到所检测角色所说的第二句之间的三句话（只有在当前条件与前置条件的适用角色一致时，才可以使用第0句来定位到前置条件命中句当句，若角色不同，则不允许使用）

5.以上仅为使用示例，并非只能使用以上四种情况，总体来说，正数代表当前段落正数第几句，负数代表当前段落倒数第几句。

前置条件命中位置前后 (anchor.location的值为 AROUND)

1.{"from": 0, "to": 0}，仅代表前置条件命中句当句；

2.{"from": 1, "to": 3}，代表当前置条件命中时，在前置条件命中句“之后”的所检测角色所说的第1句到第3句；

3.{"from": -2, "to": -4}，代表当前置条件命中时，在前置条件命中句子“之前”的所检测角色所说话术的第2句到第4句；

4.{"from": -3, "to": 3}，代表当前置条件命中时，在前置条件命中句子“之前”的所检测角色所说的第3句到“之后”的第3句；

5.以上仅为使用示例，并非只能使用以上四种情况，总体来说，正数代表前置条件命中句之后的句子，负数代表前置条件命中句之前的句子。

前置条件命中位置之后(anchor.location的值为 AFTER)

1.{"from": 1, "to": 3}，代表所检测角色在当前段落内所说的前三句（紧邻前置条件命中句的句子的是第一句）

2.{"from": -1, "to": -3}，代表所检测角色在当前段落内所说的最后三句(倒数第一句到倒数第三句)（距离前置条件命中句最远的是最后一句）

3.{"from": 1, "to": -1}，代表所检测角色在前置条件命中句 之后 的所有句子；

4.{"from": 0, "to": 2}，代表前置条件命中句当句，到所检测角色所说的第二句之间的三句话（只有在当前条件与前置条件的适用角色一致时，才可以使用第0句来定位到前置条件命中句当句，若角色不同，则不允许使用）；

5.以上仅为使用示例，并非只能使用以上四种情况，总体来说，正数代表当前段落正数第几句，负数代表当前段落倒数第几句。

返回数据

示例

请求示例

http(s)://qualitycheck.cn-hangzhou.aliyuncs.com/?Action=UploadRule
&JsonStr={“conditions”:“xxxxx”,"rules":"xxxx"}
&<公共请求参数>

正常返回示例

XML格式

<UploadRuleResponse>
      <code>200</code>
      <data>318</data>
      <message>successful</message>
      <requestId>*****</requestId>
      <success>true</success>
</UploadRuleResponse>

JSON格式

{
    "code":"200",
    "data":[
        "318"
    ],
    "message":"successful",
    "requestId":"*****",
    "success":true
}

错误码

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