文档首页 > > API参考> API> 语言理解服务接口说明> 意图理解

意图理解

分享
更新时间: 2020/07/13 GMT+08:00

功能介绍

针对天气类、报时、新闻类、笑话类、翻译类、提醒类、闹钟类、音乐类8个领域进行意图理解。意图理解包括对用户的问题,陈述进行领域识别以及对对应领域所包含的实体进行抽取。

具体Endpoint请参见终端节点

调用华为云NLP服务会产生费用,套餐包分为基础版和领域版,购买时请在自然语言处理价格计算器中查看基础套餐包和领域套餐包支持的API范围。

URI

  • URI格式
    POST /v1/{project_id}/nlu/semantic-parser
  • 参数说明
表1 URI参数说明

参数名

必选

说明

project_id

项目编号。获取方法,请参见获取项目ID

请求消息

请求参数如表2所示。

表2 请求参数

参数名

参数类型

必选

说明

text

String

待分析分本列表,UTF-8编码,限定32个字符以内,文本长度超过32个字符时,只检测前32个字符。

lang

String

支持的文本语言类型,目前只支持中文(zh),默认为中文。

响应消息

表3 响应参数

参数名

参数类型

说明

result

Result object

调用成功时的返回意图信息。

调用失败时无此字段。

请参见表4

error_code

String

调用失败时的错误码。

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

表4 result字段数据结构说明

参数名

参数类型

说明

text

String

返回待分析分本。

label

String

待分析文本的意图标签。标签共有以下9类:

weather:天气,time:报时,news:新闻,joke:笑话,translation:翻译,notification:提醒,alarm:闹钟,music:音乐,others:其它。

confidence

Float

标签label的置信度。

slots

Array of slot

slot数据结构,请参见表5

表5 slot字段数据结构说明

参数名

参数类型

说明

word

String

实体文本。

tag

String

实体类型。对于每个意图类别所支持的实体类型分别为:

weather:date(日期),time(时间),location(位置)

time:location(位置),timezone(时区)

news:genre(风格)

joke:genre(风格)

translation:content(内容)

notification:content(内容),date(日期),time(时间),singer(歌手)

alarm:date(日期),time:(时间)

music:singer(歌手),song(歌曲),content(内容)

offset

Integer

实体文本在待分析文本中的起始位置。

length

Integer

实体文本长度。

normalized_word

String

同义词或者其他标准表达的词,默认为原始的word。

示例

  • 请求示例
    POST https://{endpoint}/v1/{project_id}/nlu/semantic-parser
    
    Request Header: 
        Content-Type: application/json 
        X-Auth-Token:MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... 
    
    Request Body: 
        {          
            "text":"来一首周杰伦的青花瓷",
            "lang":"zh" 
        }
  • 响应示例
    • 成功响应示例
      {
          "result": {
              "confidence": 1,
              "label": "music",
              "slots": [
                  {
                      "length": 3,
                      "normalized_word": "周杰伦",
                      "offset": 3,
                      "tag": "singer",
                      "word": "周杰伦"
                  },
                  {
                      "length": 3,
                      "normalized_word": "青花瓷",
                      "offset": 7,
                      "tag": "song",
                      "word": "青花瓷"
                  }
              ],
              "text": "来一首周杰伦的青花瓷"
          }
      }
    • 失败响应示例
      {
          "error_code": "NLP.0101",
          "error_msg": "Authentication failed. Please verify the token"
      }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问