主题
意图识别服务 FunctionCode | 暂无
意图识别(Intent Recognition)是自然语言处理(NLP)的核心技术之一,通过分析用户输入的文本或语音,理解其背后的目的(如咨询、投诉、下单等),并触发相应的业务响应。其核心目标是让机器理解人类意图,广泛应用于对话系统、智能客服、搜索推荐等领域。
简介
语义理解,基于预训练模型(如BERT、GPT、Transformer),提取文本深层语义特征。支持上下文关联,识别多轮对话中的隐含意图。
意图分类模型,使用深度学习(如CNN、LSTM)或规则引擎,将用户输入映射到预定义的意图标签(如“查询物流”“订餐”“故障报修”)。
实体抽取,结合命名实体识别(NER),提取关键参数(如时间、地点、产品型号),辅助意图精准执行。
应用场景
智能客服,自动区分用户咨询类型(如报告查询、就诊规则、诊前咨询),路由至对应服务模块。
语音助手,解析语音指令(如“挂号”“查报告”),触发相应动作。
搜索增强,理解搜索关键词的真实需求(如“我要去xx医院”对应“医院知识问答”)。
正式环境 | 测试环境 |
---|---|
https://api.linkingopen.com/service/ser-b007/ | https://api.linkingopen.com/test/service/ser-b007 |
接口说明
- 采用POST方法提交数据,请求和响应都是JSON
- 字符编码统一采用UTF-8
- 响应参数公共出参如下
公共出参
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
code | 返回码 0表示成功 | Integer | 是 |
message | 返回信息 | String | 是 |
txTime | 响应时间 格式:yyyy-MM-dd HH:mm:ss | String | 是 |
data | 公共返回数据 | T | 否 |
接口1:创建会话
- 请求地址: /api/ai/intenation/createSession
请求参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
医院ID。 | customerId | String | 是 | 与appId一致 |
用户ID | userId | String | 否 | |
会话ID | sessionId | String | 是 | 会话ID,保证唯一 |
返回参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
授权token | token | String | 是 | 授权token |
参数示例
json
{
"customerId": "1666073006789906",
"userId": "oF00C4814z0yLn-ZAjaLhm-fsLTI",
"sessionId": "q6DWftfu7hTwE5c0JJVT",
"model": "digital-twin"
}
json
{
"txTime": "2023-04-04 13:45:50",
"code": 0,
"message": "操作成功",
"data": {
"token": "3255f44d8e9792e59aa8f7c179040866"
}
}
接口2:意图识别
- 请求地址: /api/ai/intenation/identify
请求参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
医院ID。 | customerId | String | 是 | 与appId一致 |
授权码 | token | String | 是 | |
问题ID | questId | String | 是 | 问题ID,两个用途:第一,幂等校验,统一sessionId下唯一 第二,方便后续追查,后续以questId为凭据查 |
问题 | quest | String | 是 | 用户问题 |
返回参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
问题ID | questId | String | 是 | 问题ID |
识别后的意图 | intention | IntentionRank[] | 是 | 识别后的意图,见下表说明 |
IntentionRank 说明
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
意图类型 | intentionType | String | 是 | 具体类型见备注 |
评分 | intentionRank | Integer | 是 | 评分,满分100分,所有意图总和不超过100分 |
机器人 | robot | RobotRank[] | 是 | 可选用机器人 |
intentionType 说明 云客服(对应model=customer-service): 疾病分诊: triage 咨询服务: consult 数字分身(对应model=digital-twin): 疾病分诊: triage 专有名词: medical 智能预约 appoint 报告查询 report_query 取消预约 appoint_cancel 签到取号 sign_take_number 转人工 manual
RobotRank 说明
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
机器人类型 | robotType | String | 是 | 腾讯分诊机器人: tx-triage,支付宝分诊机器人:alipay-triage,咨询服务机器人: qimo-consult,咨询服务机器人: lk-consult |
评分 | robotRank | Integer | 是 | 评分,满分100分,所有意图总和不超过100分 |
参数示例
json
{
"tenantId": "1666073006789906",
"token": "3255f44d8e9792e59aa8f7c179040866",
"questId": "e94ca1133bebdc571abd247534bdf5b9",
"quest": "我头痛应该挂什么科室?"
}
json
{
"txTime": "2023-04-04 13:45:50",
"code": 0,
"message": "操作成功",
"data": {
"questId": "e94ca1133bebdc571abd247534bdf5b9",
"intention": [
{
"intentionType": "triage",
"intentionRank": 90,
"robot": [
{
"robotType": "tx-triage",
"robotRank": 80
},
{
"robotType": "alipay-triage",
"robotRank": 20
}
]
},
{
"intentionType": "consult",
"intentionRank": 10,
"robot": [
{
"robotType": "qimo-consult",
"robotRank": 90
},
{
"robotType": "lk-consult",
"robotRank": 10
}
]
}
]
}
}
接口3:机器人信息同步
- 请求地址: /api/ai/intenation/robotSync
请求参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
医院ID。 | customerId | String | 是 | 与appId一致 |
识别后的意图 | intention | intention[] | 是 | 识别后的意图,见下表说明 |
intention 说明
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
意图类型 | intentionType | String | 是 | 疾病分诊: triage 咨询服务: consult |
机器人 | robot | RobotRank[] | 是 | 可选用机器人 |
Robot 说明
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
机器人类型 | robotType | String | 是 | 腾讯分诊机器人: tx-triage,支付宝分诊机器人:alipay-triage,咨询服务机器人: qimo-consult,咨询服务机器人: lk-consult |
评分 | robotRank | Integer | 是 | 评分,满分100分,所有意图总和不超过100分 |
返回参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|
参数示例
json
{
"tenantId": "1666073006789906",
"hospitalId": "995290543145750529",
"intention": [{
"intentionType": "triage",
"robot": [{
"robotType": "tx-triage",
"robotRank": 80
}, {
"robotType": "alipay-triage",
"robotRank": 20
}]
}, {
"intentionType": "consult",
"robot": [{
"robotType": "qimo-consult",
"robotRank": 100
}]
}]
}
json
{
"txTime": "2023-04-04 13:45:50",
"code": 0,
"message": "操作成功"
}
接口4:意图信息反馈
此接口需要将意图识别后的结果反馈
数据用于两个方面:
将咨询未判断出的会话进行反馈,提升意图识别的准确性
咨询服务的结果用于判断机器人的评分及自研客服机器人的回答提升
请求地址: /api/ai/intenation/sessionFeedback
请求参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
问题ID | questId | String | 是 | 问题ID,两个用途:第一,幂等校验,统一sessionId下唯一 第二,方便后续追查,后续以questId为凭据查 |
机器人类型 | robotType | String | 是 | 腾讯分诊机器人: tx-triage,支付宝分诊机器人:alipay-triage,咨询服务机器人: qimo-consult |
返回参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|
参数示例
json
[{
"tenantId": "1666073006789906",
"hospitalId": "995290543145750529",
"questId": "e94ca1133bebdc571abd247534bdf5b9",
"robotType": "qimo-consult"
}, {
"tenantId": "1666073006789906",
"hospitalId": "995290543145750529",
"questId": "e94ca1133bebdc571abd247534bdf5b8",
"robotType": "lk-consult"
}]
json
{
"txTime": "2023-04-04 13:45:50",
"code": 0,
"message": "操作成功"
}
接口5:数字分身意图分类
- 请求地址: /api/ai/intenation/classification
请求参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
授权码 | token | String | 是 | |
问题ID | questId | String | 是 | 问题ID,两个用途:第一,幂等校验,统一sessionId下唯一 第二,方便后续追查,后续以questId为凭据查 |
问题 | quest | String | 是 | 用户问题 |
返回参数
名称 | 描述 | 类型 | 必填 | 备注 |
---|---|---|---|---|
标签 | label | String | 是 | 标签说明 |
标签说明
- TRIAGE:智能分诊
- APPOINT:预约操作
- PAY_QUERY:缴费查询
- APPOINT_QUERY:预约记录查询
- REPORT_QUERY:报告查询
- CANCEL_APPOINT:取消预约
- SIGN_TAKE_NUMBER:签到取号
- MANUAL:人工
- CONSULT:咨询
参数示例
json
{
"tenantId": "1666073006789906",
"token": "3255f44d8e9792e59aa8f7c179040866",
"questId": "e94ca1133bebdc571abd247534bdf5b9",
"quest": "我头痛应该挂什么科室?"
}
json
{
"txTime": "2024-08-22 15:22:06",
"code": 0,
"message": "操作成功",
"data": {
"label": "CONSULT"
}
}