上传分析规则_Java-SDK_旧版 SDK 参考_开发指南

接口说明

客户（或者ISV）通过调用该API将一条分析规则上传给分析系统，返回本条分析规则在分析系统中的规则Id。

入参UploadRuleRequest说明

属性	值类型	是否必须	说明
jsonStr	String	是	完整Json字符串信息，具体内容参见以下详细信息

请求参数Json字符串信息

属性	值类型	是否必须	说明
appKey	String	是	业务方或者业务场景的标记
conditions	List< ConditionBasicInfo>	是	所有条件的配置信息
rules	List< RuleInfo>	是	所有规则的配置信息

条件的详细配置字段ConditionBasicInfo描述:

属性	值类型	是否必须	说明
cid	String	是	条件的ID，必须数字字符，此数字在规则上传后会被修改为系统自生成Id
check_range	CheckRange	是	条件的检查范围
operators	List< OperatorBasicInfo>	是	条件包含的算子
lambda	String	是	条件中算子的逻辑关系

条件检查范围CheckRange描述:

属性	值类型	是否必须	说明
role	String	否	角色，条件的作用角色范围, 取值：“客服”，“客户”；不传表示所有角色
anchor	Anchor	否	条件的锚定关系, 即前置条件
range	Range	否	Role和Anchor共同决定的范围。1~N表示由anchor和role共同限定的第1（N）句，-1表示由anchor和role共同限定的最后一句

条件锚定关系Anchor描述:

属性	值类型	是否必须	说明
location	String	是	取值：CURRENT, BEFORE, AFTER; CURRENT: 前置条件命中的当前句 BEFORE: 前置条件命中句子之前 AFTER: 前置条件命中句子之后
cid	String	是	前置条件id 用于确定anchor的条件
hit_time	Integer	是	hit_time 整数 1~N代表前置条件第一（N）次命中，-1代表条件最后一次命中

条件范围Range描述:

属性	值类型	是否必须	说明
from	Integer	是	1~N表示由anchor和role共同限定的第1（N）句，-1表示由anchor和role共同限定的最后一句
to	Integer	是	1~N表示由anchor和role共同限定的第1（N）句，-1表示由anchor和role共同限定的最后一句

条件所包含算子OperatorBasicInfo描述:

属性	值类型	是否必须	说明
oid	String	是	算子的ID，必须数字字符，此数字在规则上传后会被修改为系统自生成Id
type	String	是	算子类型，参考< operator算子type字段说明>
name	String	是	算子名称、描述
param	Param	是	算子表达式具体内容

条件所包含算子具体内容 Param描述：

属性	值类型	是否必须	说明
keywords	List< String>	否	用于测试是否包含某些关键词，关键词列表
regex	String	否	用于正则算子，正则表达式
phrase	String	否	用于语义匹配算子，参考句子
references	List< String>	否	用于相似度匹配，算子表达式具体内容
interval	Integer	否	用于时间间隔算子，时间间隔
threshold	Float	否	用于编辑距离和匹配予以算子，指定的阈值
in_sentence	Boolean	否	关键词或者正则表达式检测时，是否限定在一个句子中（以逗号、句号等标号分开的算不同句子）；true:限定在一个句子中；false:不限定。
target	Integer	否	目标句子是当前句子的前多少句，为0时间间隔等于本句的结束时间-本句的开始时间
from_end	Boolean	否	用于时间间隔算子，判断时间间隔，指定时间间隔的计算方式是否用本句的结束时间减目标句子的结束时间
different_role	Boolean	否	用以时间间隔算子，判断时间间隔，为true则目标句子如果与本句是同一个角色说的话就不参与计算
target_role	String	否	用于判断重复算子，如果本句匹配上该正则表达式，那么匹配上的部份会在本句之前target_role指定的句子中查找
velocity	Double	否	用于语速判断算子。单位时间内的语速值，判断本句的语速是否超过指定值。时间单位取决于传入的start、end的时间单位
velocityInMint	Integer	否	用于语速判断算子。每分钟的语速值，用以判断本句的语速是否超过指定值

规则的详细配置字段RuleInfo描述：

属性	值类型	是否必须	说明
rid	String	是	规则的ID，必须数字字符，此数字在规则上传后会被修改为系统自生成Id
lambda	String	是	规则中条件的逻辑关系
business	List< BusinessCategoryBasicInfo>	是	规则所属业务
triggers	List< String>	是	规则中需要返回内容的条件ID。设置规则ID的话，命中结果后将会返回规则所命中的具体内容
Name	String	是	规则的名字
type	Integer	是	1/2/3/4: 服务规范/舆情监控/业务类/其他
status	Integer	否	0/1/2：待生效/生效中/已失效
startTime	Date	否	规则的生效时间
endTime	Date	否	规则的失效时间
scoreSubId	Integer	否	规则绑定的计分id
ruleScoreType	Integer	否	该规则是否进行计分（1：不计分 3：计分）

规则所属业务字段BusinessCategoryBasicInfo描述：（若该属性为空，设置为默认的“所有业务”类型)

属性	值类型	是否必须	说明
bid	String	是	规则所属业务BID，必须数字字符
name	String	是	规则所属业务名称，必须数字字符

算子中Param配置示例

算子类型	算子名称	param示例
INCLUDE_KEYWORDS	包含全部关键字	{“in_sentence”:false,”keywords”:[“你好”]}
INCLUDE_KEYWORDS	包含全部关键字并开启同义词	{“in_sentence”:false,”keywordExtension”:1,”keywords”:[“医疗”]}
HIT_ANY_KEYWORDS	包含任意一个关键词	{“in_sentence”:false,”keywords”:[“你好”]}
HIT_ANY_KEYWORDS	包含任意一个关键词并开启同义词	{“in_sentence”:false,”keywordExtension”:1,”keywords”:[“你好”]}
REGULAR_EXPRESSION	匹配正则表达式	{“in_sentence”:false,”regex”:”你好.*”}
PARAPHRASE	匹配语义	{“in_sentence”:false,”references”:[“你好”,”服务”],”threshold”:0.8}
INTERVAL_GREATER	与上句时间间隔大于给定值	{“different_role”:false,”from_end”:false,”in_sentence”:false,”interval”:10000,”target”:1}
INTERROGATIVE_SENTENCE	判断本句是否疑问句	{“in_sentence”:true}
REPETITION_DETECT	判断匹配上的内容是否之前有出现过	{“in_sentence”:false,”regex”:”你好.*”,”target_role”:”客服”}
SPEECH_SPEED_CHECK	判断本句的语速是否超过指定值	{“in_sentence”:false,”velocity”:0.00416667,”velocityInMint”:250}
GRAB_WORDS	抢话算子	{“in_sentence”:false,”interval”:10,”threshold”:10.0}
EMOTION_ENERGY	能量值判断	{“in_sentence”:false}

调用示例


UploadRuleRequest uploadRuleRequest = new UploadRuleRequest();
        uploadRuleRequest.setAcceptFormat(FormatType.JSON);
        String ruleJsonStr = "{\n" +
                "    \"appKey\": \"********\",\n" +
                "    \"uploadType\": 0,\n" +
                "    \"conditions\": [\n" +
                "        {\n" +
                "            \"cid\": \"1\",\n" +
                "            \"check_range\": {\n" +
                "                \"role\": \"客服\",\n" +
                "                \"range\": {\n" +
                "                    \"from\": 1,\n" +
                "                    \"to\": 3\n" +
                "                }\n" +
                "            },\n" +
                "            \"operators\": [\n" +
                "                {\n" +
                "                    \"oid\": \"1\",\n" +
                "                    \"type\": \"REGULAR_EXPRESSION\",\n" +
                "                    \"param\": {\n" +
                "                        \"regex\": \"告诉.*密码\"\n" +
                "                    },\n" +
                "                    \"name\": \"ApiCreateRuleDemo\"\n" +
                "                }\n" +
                "            ],\n" +
                "            \"lambda\": \"1\"\n" +
                "        },\n" +
                "        {\n" +
                "            \"cid\": \"2\",\n" +
                "            \"check_range\": {\n" +
                "                \"role\": \"客户\",\n" +
                "                \"range\": {\n" +
                "                    \"from\": 1,\n" +
                "                    \"to\": -1\n" +
                "                }\n" +
                "            },\n" +
                "            \"operators\": [\n" +
                "                {\n" +
                "                    \"oid\": \"2\",\n" +
                "                    \"type\": \"REGULAR_EXPRESSION\",\n" +
                "                    \"param\": {\n" +
                "                        \"regex\": \"修改密码\"\n" +
                "                    },\n" +
                "                    \"name\": \"ApiCreateRuleDemo\"\n" +
                "                }\n" +
                "            ],\n" +
                "            \"lambda\": \"2\"\n" +
                "        }\n" +
                "    ],\n" +
                "    \"rules\": [\n" +
                "        {\n" +
                "            \"rid\": \"1\",\n" +
                "            \"lambda\": \"1&&2\",\n" +
                "            \"triggers\": [\n" +
                "                \"1\",\n" +
                "                \"2\"\n" +
                "            ],\n" +
                "            \"name\": \"testbyapi\",\n" +
                "            \"type\": 1,\n" +
                "            \"comments\": \"comments\",\n" +
                "            \"scoreSubId\": 277,\n" +
                "            \"ruleScoreType\": 1,\n" +
                "            \"business\": [\n" +
                "                {\n" +
                "                    \"bid\": 264971810,\n" +
                "                    \"name\": \"业务A\"\n" +
                "                },\n" +
                "                {\n" +
                "                    \"bid\": 386664996,\n" +
                "                    \"name\": \"业务B\"\n" +
                "                }\n" +
                "            ]\n" +
                "        }\n" +
                "    ]\n" +
                "}";
        uploadRuleRequest.setJsonStr(ruleJsonStr);
        UploadRuleResponse response =     client.getAcsResponse(uploadRuleRequest);

返回示例


{
    "code":"200",
    "data":[
        "318" //数据库存储的规则id
    ],
    "message":"successful",
    "requestId":"*****",
    "success":true
}