问答接口
URL
POST /v1/openapi/tenants/{tenantId}/robots/{robotId}/robot/ask
URL请求签名参数
?adminkey={adminkey}&customerId={customerId}&nonce={nonce}×tamp={timestamp}&sign={sign}
Header
Content-Type:application/json
请求体示例
{
"userId":"myUserId",
"question":"保险公司会不会倒闭",
"channel":"API",
"questionType":"TEXT"
}
请求体参数说明
名称 | 类型 | 必填 | 说明 | 限制 |
---|---|---|---|---|
userId | string | 是 | 请求问答服务的用户ID | 36位以内的字符串 |
question | string | 是 | 用户问题 | 200字以内 |
channel | string | 是 | 渠道来源,API调用填“API”即可 | 填“API“即可 |
questionType | string | 是 | 问题类型,API调用仅支持文本类型,即TEXT | 填“TEXT”即可 |
Curl请求示例
curl -XPOST -H 'Content-Type:application/json' \
'https://bot.4paradigm.com/v1/openapi/tenants/133/robots/c7a9dc87-59ba-4c46-b255-a2d8eff47ca2/robot/ask?adminkey=aWNzLWJpZy1jdXN0b21lci13eXMtMTUyMzUyMDg5NDU0MQ==&customerId=wys&nonce=12345678×tamp=1524199743944&sign=14d5120c76b773447ed07fac46b07bc4' \
-d '{ \
"userId": "myUserId", \
"question": "保险公司会不会倒闭", \
"channel": "API", \
"questionType": "TEXT" \
}'
响应示例
{
"code":"0",
"data":
{
"answerType":"BESTMATCH",
"answerContentType":"TEXT",
"answer":"不会。《保险法》第85、88条有规定:经营有人寿保险业务的保险公司,除分立、合并外,不得解散。经营有人寿保险业务的保险公司被依法撤消的或者被依法宣告破产的,其持有的人寿保险合同及准备金,必须转移给其他经营有人寿保险业务的保险公司;不能同其他保险公司达成转让协议的,由金融监督管理部门指定经营有人寿保险业务的保险公司接受转让。",
"score":1.0,
"items":null,
"module":"KB"
},
"msg":"success"
}
响应参数
名称 | 说明 |
---|---|
answerType | 匹配答案类型。BESTMATCH:唯一最佳答案;RECOMMEND:推荐多个相似问题;MENU:匹配上文字菜单 |
answerContentType | 答案类型(TEXT,文本;IMAGE,图片;IMAGE_TEXT,图文;AUDIO,语音;MENU,菜单。API方式下仅返回TEXT类型) |
answer | 答案 |
score | 答案得分,范围在0~1之间 |
items | 推荐问题列表或者菜单列表 |
module | 答案来源(NONE,KB,KG,DIALOG,CHAT,ROBOT ...) |