BELってどこの国…？

ワールドカップ2018、とうとう終わってしまいました。個人的にはベルギー優勝！という予想でしたが、皆様の予想はいかがでしたでしょうか。

こういった国際大会を見ていると、国名がアルファベットの略記で表示されます。日本であればJPNのような。ワールドカップくらいの参加国数であれば推測できるのですが、他の大会、オリンピックともなると参加国も多数となり、「これどこの国だっけ？」とわからなくなります。
これは…Google Homeに「BELってどこの国？」と聞くと教えてくれる機能があれば便利そうだ！

というのが建前で、Dialogflowを使ってGoogle Homeの機能拡張をやったことがなかったので、ちょうどいい題材見つけた！という次第です。なので中身はほぼチュートリアル。

2018/07/19現在、少し前にDialogflowのv2が正式リリースされたからか、UIが変わって、いろいろな記事を見ても微妙に言葉遣いが違っておりました。そういった苦労をしたこともあり、今回の投稿のモチベーションにもなっています…。

大まかな流れ

Actions on GoogleとDialogflowの２つのサービスで構築します。
1. [Actions on Google] Actions on Googleにプロジェクト作成
2. [Actions on Google] Actionを作成
3. [Dialogflow] Intentで問い合わせの文言を定義
4. [Dialogflow] Entityで対応する国名コードを定義
5. [Dialogflow] Fulfillmentで国名コードに対応する国名を検索して返信
6. [Dialogflow] テスト
7. 完成！Google Homeに遊んでもらう

リリースまではしてないです。あくまで個人利用。

[Actions on Google] Actions on Googleにプロジェクト作成

プロジェクトを作成

Actions on GoogleのACTIONS CONSOLEが全てのスタートです。

Add/import projectからプロジェクトを作成します。言語、国とかお好きなものを。見かけた記事だと、以前は、言語とか国はもうちょっと後っぽかったんですが、今はこの段階で設定できます。

カテゴリの決定

このプロジェクトはどんなカテゴリか決めるらしいです。お好きなものを。スキップも可。リリースしないなら何選んでも問題ないと思ってます。

Displaynameの決定

次にこのサービスを起動するためのDisplay name（＝起動ワードって理解です）を設定します。

「Decide〜」をクリックすると設定画面に飛びます。

声も決められます。MaleとFemale、それぞれ1,2。Display nameは発音を確認できるのに、Assistantの声は確認できず…

[Actions on Google] Actionを作成

次にActionを作成するらしいです。このあたりもUIが変わったみたいですね。

左のBuildの下のActionsから...

ADD YOUR FIRST ACTION。

そしてCustom intentを選んでBUILD！

これでこのプロジェクトに紐付いたDialogflowのagentの作成画面に移動します。
次からはDialogflowでの作業になります。

[Dialogflow] Intentで問い合わせの文言を定義

最初に言語してagentを生成。

今回作成するIntentは全部で4種類。

Welcome Intent：起動したときにしゃべるメッセージ等
Fallback Intent：合致するIntentが見つからない場合の処理
本体：実施したい処理。今回はここに国名コードを検索して国を返すロジックを組みます。名前は「searchcode」にしました。この名前自体に意味はないですが、以降の説明でsearchcodeと出てきたら本体のIntentと読み替えてください。
終了：接続を切る処理。

1,3,4は2ができれば簡単なので、説明は2にしぼります。

ちなみにIntentはドキュメントによると↓。

An intent represents a mapping between what a user says and what action should be taken by your software.

Intentの作成

左のメニューからIntentsを選んでCREATE INTENT。

画面の一番上にIntentの名前を設定できる箇所があるのでsearchcodeと設定。個人的にはちょっとわかりにくかった…SAVEボタンも上にあって少し探したりしました。

Training phrases

Google Homeへの問い合わせに使う文言を定義します。
これがUIが変わってつまづいたところです。見かけた記事によると「USER SAYS」って前は言ってたみたいですね。

Add user expressionに文言を入力してENTER。

そうすると、本体動作（Fulfillment）への入力となるパラメータが、その文言のどこかを定義するところが表示されます。今回はJPの部分。ここのJPはただの例みたいなものらしく、別になんでもよさそうです。ここに入る値はEntityで定義するようです。

問い合わせの文言は複数登録できますのでお好みで。

Action and parameters

Training phrasesのすぐ下。Fulfillmentへの入力となるパラメータの定義です。といっても上で定義したら自動で追加されてます。必要に応じてRequireとか設定するとよさそうです。
ちなみにここでもひっかかりました。ActionというのがActions on GoogleのActionと混同して、説明がどっちを指してるのか混乱しました。

ResponsesとFulfillment

このIntentの動作とその結果を定義します。Fulfillmentの中身を定義するわけではなく、このIntentが動くとFulfillmentを起動しますよ〜という設定です。通常処理はFulfillmentで完結するため、Responseは基本使われない模様。Fulfillmentがコケたときにこのメッセージが読まれるみたいです。

ちなみにWelcome、FalloutのIntentはコメントを返すだけならTraining等々はいらず、Responseだけ設定すれば動きます。
終了のIntentは、Training Phraseに終了するためのキーワード（例えばありがとう）と、その応答Response（例えばyour welcome）を登録して、Resonsesの下の「Set this intent as end of conversation」を有効にするだけです。

[Dialogflow] Entityで対応する国名コードを定義

Entityはドキュメントによると↓。

Entities are powerful tools used for extracting parameter values from natural language inputs. Any important data you want to get from a user's request, will have a corresponding entity.

パラメータに入る可能性のあるものを定義して、言い回しの違いを吸収するための設定と理解してます。今回、パラメータに入るのは国名コード。しかし、それを全部手打ちするのはつらい。CSVのアップロードで一括登録できるらしいので、Wikipediaの表をちょちょいとCSVに加工。国名コードってISOらしいんですよ、ご存知でした？？？

ファイル名がそのままEntityが対応するパラメータの名前になりますので、今回はcountrycode.csvとして↓のようなファイルを作成。1列目がパラメータにわたす値、2,3列目が言い回しの種類。今回は2文字、3文字に対応してみました。

これを右上のメニュー「Upload Entity」からアップロードすると…

こんな感じに一括登録できます。楽ちん。

[Dialogflow] Fulfillmentで国名コードに対応する国名を検索して返信

ここまでの設定で、Google Homeから「JPNってどこ？」と問い合わせると、JPNが本体動作：Fulfillmentに届くようになりました。次は本体動作の作成です。

左のメニューからFulfillmentを選んで、今回はInline Editor（JavaScript）を使いました。

ちなみにInline Editorで作成したコードは、FirebaseのFunctionsに自動登録されます。便利。

Inline Editorにはデフォルトの処理が既に入っているので、大枠はそれをそのまま利用します。

今回書き換えるのはyourFunctionHandler（~~処理は一つだけですし、めんどくさいので名前はデフォルトのまま...~~）。

今回は国名コード→国の名前を調べることですので、国名コードの連想配列にしてみました。
これまたWikipediaの表をちょちょいと加工してこんな記述に。地域もついでに。

そして連想配列から国名と地域を抜き出して、Google Homeに送り返す処理です。

なんか小賢しいことをいろいろやっていますが重要なのはagent.add()でGoogle Homeを喋らせられるということだけです。


agent.add(vcode + "は" + db[code].name + "、" + db[code].area + "です。");

最後にこの関数とIntentを結びつければおしまいです。yourFunctionHandlerのところをコメントアウトして、第一引数に本体処理のIntentの名前を書けばOKです。

最後にDEPLOY。結構時間がかかるので、慎重にやったほうがいいです。

[Dialogflow] テスト

これで設定はおしまいなのであとは挙動確認。
Dialogflowの右上の「Try it now」に「JPNってどこ？」と放り込んでやると...

JPNは日本、東アジアです。おお、そのとおり。INTENTを見ると、意図通り紐づけたINTENTが起動しています。
アマゾン川がどこにあるかわからず、中学時代に社会科の先生に笑われた地理雑魚勢なので地域も重要。今回のワールドカップもセネガルとセルビアは一瞬ウン？となりました。

ちなみにJPNが少し横にふくらんでいるのは、スペース入れて文字と文字を区切っているからです。ひっついていると英単語として読まれてしまった…

なお、プログラムがコケるとResponseに設定した文言が返されます。
その原因を探るには、このFulfillmentが動作しているFirebaseに出力されているログが役立ちます
DEPLOYの左にある「View execution logs〜」からその画面にジャンプできます。

エラーだとこんなの。このときはタイポ。お恥ずかしい限り。

ちなみにFulfillment自体見つからないときはFalloutのintentが動作します。Fallout Intentと、本体動作IntentのResponseで別の文言を指定しておくと、どっちでミスってるのかわかりやすくなります。

このログ、Request bodyというところでFulfillmentで使えるrequestの中身を見ることができたりします。便利。

完成！Google Homeに遊んでもらう

これで準備OK。あとは、このActions on Googleを作ったアカウントに紐づけたGoogle Homeに、
1. ねぇ Google
2. カントリーコードにつないで　→　Welcom Intentが起動
3. BELってどこ？ →　本体のIntentが起動
※問い合わせは連続で実行可能。ここがGoogle Home単体よりいいところ。
4. ありがとう　→　終了のIntentが起動

という感じで遊べます。

Google on Actionsにシミュレータがありますので、そちらでも遊べます。左のSimulatorからどうぞ。2文字でもちゃんと答えてくれます。RとLですごい違い…という例にしようと思いましたが、わりと近かった。

おわりに

ここまでで、Google Homeで問いかけ →　自分で作ったプログラムで処理　→　結果をGoogle Homeに返す、というサービスの基本形ができました。Fulfillmentは直接APIを叩くこともできるみたいです。そこまでこれば通常のAPI開発になりますので、一気にできることが増えそうです。振り返ってみればほとんどコード書いてない。すごいな〜

アイデア一発の国名コード検索でしたが、Actions on Google、Dialogflowのチュートリアルとしては楽しい題材という感想でした。

なお、この記事は、2018/07/19現在のUIを基に作成しています。今後の更新でUIは変わっていくはずですのでご注意を…

ちなみにオリンピックで使われるのはIOCが定義したIOCコードなのでISOの国名コードでは見つからない国もあります。
ドイツはDEU…これはわからない。 Deutschlandが由来らしいですが。

たしか日本の「ドイツ」って呼び方はこっち由来なんでしたっけ？

IOCのコードは3文字の一種類しかないため、あたかもEntityの説明用にわざわざISOのコードを使ったみたいですが、素で気づいてなかったです。ドイツが見つからないなー　→　もしかしてオリンピックってISOコード使ってない？と検索したら発覚したという。結果オーライ。

…CSVと連想配列作り直さなきゃ。