文档简介：
智能工单推荐
接口描述
对投诉类、网络故障类等历史工单进行阅读，将与当前工单相似的历史工单推荐给用户，以达到故障处理借鉴的效果
接口要求
文本格式：
1. 每次请求文本长度不超过500个字符，且仅支持单条文本处理
2. 仅支持简体中文文本，如果文本内容超过50%非中文，则返回错误，具体见错误码4004对应内容
3. 文本字符串不能为空，且不能全为空格或者换行等转义符
请求说明
-
请求示例
HTTP方法：POST
请求URL：https://ai.ctyun.cn/v1/aiop/api/[系统生成的服务码]/shai/promt
-
请求头说明
|
参数 |
值(说明) |
|
Content-Type |
application/json |
|
Sign |
MD5(AppKey + AppSecret + Timestamp + Path + Http Body)，32位小写的MD5加密串 |
|
Timestamp |
13位时间戳 |
|
AppKey |
平台分配给应用独立的AppKey |
-
请求参数
|
参数 |
是否必选 |
类型 |
可选值范围 |
说明 |
|
data |
true |
string |
- |
请求参数放置于http body中，为一段文本字符串 |
-
请求示例代码
Bash：
curl -X POST https://ai.ctyun.cn/v1/aiop/api/[系统生成的服务码]/shai/promt -H "Content-Type: application/json" -H 'Sign: XXXXX' -H 'Timestamp: XXXXX' -H 'AppKey: XXXXX' --data '{"data": "string"}'
Python：
# -*- coding: utf-8 -*-
import requests
import base64
import hashlib
import time
import json
'''
智能工单推荐
'''
def md5(key):
input_name = hashlib.md5()
input_name.update(key.encode("utf-8"))
return input_name.hexdigest()
request_url = "智能工单推荐API URL"
params = {"data": "string"}
app_key = '平台分配的APP Key'
app_secret = '平台分配的APP Secret '
time_stamp = str(int(round(time.time() * 1000)))
headers = {
'content-type': 'application/json',
'Sign': md5(app_key + app_secret + time_stamp + '/v1/aiop/api/[系统生成的服务码]/shai/promt' + json.dumps(params)),
'Timestamp': time_stamp,
'AppKey': app_key
}
response = requests.post(request_url, data=json.dumps(params), headers=headers)
if response:
print(response.json())
返回说明
-
API调用成功返回值
|
返回字段 |
是否必选 |
类型 |
字段说明 |
|
code |
true |
int |
返回状态，返回0表示成功 |
|
message |
true |
string |
返回对应的可读消息，值为success |
|
result |
true |
object |
API具体返回信息 |
|
故障描述 |
true |
list of str |
按相似度推荐的工单列表 |
|
相似度 |
true |
list of float |
工单对应的相似度列表 |
-
API调用失败返回值
|
返回字段 |
是否必选 |
类型 |
字段说明 |
|
code |
true |
int |
错误码，参见本文档错误码说明部分 |
|
message |
true |
string |
返回对应的可读消息，值为error |
|
details |
true |
string |
错误消息 |
-
返回示例
HTTP/1.1 200 OK
Content-Type: application/json
{
"code": 0,
"message": "success"
"result":{
"故障描述":[
"用户反映无法拨打美国的号码23:15左右161XXXXXXXX，提示你所拨打号码不存在，用移动手机拨打正常，请查证处理，谢谢。*****HLR与CRM数据比对一致，查用户数据正常，国际长途功能开通，查看呼叫记录，用户拨打该号码的记录我方已送至上海ISC3，记录已上传，请转国际局协查。",
"安徽173XXXXXXXX漫游上海，普通用户；1日 14：50 拨打合肥拨打合肥 ，提示拨打号码不正确；查信令上海XXX 返回XXX错误。 请上海集团NOC核查。 记录见附件。 ",
"用户来电反映199XXXXXXXX漫游在山东济南无法接听电话，例如152XXXXXXXX是北京移动手机（号码）拨打199XXXXXXXX此号码提示空号，接续消息已经送到（详见附件），请集团上海帮忙核查。",
"0571用户反映无法拨打山东济南的移动联通电信的电话都打不通,比如2019-08-01 09:18:25 主叫号码057呼叫1895已经送至上海了，对方回的释放。请集团和山东协查",
"北京电信用户177XXXXXXXX投诉拨打041XXXXXXXX不通。我方用测试机133XXXXXXXX于2018.1.1 10:38拨打也无法拨通，请协查，谢谢。",
"95XXX用户反映XXXX 95XXX热线打进忙音，我处025-865XXXXXXXX在13:05左右拨测95XXX提示忙音，拨打用户落地号码031XXXXXXXX正常回铃音，请平台核实",
"四次拨打都失败，时间分别是2017-12-31 19:02:31,2017-12-31 19:09:11,2017-12-31 19:26:40,2017-12-31 19:38:45. 用主叫85XXXXXXXX拨打867XXXXXXXX，听到2-3次铃声然后掉线，请集团协查。",
"079XXXXXXXX用户来电反映无法拨打长途，用户数据正常有国内长途权限，用户拨测了153XXXXXXXX和156XXXXXXXX两个手机,我方跟踪了消息,一个送给XXXXXXXX,是XXXXXXXX回的无效号码格式;另一个送给了XXXXXXXX,是XXXXXXXX回的无效号码格式(消息请见附件),请集团核查。",
"请集团协助封堵主叫869XXXXXXXX，我处查看有大量此主叫拨打WESTERN SAMOA造成XXX,请查看附件",
"境外申告漫游无法呼叫:目的地：CHINA-MOBILE CM 症状：CALL FAIL（MSRN） 目的地代码：0-9173 CDR日志如下 日期和时间GMT＃DEST＃B号码#A号码＃详细呼叫记录见附件"
],
"相似度":[
0.7276202006427118,
0.7205485385931023,
0.6688286744010508,
0.6562693145083968,
0.6042671435338854,
0.5678871524051599,
0.5662423034792552,
0.5525977575781975,
0.5129372699940562,
0.5095703137781431
]
}
}
错误码说明
|
错误代码 |
错误消息 |
错误可能原因 |
|
4001 |
请求中未包含内容 |
请求体中参数为空字符串或者全为空格等转义字符 |
|
4002 |
请求参数异常 |
请求的参数格式不正确或者参数名错误 |
|
4003 |
文本长度超过限度 |
传递的文本中存在超过规定最大长度的文本，最大长度为500 |
|
4004 |
请求文本为非法字符串 |
传递的文本中存在大量的非中文字符，非中文字符占比不能超过50% |
|
4005 |
不支持的请求方法 |
仅支持HTTP POST方法 |
|
4006 |
请求的API不存在 |
请求的API路径错误 |
|
5000 |
服务内部错误 |
服务内部发生错误，需要联系管理员处理 |
