更新时间:2023-09-27 GMT+08:00

业务请求接口

场景描述

1、首次调用该接口可获取鉴权所需的nonce信息。

2、接口鉴权通过后,调用该接口可从第三方系统获取意图模板的匹配情况。

接口方法

设置成“POST”。

URL

/chatbot/u-route/api/router_service/recognize

请求头参数

名称

是否必选

参数类型

说明

Content-Type

True

String

application/json;charset=utf-8

Chatbot-Token

True

String

认证接口返回的token

请求说明

表1 请求体参数

名称

是否必选

参数类型

说明

request

True

requestBody

请求体

表2 requestBody

名称

是否必选

参数类型

长度

说明

userId

True

String

64

用户ID

accesscode

False

String

32

接入码(用户通过拨打什么号码接入的)

channel

False

String

32

渠道(目前固定填OIFDE)

sentence

True

String

1024

客户输入的文本信息

tenantId

True

String

64

租户ID

language

True

String

20

语言

中文:zh_CN

英文:en_US

context

False

String

64

意图识别需要的上下文

targetIntentCount

False

int

4

需要chatbot返回多个意图时的意图数量,一般用于客户输入一句话可以匹配多个意图的情况

范围:1——5

confidence2Top

False

float

4

置信度间距

如果返回多个意图,要求后面的意图与第一个置信度最高的意图的置信度间距,这个值越小表示返回的意图越接近。

范围:0——1

timeZone

False

String

10

时区,8表示东8区。

响应参数

名称

是否必选

参数类型

长度

说明

errorMsg

False

String

512

错误信息

errorCode

False

String

20

错误码

intentsResponses

False

Intents[]

-

意图数组,成功时必须返回。

nonce

False

String

128

token认证失败时返回,服务端随机生成的字符串,同时需要返回状态码401。

表3 Intents

名称

是否必选

参数类型

长度

说明

responses

False

String[]

4096

Chatbot返回的应答信息,字符串数组,可以有多个。

confidence

True

float

4

置信度

  • 机器人回复的可靠度,取值范围0~1,最小值是0,最大值是1,例如基于你的一个问题1,有10个回答,其中6个回答是相同的Answer1,那么Answer1的置信度是0.6

commands

True

String[]

64

意图命令字

params

False

Map

-

命令字参数信息,一般意图的槽位信息都通过这个返回。例如{"Number":"3"}。

一般意图操作具体详情参考添加意图模板章节。

scenarioName

False

String

64

意图名

scenarioType

False

int

4

场景类型,辅助场景=1, 业务场景=0, 无场景= -1

scenarioStatus

False

String

64

场景状态(暂不使用)

报文样例

  • 请求样例
{
"request":
{
"sentence":"查询3月账单",
"targetIntentCount":1,
"confidence2Top":0.2,
"accessCode":"10086",
"channel":"OIFDE",
"tenantId":"NJ_001",
"language":"zh_CN",
"userId":"123456789"
}
}
  • 响应成功样例:
{
"errorCode":"0",
"errorMsg":"",
"intentsResponses":
[
{
"responses":[""],
"confidence":1.0,
"commands":["bill"],
"params":{"Number":"3"},
"scenarioName":"query bills",
"scenarioType":"normal",
"scenarioStatus":"finish"
}
]
}
  • 响应失败样例:
401 Unauthorized
{
"errorMsg":"NEED_LOGIN","nonce":"0cf*******************accesaf"
}