HI,您好,歡迎使用騰訊AI開放平臺意圖成分API接口服務(wù)。
本文檔主要針對需要集成HTTP API的技術(shù)研發(fā)工程師,詳細描述意圖成分能力相關(guān)的技術(shù)內(nèi)容。
如果您對文檔內(nèi)容有任何疑問,可以通過以下幾種方式聯(lián)系我們:
官方交流一群:581197347
官方交流二群:705874401
官方交流三群:415349651
聯(lián)系郵箱:aicamp@tencent.com
接口名稱 | 接口描述 | API地址 |
---|---|---|
意圖成分 | 對文本進行意圖識別,快速找出意圖及上下文成分 | https://api.ai.qq.com/fcgi-bin/nlp/nlp_wordcom |
更多更強大的接口能力正在開發(fā)中,并逐步開放,敬請期待!
調(diào)用方集成意圖成分API時,請遵循以下規(guī)則。
規(guī)則 | 描述 |
---|---|
傳輸方式 | HTTPS |
請求方法 | GET或POST |
字符編碼 | 統(tǒng)一采用UTF-8編碼 |
響應(yīng)格式 | 統(tǒng)一采用JSON格式 |
接口鑒權(quán) | 簽名機制,詳情請閱接口鑒權(quán) |
意圖成分接口提供意圖和成分識別能力,可以幫您輕松找出一段文本包含的用戶意圖以及上下文成分分詞。
參數(shù)名稱 | 是否必選 | 數(shù)據(jù)類型 | 數(shù)據(jù)約束 | 示例數(shù)據(jù) | 描述 |
---|---|---|---|---|---|
app_id | 是 | int | 正整數(shù) | 1000001 | 應(yīng)用標識(AppId) |
time_stamp | 是 | int | 正整數(shù) | 1493468759 | 請求時間戳(秒級) |
nonce_str | 是 | string | 非空且長度上限32字節(jié) | fa577ce340859f9fe | 隨機字符串 |
sign | 是 | string | 非空且長度固定32字節(jié) | 簽名信息,詳見接口鑒權(quán) | |
text | 是 | string | UTF-8編碼,非空且長度上限100字節(jié) | 今天深圳的天氣怎么樣?明天呢 | 待分析文本 |
參數(shù)名稱 | 是否必選 | 數(shù)據(jù)類型 | 描述 |
---|---|---|---|
ret | 是 | int | 返回碼; 0表示成功,非0表示出錯 |
msg | 是 | string | 返回信息;ret非0時表示出錯時錯誤原因 |
data | 是 | object | 返回數(shù)據(jù);ret為0時有意義 |
+ text | 是 | string | API請求中的待分析文本 |
+ intent | 是 | int | 意圖編碼 |
+ com_tokens | 是 | array | 成分列表 |
+ + com_type | 是 | string | 成分編碼 |
+ + com_word | 是 | int | 成分分詞 |
假設(shè)示例請求數(shù)據(jù)如下。
參數(shù)名稱 | 參數(shù)數(shù)據(jù) | 描述 |
---|---|---|
app_id | 1000001 | 僅供參考 |
text | 今天深圳的天氣怎么樣?明天呢 | 使用UTF-8編碼 |
time_stamp | 實時計算 | |
nonce_str | 實時計算 | |
sign | 實時計算 |
假設(shè)應(yīng)用密鑰為:a95eceb1ac8c24ee28b70f7dbba912bf
。
下面使用PHP實現(xiàn)該HTTP API調(diào)用,其中getReqSign
、doHttpPost
可以從接口鑒權(quán)獲取。
// 設(shè)置請求數(shù)據(jù)$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';$params = array( 'app_id' => '1000001', 'text' => '今天深圳的天氣怎么樣?明天呢', 'time_stamp' => strval(time()), 'nonce_str' => strval(rand()), 'sign' => '',);$params['sign'] = getReqSign($params, $appkey);// 執(zhí)行API調(diào)用$url = 'https://api.ai.qq.com/fcgi-bin/nlp/nlp_wordcom';$response = doHttpPost($url, $params);echo $response;
上述echo $response
的輸出結(jié)果即API的響應(yīng)結(jié)果(注意使用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": "明天" } ] }}
意圖編碼 | 意圖描述 |
---|---|
0 | 未知 |
1 | 天氣 |
2 | 音樂 |
3 | 股票 |
4 | 新聞 |
成分編碼 | 成分描述 |
---|---|
0 | 未知 |
1 | 歌詞 |
2 | 下載地址 |
3 | 樂器 |
4 | 歌曲 |
5 | 人名 |
6 | 時間 |
7 | 地點 |
8 | 風(fēng)格 |
9 | 數(shù)字 |
10 | 視頻 |
11 | 民族 |
12 | 專輯 |
13 | 序數(shù)詞 |
14 | 綜藝 |
15 | 樂隊 |
16 | 景點 |
17 | 電影 |
18 | 電視劇 |
19 | 百科 |
34 | 股票名稱 |
35 | 股票代碼 |
36 | 指數(shù) |
37 | 價格 |
38 | 行情 |
40 | 山 |
41 | 湖 |
42 | 是否 |
43 | 餐館 |
44 | 菜名 |
45 | 兒歌 |
46 | 故事 |
47 | 相聲 |
48 | 評書 |
49 | 有聲內(nèi)容 |
128 | 類別詞 |
129 | 關(guān)系詞 |
130 | 省略詞 |