意图成分

简介

HI,您好,欢迎使用腾讯AI开放平台意图成分API接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师,详细描述意图成分能力相关的技术内容。

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

官方交流一群:581197347

官方交流二群:705874401

官方交流三群:415349651

联系邮箱:aicamp@tencent.com

接口能力

接口名称 接口描述 API地址
意图成分 对文本进行意图识别,快速找出意图及上下文成分 https://api.ai.qq.com/fcgi-bin/nlp/nlp_wordcom

更多更强大的接口能力正在开发中,并逐步开放,敬请期待!

协议须知

调用方集成意图成分API时,请遵循以下规则。

规则 描述
传输方式 HTTPS
请求方法 GET或POST
字符编码 统一采用UTF-8编码
响应格式 统一采用JSON格式
接口鉴权 签名机制,详情请阅接口鉴权

意图成分接口

1. 接口描述

意图成分接口提供意图和成分识别能力,可以帮您轻松找出一段文本包含的用户意图以及上下文成分分词。

2. 请求参数

参数名称 是否必选 数据类型 数据约束 示例数据 描述
app_id int 正整数 1000001 应用标识(AppId)
time_stamp int 正整数 1493468759 请求时间戳(秒级)
nonce_str string 非空且长度上限32字节 fa577ce340859f9fe 随机字符串
sign string 非空且长度固定32字节 签名信息,详见接口鉴权
text string UTF-8编码,非空且长度上限100字节 今天深圳的天气怎么样?明天呢 待分析文本

3. 响应参数

参数名称 是否必选 数据类型 描述
ret int 返回码; 0表示成功,非0表示出错
msg string 返回信息;ret非0时表示出错时错误原因
data object 返回数据;ret为0时有意义
+ text string API请求中的待分析文本
+ intent int 意图编码
+ com_tokens array 成分列表
+ + com_type string 成分编码
+ + com_word int 成分分词

4. 参考示例

假设示例请求数据如下。

参数名称 参数数据 描述
app_id 1000001 仅供参考
text 今天深圳的天气怎么样?明天呢 使用UTF-8编码
time_stamp 实时计算
nonce_str 实时计算
sign 实时计算

假设应用密钥为:a95eceb1ac8c24ee28b70f7dbba912bf

下面使用PHP实现该HTTP API调用,其中getReqSigndoHttpPost可以从接口鉴权获取。

// 设置请求数据
$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';
$params = array(
    'app_id'     => '1000001',
    'text'       => '今天深圳的天气怎么样?明天呢',
    'time_stamp' => strval(time()),
    'nonce_str'  => strval(rand()),
    'sign'       => '',
);
$params['sign'] = getReqSign($params, $appkey);

// 执行API调用
$url = 'https://api.ai.qq.com/fcgi-bin/nlp/nlp_wordcom';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果(注意使用UTF-8编码):

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "text": "今天深圳的天气怎么样?明天呢",
        "intent": 1,
        "com_tokens": [
            {
                "com_type": 6,
                "com_word": "今天"
            },
            {
                "com_type": 7,
                "com_word": "深圳"
            },
            {
                "com_type": 6,
                "com_word": "明天"
            }
        ]
    }
}

5. 意图编码定义

意图编码 意图描述
0 未知
1 天气
2 音乐
3 股票
4 新闻

6. 成分编码定义

成分编码 成分描述
0 未知
1 歌词
2 下载地址
3 乐器
4 歌曲
5 人名
6 时间
7 地点
8 风格
9 数字
10 视频
11 民族
12 专辑
13 序数词
14 综艺
15 乐队
16 景点
17 电影
18 电视剧
19 百科
34 股票名称
35 股票代码
36 指数
37 价格
38 行情
40
41
42 是否
43 餐馆
44 菜名
45 儿歌
46 故事
47 相声
48 评书
49 有声内容
128 类别词
129 关系词
130 省略词
AI开放平台公众号
关注公众号

打造升级AI项目
推送全球AI热点