Wit.aiのQuickstartを日本語で要約

# wit.aiで音声認識

[Wit.ai](https://wit.ai/)の[Quickstart](https://wit.ai/docs/console/quickstart)の日本語版要約です.



## 実行環境

* ホストOS : Windows8.1
* ゲストOS : Ubuntu14.04
* ブラウザ : Google Chrome



## 事前準備

* GitHubアカウントの作成



## Witへのログイン

1. [https://wit.ai](https://wit.ai/)にアクセスします.
![welcome.png](https://qiita-image-store.s3.amazonaws.com/0/95686/c5479c97-2616-55bd-f265-b4baffe128e3.png)

2. Login with GitHubをクリックして認証を行います.

3. Wit Console画面に移ったら成功です.
![console.png](https://qiita-image-store.s3.amazonaws.com/0/95686/40ae3df9-03d5-811e-cd02-a4a72b0f20af.png)



## アプリケーションを追加する

新しくアプリケーションを作成します.

1. New App(画面右上の+マーク)をクリックします.
![new_app.png](https://qiita-image-store.s3.amazonaws.com/0/95686/2e373bef-5c8a-23d2-d9ef-1dda0f707b2f.png)

2. アプリケーションの設定を行います.
![create_a_new_app.png](https://qiita-image-store.s3.amazonaws.com/0/95686/ae943362-4203-c7d7-3c52-313b1acec7c8.png)
 - App Nameにアプリケーションの名前を入力します.
 - App Descriptionにアプリケーションの概要を入力します.
 - 言語設定を指定します.
 - データの公開範囲を指定します.

3. Create Appをクリックします.

4. Welcome to your new __Wit__ app が表示されていれば成功です.
![welcome_to_your_new_wit_app.png](https://qiita-image-store.s3.amazonaws.com/0/95686/d6379aa3-7bef-0c95-1888-e3a9a8921ad9.png)



## intentを追加する

intentはアプリケーションが認識する対象です.

1. アプリケーションに認識させたい文を入力します.
![example.png](https://qiita-image-store.s3.amazonaws.com/0/95686/112d5561-2b10-2d05-aadd-686bc9aec68a.png)

2. 例えば _time_ と入力すると, Witコミュニティーに既に存在するtimeに関連したintentが見られます. 趣旨にあったものがあれば, その右にある GET ボタンを押すことでintentの追加ができます.

3. 自分でintentを作成する場合, 画面を下にスクロールし, 入力フォームに以下を入力します.
![get_time.png](https://qiita-image-store.s3.amazonaws.com/0/95686/b190777c-10c8-f3a3-5224-edd79b5e5db5.png)
 - 作成するintentの名前を入力します.
 - Witに認識させたい文（１つ以上）を入力します.

4. ADD ボタンをクリックします.

これで１つ目のintentができました.



## Client Access Tokenを取得する

この時点ですでにWit.ai.APIを使って音声認識を行う準備はできています.
アプリケーションにアクセスするためのトークンを取得しましょう.

1. アプリケーションの管理画面からSettingsを開きます.
![setting_start.png](https://qiita-image-store.s3.amazonaws.com/0/95686/e7b10b74-d384-b3a8-6d08-0c2bd72db813.png)

2. API Detailsの中に_Client Access Token_の項目があることを確認します.
![client_access_token.png](https://qiita-image-store.s3.amazonaws.com/0/95686/1257bcce-f558-e8b2-2b15-4016e1ec4b0d.png)

3. そのテキストボックスの右にある_Reset token_ボタンをクリックすると, Client Access Tokenが得られます.



## サンプルを使って音声認識のテストをする

音声認識行えるかチェックします.
こちらの[サンプルページ](https://labs.wit.ai/speech/index.html)を用いてテストを行います.
![sample_page.png](https://qiita-image-store.s3.amazonaws.com/0/95686/6f36acb1-a24b-64a0-1241-eb2b49a4c9d0.png)

0. サンプルページからのアクセスを許可するために, SettingsのAPI Detailsの中にある_Allowed domains_の項目に labs.wit.ai を追加します.

1. サンプルページ上部にあるテキストボックスに先ほど取得したClient Access Tokenを入力し, saveボタンをクリックします.

2. マイク入力について警告が出るので許可します.

3. マイクのアイコンをクリックし, 何か発話してみましょう.

4. 発話が終わったら, 再びマイクのアイコンをクリックします.

5. メッセージが表示され, "msg_body"の中に発話した内容が入っていれば成功です.
![example_speech.png](https://qiita-image-store.s3.amazonaws.com/0/95686/aafedb05-c8e1-ef46-8b54-799904a66e5d.png)



## Inboxにある文をintentに追加する

Inboxのメニューを開くと, 先ほどサンプルページで認識された発話がリスト化されています. 
その中に, あるintentに対して有効化したい文があれば, intentのプルダウンメニューからそのintentを指定し, Validateボタンを押すことで有効化されます.



## 更にintentを追加する

Intentsのメニューを開くとそのアプリケーションのintentの一覧が見られます.
![intents.png](https://qiita-image-store.s3.amazonaws.com/0/95686/397f5f8c-de01-b6d2-2339-48e0b20c39c6.png)

新たにintentを追加するときは, _Type an intent name to search or create..._ の部分に追加したいintentの名前を打ち込んで作成するか,
_Explore in the community_ボタンから既に存在するintentを検索することができます.