语义识别业务请求接口
场景描述
获取意图模板的匹配情况。
接口方法
设置成“POST”。
URL
https://IP:PORT/oifde/rest/api/speechrecognition
请求说明
参数名称 |
数据类型 |
参数位置 |
必选/可选 |
描述 |
---|---|---|---|---|
userId |
String |
body |
True |
用户ID 限制长度:64 |
sentence |
String |
body |
True |
客户输入的文本信息 限制长度:1024 |
tenantId |
String |
body |
True |
租户ID 限制长度:64 |
language |
String |
body |
True |
语言,选项如下:
|
targetIntentCount |
String |
body |
False |
需要chatbot返回多个意图时的意图数量,一般用于客户输入一句话可以匹配多个意图的情况。 取值范围:1~5 |
confidence2Top |
String |
body |
False |
置信度间距如果返回多个意图,要求后面的意图与第一个置信度最高的意图的置信度间距,这个值越小表示返回的意图越接近。 取值范围:0~1 |
context |
String |
body |
False |
传递意图识别需要的上下文,当前接口只支持传递单个上下文。 上下文的使用,需要结合意图配置单个上下文。 限制长度:128 |
domainList |
List<String> |
body |
False |
传递已经存在且激活的领域id列表。 限制数量:100 |
faqGroupList |
List<String> |
body |
False |
传递已经存在且激活的问答组id列表。 限制数量:100 |
authToken |
String |
body |
True |
访问接口的有效Token值。 有效Token信息通过获取Token接口获取。 请参见C3 智能助手平台接口鉴权方式。 限制长度:32 |
响应说明
参数名称 |
数据类型 |
参数位置 |
必选/可选 |
描述 |
---|---|---|---|---|
errorCode |
int |
body |
True |
错误码 返回0:成功 其他值:失败 |
errorMessage |
String |
body |
False |
错误信息 |
intentsResponses |
intentsResponses[] |
body |
False |
意图数组,成功时必须返回。 |
参数名称 |
数据类型 |
参数位置 |
必选/可选 |
描述 |
---|---|---|---|---|
responses |
String[] |
body |
False |
Chatbot返回的应答信息,字符串数组,可以有多个。 |
confidence |
float |
body |
True |
置信度 |
commands |
String[] |
body |
True |
意图命令字 |
commandParams |
Map |
body |
False |
命令字参数信息,一般意图的槽位信息都通过这个返回。 例如{"Number":"3"}。 一般意图操作具体详情参考添加意图模板章节。 |
scenarioName |
String |
body |
False |
意图名 |
scenarioStatus |
String |
body |
False |
场景状态 |
simQuestions |
List<String> |
body |
False |
对于FAQ应答存在相似问时,返回相似问。(相似问指的是:除匹配的主问题外的其他问题。) |
报文样例
- 请求消息样例
{ "userId": "1649209493813571405", "sentence": "查询话费", "tenantId": "202205125916", "language": "zh_CN", "targetIntentCount": "2", "confidence2Top": "0.5", "authToken": "Xun4*******************yAmResnf", "context":"查询话费", "domainList":[10039], "faqGroupList":[10952,10950] }
- 响应消息样例
{ "intentsResponses": [ { "scenarioStatus": "finish", "confidence": 1.0, "responses": "尊敬的用户,您当前话费账户余额为56元。", "scenarioName": "话费查询", "commands": "查询话费" } ], "errorCode": 0 }
- 请求消息样例(包含FAQ问答)
{ "userId": "1649209493813571405", "sentence": "优惠套餐推荐", "tenantId": "202205125916", "language": "zh_CN", "targetIntentCount": "2", "confidence2Top": "0.5", "authToken": "Xun4vb*******************mResnf", "context":"", "domainList":[10039], "faqGroupList":[10952,10950] }
- 响应消息样例
{ "intentsResponses": [ { "simQuestions": [ "有实惠一点的流量套餐可以办理" ], "scenarioStatus": "SUCCESS", "confidence": 23.0, "responses": "本月特惠,10元3G流量。", "scenarioName": "1721756338", "commands": "systemQA" } ], "errorCode": 0 }