當季食材小幫手 Ingredient Bot

當季食材小幫手 (Ingredient Bot) 是一個 Discord 機器人，它透過 NLU 引擎 Loki 理解說話者的意圖，進而解答人們對料理食材的疑惑。

小幫手知道以下這些食材知識：

小幫手知道的食材知識	問法舉例
所有的當季食材種類	我想知道三月的當季食材有哪些
確認特定食材是否當季	空心菜是當季的嗎？
食材的挑選方法	西瓜怎麼挑？
食材的價格	筊白筍現在多少錢？
食材相關的禁忌	蝦子有什麼禁忌？
食材相關的料理	鮭魚怎麼料理？
食材的產季	螃蟹的產季是幾月？

你能夠與它進行多輪對話 (Multi-Session Conversation)，以獲得你想知道的食材資訊。

NOTE: 如果你在對話時不知道或忘記了小幫手知道的食材知識，你可以問問看他例如：「你知道什麼」，小幫手就會回答你囉。

Demo

NOTE: 用 @ 標註機器人，它才會回覆你哦。

檔案總覽

.
├── ingredient_bot.py  # main program，執行以啟動 bot，處理與 discord 間的互動
├── Loki.py            # 主要使用到 function runLoki 
├── model.py           # NLU model 以及相關的 function
├── Demo.gif           # Demo 影片
├── README.md
├── requirements.txt
│  
├─ info 
│  ├── ingredient.json # 紀錄每個月份的當季食材
│  └── inSeason.json   # 紀錄每個食材的作法、挑法與禁忌
│      
├─ intent # 所有的 intent 都放在這邊
│  ├── Loki_all_ingre.py
│  ├── Loki_capability.py
│  ├── Loki_CheckInSeason.py
│  ├── Loki_InSeason.py
│  ├── Loki_price.py
│  ├── Loki_recipe.py
│  ├── Loki_recommend.py
│  ├── Loki_reject.py
│  ├── Loki_selection.py
│  ├── Loki_taboo.py
│  ├── Loki_which_season.py
│  ├── Updater.py
│  └── USER_DEFINED.json
│          
└─ ref # 啟用 Loki 服務時，需要將裡面所有的檔案匯入 Loki project 中
   ├── all_ingre.ref
   ├── capability.ref
   ├── CheckInSeason.ref
   ├── InSeason.ref
   ├── price.ref
   ├── recipe.ref
   ├── recommend.ref
   ├── reject.ref
   ├── selection.ref
   ├── taboo.ref
   └── which_season.ref

設置環境

• 環境需求
  • Python 3.6 or above
  • pip or pip3 is installed
• 安裝相關套件
  • 執行指令：$ pip install -r requirements.txt

建立 Discord Bot

1. 進入 Discord Developer 後登入Discord帳號
2. 點擊右上角的 New Application，在 Name 的欄位中輸入機器人名稱
3. 新增一個 Bot，在 BOT PERMISSIONS 的欄位勾選 Sends Messages、Embed Links、Attach Files 及 Read Message History
4. 將 Bot 加入伺服器
5. 將複製下來的 token 貼上到檔案 account.info 中

{
    "username" : "  ",
    "apikey_ing" : "  ",
    "discord_token": "***將Token貼在這邊***"
}

啟用 Loki 服務

1. 登入後進入 Loki 控制台
2. 輸入專案名稱，點選 建立專案
3. 點選剛建立完成的專案名稱以進入專案
4. 點選 選擇檔案 > 選擇所有 ref 內的檔案 > 點選 讀取意圖
5. 點選左上角房子圖示，回到 Loki 控制台，點選 複製 專案金鑰
6. 將複製下來的金鑰貼上到檔案 account.info 中：

{
    "username" : " ***輸入USERNAME(註冊信箱)*** ",
    "apikey_ing" : " ***將專案金鑰貼到這裡*** ",
    "discord_token": ""
}

啟動 Ingredient Bot

• 執行指令：$ python ingredient_bot.py

引用資料

• icook
• Cookpad
• 台北農產運銷股份有限公司
• 農業知識入口網
• 美食天下
• 台灣盛產當季蔬菜、水果、海鮮有哪些？整理1月到12月份時令食物清單

參考文件

卓騰語言科技產品說明文件

聯絡資訊

若您還有其他任何的疑問，或是對 Loki 與食材相關的問題有興趣

歡迎透過E-mail聯繫，謝謝

Joe Huang：joehuangx@gmail.com

Lisi Yang：lisi16810@gmail.com