叡揚資訊

GSS 技術部落格

在這個園地裡我們將從技術、專案管理、客戶對談面和大家分享我們多年的經驗，希望大家不管是喜歡或是有意見，都可以回饋給我們，讓我們有機會和大家對話並一起成長！
若有任何問題請來信：gss_crm@gss.com.tw

5 分鐘閱讀時間 (1030 個字)

字體大小: + –

分享 Call Language Understanding (LUIS) predictions api 的 3 種方式

經驗分享程式語言 .NET

2018/02/28, 週三

922 點擊

0 評論

在前一篇「線上客服 + Chatbot = 智慧客服」我們透過 LUIS + Vital ESP(FAQ系統) 來打造智慧客服 Chatbot 。在上線之前，需要先透過一堆問題去 Call LUIS 的 api ，來驗證我們在 LUIS 中設定的意圖及 Entities 是否正確。

即然是 Call LUIS api 雲端服務，就會有費用問題，所以我們先來看一下 LUIS api 的價格說明，

luis.ai api 價格說明

LUIS API - 免費: 每月最多可以 Call 10,000 次
LUIS API - 基本: 每月最多可以 Call 10,000 次 (免費)，超過後，每 Call 1,000 次約台幣 45.09 元
詳細請參考認知服務定價 - Language Understanding (LUIS)

目前我們可以在 LUIS 上手動測試意圖，但如果想要更有彈性的話，就要透過程式去呼叫它的 api ，所以以下我們就介紹 Call api 的 3 種方式，

Call luis.ai predictions api 的 3 種方式

在 LUIS predictions GET api 中有各語言的使用範例，以C#來看，使用非常方便，只要設定一些參數就可以取回 LUIS 解析的資料，本文將跟大家分享 Call 正式 api 的 GET/POST 方式，及 Call 測試 api 的方式，共 3 透方式。

call 正式 api 使用 GET，如下，

static async Task<string> GetLuisResult(string reqString)
{
//最多是 500 個 ascii chars，中文我先取 230 個
if (reqString.Length > 230)
{
reqString = reqString.Substring(0, 230);
}
var client = new HttpClient();
var queryString = HttpUtility.ParseQueryString(string.Empty);
const string appId = "你的appid";
const string subscriptionKey = "你的訂閱key";
// Request headers
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", subscriptionKey);
 
// Request parameters
//如果回傳的內容中需要各 Intent 的話，請將 verbose 設定為 true
queryString["verbose"] = "true";
//queryString["spellCheck"] = "{boolean}";
//queryString["staging"] = "{boolean}";
//queryString["bing-spell-check-subscription-key"] = "bing key";
//queryString["log"] = "{boolean}";
 
var uri = $"https://eastasia.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q=" + HttpUtility.UrlEncode(reqString)+ "&" + queryString;;
var response = await client.GetAsync(uri);
var result = await response.Content.ReadAsStringAsync();
return result;
}

call 正式 api 使用 POST (筆者試了老半天都試不出來，後來詢問 MS Herman 大大才知道，POST 的 body 前後要加雙引號)，如下，

static async Task<string> GetLuisResultPost(string reqString)
{
//最多是 500 個 ascii chars，中文我先取 230 個
if (reqString.Length > 230)
{
reqString = reqString.Substring(0, 230);
}
var client = new HttpClient();
var queryString = HttpUtility.ParseQueryString(string.Empty);
const string appId = "你的appid";
const string subscriptionKey = "你的訂閱key";
// Request headers
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", subscriptionKey);
 
// Request parameters
//如果回傳的內容中需要各 Intent 的話，請將 verbose 設定為 true
queryString["verbose"] = "true";
//queryString["spellCheck"] = "{boolean}";
//queryString["staging"] = "{boolean}";
//queryString["bing-spell-check-subscription-key"] = "bing key";
//queryString["log"] = "{boolean}";
var uri = $"https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?" + queryString;
 
HttpResponseMessage response;
 
// Request body，前後要加上 雙引號 哦!
byte[] byteData = Encoding.UTF8.GetBytes("\"" + reqString + "\"");
using (var content = new ByteArrayContent(byteData))
{
response = await client.PostAsync(uri, content);
var result = await response.Content.ReadAsStringAsync();
return result;
}
}

註: 在 LUIS 設定好，按下 Train 後，請記得要到 PUBLISH , 按下「Publish to production slot」，這樣才會部到各區域去哦!

知道如何 Call Production 的 api 之後，如果我們想要像線上客服 + BOT 之路一文中，先用個 Excel 檔去試看看的話(目前 luis.ai 上 support 上傳 json , 整批測試)，多試個幾次，免費的 quota 應該一下子就沒了吧! 如下所示，

那怎麼辦呢?

1.到 Azure 那買個服務，然後再將訂閱的 Key 加到 luis.ai 之中，如下，
2.使用 luis.ai 測試的 api ，您可以在測試時，錄一下 network ，如下，

所以 Call luis.ai 測試 api 的方式如下，

static async Task<string> GetLuisResultTest(string reqString)
{
//最多是 500 個 ascii chars，中文我先取 230 個
if (reqString.Length > 230)
{
reqString = reqString.Substring(0, 230);
}
var client = new HttpClient();
var queryString = HttpUtility.ParseQueryString(string.Empty);
const string appId = "你的appid";
const string subscriptionKey = "你的免費訂閱key";
// Request headers
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", subscriptionKey);
var uri = $"https://westus.api.cognitive.microsoft.com/luis/webapi/v2.0/apps/{appId}/versions/0.1/predict?example=" + HttpUtility.UrlEncode(reqString);
var response = await client.GetAsync(uri);
var result = await response.Content.ReadAsStringAsync();
return result;
}

這個測試的 api 跟正式機的差別除了內容不太相同，它取出的 Entity 中間會有空白，所以再使用上需要將空白清掉哦! 因為它是測試用的，所以在整批 Call 的時候，有時會 block 一段時間，我的做法是如果出錯就停個 15 秒，讓它再重試一次，後來就可以正常再 Call 了哦!

正式 api 的結果如下 ( verbose 參數為 true, 內容才會有 intents )，

{
"query": "下載下來可以用了，可是什麼是網址識別",
"topScoringIntent": {
"intent": "FAQ",
"score": 1.0
},
"intents": [
{
"intent": "FAQ",
"score": 1.0
},
{
"intent": "None",
"score": 0.05330094
}
],
"entities": [
{
"entity": "網址",
"type": "Keyword",
"startIndex": 14,
"endIndex": 15,
"score": 0.9081365
},
{
"entity": "識別",
"type": "Keyword",
"startIndex": 16,
"endIndex": 17,
"score": 0.9102927
},
{
"entity": "下載",
"type": "Action",
"startIndex": 0,
"endIndex": 1,
"score": 0.9999258
}
]
}

測試 api 的結果如下( entityPredictions 中的 phrase 字之間會有空白哦!!! )，


{

    "id": null,

    "text": "下載下來可以用了，可是什麼是網址識別",

    "alteredText": "下載下來可以用了，可是什麼是網址識別",

    "tokenizedText": [

        "下"    ],

    "intentPredictions": [

        {

            "id": "9e70ed0a-561c-45f4-b8a4-2439de42acb1",

            "name": "FAQ",

            "score": 1.0        },

        {

            "id": "8d898fa2-667f-471d-b87f-309011627b5d",

            "name": "None",

            "score": 0.05        }

    ],

    "entityPredictions": [

        {

            "id": "cb403a63-347c-448c-9b08-3e48d6ac0c61",

            "entityName": "Keyword",

            "startTokenIndex": 14,

            "endTokenIndex": 15,

            "phrase": "網 址",

            "entityType": 1        },

        {

            "id": "cb403a63-347c-448c-9b08-3e48d6ac0c61",

            "entityName": "Keyword",

            "startTokenIndex": 16,

            "endTokenIndex": 17,

            "phrase": "識 別",

            "entityType": 1        },

        {

            "id": "1771cbab-fb7b-4a83-b46d-4c085ba88341",

            "entityName": "Action",

            "startTokenIndex": 0,

            "endTokenIndex": 1,

            "phrase": "下 載",

            "entityType": 1        }

    ],

    "tokenMetadata": null}

預設 call 正式 api 時，會 log 查詢的資料，最近幾筆資料可以從「 Review endpoint utterances 」看到，如下