文档中心

简介

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

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

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

官方交流一群：581197347

官方交流二群：705874401

官方交流三群：415349651

联系邮箱：[e-mail]

接口能力

接口名称	接口描述	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调用，其中getReqSign、doHttpPost可以从接口鉴权获取。

// 设置请求数据
$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	省略词