簡介 HI,您好,歡迎使用騰訊AI開放平臺意圖成分API接口服務。 本文檔主要針對需要集成HTTP API的技術研發(fā)工程師,詳細描述意圖成分能力相關的技術內容。 如果您對文檔內容有任何疑問,可以通過以下幾種方式聯(lián)系我們: 官方交流一群:581197347 官方交流二群:705874401 官方交流三群:415349651 聯(lián)系郵箱:aicamp@tencent.com 接口能力接口名稱 | 接口描述 | API地址 |
---|
意圖成分 | 對文本進行意圖識別,快速找出意圖及上下文成分 | https://api.ai.qq.com/fcgi-bin/nlp/nlp_wordcom |
更多更強大的接口能力正在開發(fā)中,并逐步開放,敬請期待!
協(xié)議須知調用方集成意圖成分API時,請遵循以下規(guī)則。 規(guī)則 | 描述 |
---|
傳輸方式 | HTTPS | 請求方法 | GET或POST | 字符編碼 | 統(tǒng)一采用UTF-8編碼 | 響應格式 | 統(tǒng)一采用JSON格式 | 接口鑒權 | 簽名機制,詳情請閱接口鑒權 |
意圖成分接口1. 接口描述意圖成分接口提供意圖和成分識別能力,可以幫您輕松找出一段文本包含的用戶意圖以及上下文成分分詞。 2. 請求參數參數名稱 | 是否必選 | 數據類型 | 數據約束 | 示例數據 | 描述 |
---|
app_id | 是 | int | 正整數 | 1000001 | 應用標識(AppId) | time_stamp | 是 | int | 正整數 | 1493468759 | 請求時間戳(秒級) | nonce_str | 是 | string | 非空且長度上限32字節(jié) | fa577ce340859f9fe | 隨機字符串 | sign | 是 | string | 非空且長度固定32字節(jié) |
| 簽名信息,詳見接口鑒權 | text | 是 | string | UTF-8編碼,非空且長度上限100字節(jié) | 今天深圳的天氣怎么樣?明天呢 | 待分析文本 |
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實現(xiàn)該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);
// 執(zhí)行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. 意圖編碼定義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 | 省略詞 |
|