Nlu - 统一NLU接口

针对用户query,返回机器人有关这个query的语言理解(nlu)结果。当前只支持对话工厂、中控的NLU信息透出,其他引擎后续按需支持。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceIdstring

机器人唯一标识

chatbot-cn-mp90s2lrk00050
Utterancestring

用户表述

北京的天气怎么样
AgentKeystring

业务空间 key,不设置则访问默认业务空间,key 值在主账号业务管理页面获取

ac627989eb4f8a98ed05fd098bbae5_p_beebot_public

返回参数

名称类型描述示例值
object
Messagesarray<object>

消息的列表

消息的列表object
DialogHubNluInfoobject

对话中控的 nlu 信息

GlobalDictListarray<object>

全局名词列表

全局名词列表object
StandardWordstring

名词

天气
Wordstring

同义词

天气
GlobalSensitiveWordListarray<object>

全局敏感词列表

全局敏感词列表object
StandardWordstring

名词

天气
Wordstring

同义词

天气
DsNluInfoobject

对话工厂的 nlu 信息

EntityListarray<object>

实体列表

实体列表object
Namestring

实体名称

@城市
Originstring

实体原词(实体成员)

北京
Typestring

实体类型,当前只有 text 类型

text
Valuestring

实体同义词

首都
IntentListarray<object>

意图列表

意图列表object
IntentIdlong

意图 ID

724387
MatchDetailstring

匹配详情(匹配过程)

classifierType=Fewshot,from=Fewshot,content=[我要查北京的天气, 帮我查北京的天气, 北京天气怎么样, 北京今天下雨吗, 北京今天多少度]
MatchTypestring

匹配类型,其枚举值含义如下: Similarity:query 与意图通过意图话术相似度匹配 Lgf:query 与意图通过 LGF 匹配 Classify:query 与意图通过模型训练匹配 FewShotLearning:query 与意图通过系统内置 fewshot 模型匹配 BuildIn: query 与系统内置意图匹配

FewShotLearning
Namestring

意图名称

查天气意图
Scoredouble

分数

0.995
SlotListarray<object>

命中意图的槽位列表

命中意图的槽位列表object
Namestring

实体名称

@城市
Originstring

实体原词(实体成员)

北京
Typestring

实体类型,当前只有 text 类型

text
Valuestring

实体同义词

首都
RequestIdstring

请求 ID

A6357C1B-1D79-1382-B259-BD9E80751B42
MessageIdstring

本条语言理解应答消息的 ID

2828708A-2C7A-1BAE-B810-87DB9DA9C661

示例

响应报文

{
  "Messages": [
    {
      "DsNluInfo": {
        "EntityList": [
          {
            "Origin": "北京",
            "Name": "@城市",
            "Type": "text",
            "Value": "首都"
          }
        ],
        "IntentList": [
          {
            "Score": 0.995,
            "SlotList": [
              {
                "Origin": "北京",
                "Name": "@城市",
                "Type": "text",
                "Value": "首都"
              }
            ],
            "MatchType": "FewShotLearning",
            "MatchDetail": "classifierType=Fewshot,from=Fewshot,content=[我要查北京的天气, 帮我查北京的天气, 北京天气怎么样, 北京今天下雨吗, 北京今天多少度]",
            "Name": "查天气意图",
            "IntentId": 724387
          }
        ]
      },
      "DialogHubNluInfo": {
        "GlobalDictList": [
          {
            "StandardWord": "天气",
            "Word": "天气"
          }
        ],
        "GlobalSensitiveWordList": [
          {
            "StandardWord": "天气",
            "Word": "天气"
          }
        ]
      }
    }
  ],
  "RequestId": "5C20F0D4-9721-178A-8236-3BF990634962",
  "MessageId": "e7ac691f-b166-4561-bddf-9dd00c8bdce6"
}

示例

正常返回示例

JSON格式

{
  "Messages": [
    {
      "DialogHubNluInfo": {
        "GlobalDictList": [
          {
            "StandardWord": "天气",
            "Word": "天气"
          }
        ],
        "GlobalSensitiveWordList": [
          {
            "StandardWord": "天气",
            "Word": "天气"
          }
        ]
      },
      "DsNluInfo": {
        "EntityList": [
          {
            "Name": "@城市",
            "Origin": "北京",
            "Type": "text",
            "Value": "首都"
          }
        ],
        "IntentList": [
          {
            "IntentId": 724387,
            "MatchDetail": "classifierType=Fewshot,from=Fewshot,content=[我要查北京的天气, 帮我查北京的天气, 北京天气怎么样, 北京今天下雨吗, 北京今天多少度]",
            "MatchType": "FewShotLearning",
            "Name": "查天气意图",
            "Score": 0.995,
            "SlotList": [
              {
                "Name": "@城市",
                "Origin": "北京",
                "Type": "text",
                "Value": "首都"
              }
            ]
          }
        ]
      }
    }
  ],
  "RequestId": "A6357C1B-1D79-1382-B259-BD9E80751B42",
  "MessageId": "2828708A-2C7A-1BAE-B810-87DB9DA9C661"
}

错误码

访问错误中心查看更多错误码。