怎麽安裝luis-apis

這是一隻用node js寫的CLI工具，因此安裝方式就是透過npm來裝：npm install -g luis-apis

設定luis-apis

裝好了之後，需要做一些設定告知用的key等等，因此可以輸入：luis init

這個時候會用問答的方式建立出一個.luisrc檔案

一開始詢問的Authorization key，可以從右上角，點名字之後裡面的settings看到：

使用luis-apis

所有的指令結構都是：luis {動作} {功能}

1. {動作} 指的是 新增(add)、刪除(delete)、修改(update)和列表(list) - 這邊列的是幾個常見的，還有其他可以用
2. {功能} 指的是這個動作對什麽resource有起作用，例如 app、intent、entity等

舉例來説，如果要列出所有的apps可以透過輸入：luis list apps：

指令太多了，我這邊不會在往更深入的介紹，如果有興趣直接參考官方文件比較快：https://github.com/Microsoft/Bot Builder SDK-tools/tree/master/LUIS

安裝LUDown

LUDown也是用node js寫的，因此安裝透過npm：npm i -g ludown

安裝好了之後可以直接輸入ludown試試看有沒有找到。

建立.lu檔案

假設今天要建立一個從無到有的Model，那麽會從定義.lu檔案開始

如果有寫過markdown的話，那麽非常容易上手，舉例來説，假設今天要定義一個查找的intent，那麽可能定義如下：

# SearchHotel
- 查 {place=飯店}
- 找 {place=郵局}

上面這些内容總共定義出了 1個intent 叫做 SearchHotel，2個 Utterance，并且在這兩個 utterance各定義了entity place。

所以：

1. # 定義的是intent
2. - 定義的是每一個intent裡面的utterance
3. {entityName=value} - 這個則是定義entity名稱以及在這段utterance裡面的值

.lu檔案變成JSON model

.lu檔案是給人看的，而LUIS要看的是JSON model檔案，因此這個時候LUDown就出來了。

透過ludown的parse指令即可，整個參數是：ludown parse toluis -l <folder with .lu files> [-s -o <outputfolder> -n <luisAppName> --verbose -c <luisAppCulture>]

舉例來説：ludown parse toluis -l .\

會把目前資料夾下面 *.lu 轉換成爲 1 個 JSON Model。因此如果model很大，可以拆成1個intent對應1個檔案，這樣既好管理，在發佈又不會有問題。

把JSON Model發佈到luis.ai

有了JSON Model之後，下一步就是把這個Model部署到luis.ai上面。

部署上去有兩種做法：

1. 透過web 界面（上篇有介紹過）
2. 透過 luis-apis的CLI工具

使用luis-apis非常的簡單，只需要透過指令：luis import application --in LUISApp.json即可。

把JSON Model轉換回.lu檔案

當把.lu檔案轉換成爲JSON Model并且部署上去了之後，很有可能一般使用者會直接透過luis.ai來更新model，那這樣兩邊不就不一致了嗎？

LUDown有考慮到這個問題，因此可以透過上一篇提到的把現行JSON Model匯出來之後，透過refresh指令把JSON Model變成.lu檔案。

指令很簡單：ludown refresh -i export.json

這個時候變成了.lu檔案之後，直接commit就更新了最新的設定到版控。