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

意图理解(废弃)

分享
更新时间: 2020/01/17 GMT+08:00

功能介绍

针对天气类、报时、新闻类、笑话类、翻译类、提醒类、闹钟类、音乐类8个领域进行意图理解,对用户的问题进行领域识别并提取领域内的参数。

API已商用,详情请参考价格说明

具体Endpoint请参见终端节点

URI

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

    参数名

    必选

    说明

    project_id

    来自公有云的Project ID,用于资源隔离。获取方式请参见获取项目ID

请求消息

请求参数如表2所示。

表2 请求参数

参数名

参数类型

必选

说明

text

String

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

lang

String

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

响应消息

响应参数如表3所示。

表3 响应参数

参数名

参数类型

说明

result

Result object

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

调用失败时无此字段。

请参见表4

error_code

String

调用失败时的错误码。

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

表4 result字段数据结构说明

参数名

参数类型

说明

text

String

返回待分析分本。

labels

String

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

"天气","报时","新闻","笑话","翻译","提醒","闹钟","音乐"。

confidence

Float

标签label的置信度。

slots

Array of slot

slot数据结构,请参见表5

表5 slot字段数据结构说明

参数名

参数类型

说明

word

String

实体文本。

tag

String

实体类型,枚举类型,支持日期date、时间time、位置location、歌手singer、歌曲song、翻译内容content、风格genre、时区timezone共8类。

offset

Integer

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

len

Integer

实体文本长度。

normalized_word

String

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

示例

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

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区