以下紀錄了實際操作Wit.ai相關心得及操作，並延伸至nodejs api應用面，註冊及基本使用方式可以參考至https://wit.ai/docs/quickstart，以下針對重點紀錄：

實體(Entity)

所謂Entity指的是實體物件中組成的類別，也就是會將相同類型的物件歸屬於相同類別，例如說User是一個實體而User中的username、password則為該實體之下的相關屬性(attribute)，wit.ai中對話意圖也可以當成一個實體來使用。

Wit.ai中將實體(Entity)分為三大類，也就是說我們希望Wit.ai利用這三大類怎麼從句子中找出Entity：

  • 特性(Trait)： 以整個句子來獲得實體，例如： [今天是禮拜一嗎?], 這個句子我們可能定義一個intent為yes_or_no其中集合只有['yes', 'no']這兩種特定集合, 也就是根據這個句子來獲得yes_or_no這個實體中的yes、no。
  • 關鍵詞(Keywords)： 需完全符合預先設定的關鍵字才會觸發，如下圖中從禮拜一我要去爬山中擷取爬山並歸類為spot。 Keywords
  • 自由本文(Free Text): 擷取句子中某段文字，只要符合就能夠被觸發，如下圖中從禮拜一我要去爬山中擷取要去爬山並歸類為schedule，而wit.ai中Free Text需搭配Keywords一起使用。 Free Text

特性(Trait)與其他兩種是不相容的，而關鍵詞與自由本文則可相容，也就是說一個實體可以為關鍵詞與自由本文兩種類別。

故事(Stories)

一個故事模擬使用者發問後的某個情境流程，我們可以看到頁面中有四個功能分別為：

  • User says: 這裡表示User可能會說的話並設定Entity來標示使用者有哪些關鍵字、哪段文字代表什麼意義。
  • Bot sends: bot回應的訊息內容，其中可以User輸入的關鍵字回應，或者透過呼叫外部API的方式來完成User的需求。
  • Bot executes: 讓我們定義Bot要執行的function，這裡僅定義名稱，實作則透過API，以下會使用Nodejs當範例。
  • Jump: 當滿足了某些條件下，可以跳至某個Bot executes或Bot sends。

實際定義一個簡單回覆訊息的User story

Story1

使用Bot executes

假如一個Bot只是單純回應User的輸入無法處理事情的話，那麼就失去了設計Bot的意義了，所以我們可以使用Bot executes來讓Bot幫我們執行一些事情， 這裡我們設定一個function setSchedult以及輸出的參數在這邊我們並不實作它。

Executes

設定完成後記得訓練一次，讓機器人知道要以剛剛設定的scheduleResult當作回覆，讓機器人記住這個context。

Context key

使用Nodejs API來實作executes function

流程中我們會記錄使用者輸入的日期、地點、運動種類，因此我們需要針對這些操作分別設計Bot executes。 Executes full

首先我們先從Settings > API Details > Server Access Token 取得token

接著我們直接建構一個簡單的專案來實作Bot executes相關的function

主要依賴套件為node-wit, npm install node-wit

basic.js

引入相關套件及定義Bot actions及token的取得方式(這邊先由終端機命令參數中獲取之後可以改為環境變數讀取來實現)。

這裡主要簡單的示範如何辨識user的關鍵字進行相對應的fuction, 並非完整的一個實際案例, 藉由入門可以設計出更多的story情境及後端API讓其他媒體串接(網站、fb、line…)。

'use strict';

const Wit = require('node-wit').Wit;
const interactive = require('node-wit').interactive;
let date,
    locate,
    sport
const accessToken = (() => {
   if (process.argv.length !== 3) {
      console.log('usage: node basic.js <wit-access-token>');
      process.exit(1);
   }
   return process.argv[2];
})();

const firstEntityValue = (entities, entity) => {
   const val = entities && entities[entity] &&
      Array.isArray(entities[entity]) &&
      entities[entity].length > 0 &&
      entities[entity][0].value
      ;
   if (!val) {
      return null;
   }
   return typeof val === 'object' ? val.value : val;
};

const actions = {
   send(request, response) {
      const { sessionId, context, entities } = request;
      const { text, quickreplies } = response;
      return new Promise((resolve) => {
         console.log('sending...', JSON.stringify(response));
         return resolve();
      })
   },
   setDate({ context, entities}) {
      date = firstEntityValue(entities, 'date');
      console.log(date);
   },
   setLocate({ context, entities}) {
      locate = firstEntityValue(entities, 'locate');
      console.log(locate);
   },
   setSport({ context, entities}) {
      sport = firstEntityValue(entities, 'sports');
      console.log(sport);
   },
   getSchedule({ context }) {
      return new Promise((resolve, reject) => {
         context.scheduleResult = `您的行程安排如下\n日期: ${date}\n地點: ${locate}\n${sport}`; // we should call a real API here - See more at: http://blog.techbridge.cc/2016/07/02/ChatBot-with-Wit/#sthash.oPdsTDNV.dpuf
         return resolve(context);
      });
   }
};

初始化與互動的設置

const client = new Wit({ accessToken, actions });
interactive(client);

最後實際來跑一次範例

Demo