UploadRule_智能对话分析_API文档

请求参数 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.以上仅为使用示例，并非只能使用以上四种情况，总体来说，正数代表当前段落正数第几句，负数代表当前段落倒数第几句。