问答接口

URL

POST /v1/openapi/tenants/{tenantId}/robots/{robotId}/robot/ask

URL请求签名参数

?adminkey={adminkey}&customerId={customerId}&nonce={nonce}&timestamp={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&timestamp=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 ...)

results matching ""

    No results matching ""