このページは Cloud Translation API によって翻訳されました。

ハンズオン: Women in Voice ワークショップ

1. はじめに

このラボでは、Dialogflow を使用してシンプルなアクションを作成し、Google アシスタントと統合する方法を学びます。

ここでは、一般的なクラウド開発プロセスの手順に沿って以下の順序で演習を進めます。

Dialogflow v2 エージェントを作成する
エンティティを作成する
インテントを作成する
GCP Cloud Functions を使用して Webhook を設定する
ナレッジベースを使用してよくある質問をインポートする
chatbot をテストする
Google アシスタントの統合を有効にする

作業内容

Women in Voice ミートアップグループ向けの Google アシスタントアプリを作成します。次回の交流会の日程、記事、予約のヒントやグループに関する一般的な質問。

学習内容

Dialogflow v2 を使用して chatbot を作成する方法
Dialogflow で直線的な会話を作成する方法
エンティティの使用方法
ナレッジベースの活用方法
Dialogflow と GCP の関数を使用して Webhook フルフィルメントを設定する方法
Actions on Google を使用してアプリケーションを Google アシスタントに取り込む方法

前提条件

Dialogflow エージェントを作成するには、Google ID または Gmail アドレスが必要です。
GCP Cloud Functions の使用に対する GCP クラウドクレジットを提供いたします
エージェントのデータを取得するには、一般公開されている Google スプレッドシートにアクセスする必要があります。
新しいタブで開きます。https://docs.google.com/spreadsheets/d/1UWx3WYVCrqz0D4uJ_pO56WeqEPa9rQDG1cfc_H11kgY/edit?usp=sharing
JavaScript の基本的な知識は必要ありませんが、Webhook フルフィルメントコードを変更する場合に役立ちます。

2. 設定方法

ブラウザでウェブアクティビティを有効にする

http://myaccount.google.com/activitycontrols をクリックします。

ウェブと[アプリのアクティビティ] が [有効] になっている場合:

Dialogflow エージェントを作成する

https://console.dialogflow.com を開きます。

左側のバーのロゴの下にある [Create New Agent] を選択します。既存のエージェントがいる場合は、まずプルダウンをクリックします。

エージェント名を指定: yourname-wiv（独自の名前を使用）
デフォルトの言語として [English - en] を選択します。
デフォルトのタイムゾーンとして、最も近いタイムゾーンを選択します。
[Mega Agent] は選択しないでください。（この機能を使用すると、「サブ」エージェント間のオーケストレーションが可能な包括的なエージェントを作成できます。今は必要ありません）。
[作成] をクリックします。

Dialogflow を構成する

左側のメニューで、プロジェクト名の横にある歯車アイコンをクリックします。

エージェントの説明として「音声エージェントの女性」と入力します。
[ベータ版の機能] まで下にスクロールし、スイッチを切り替えてベータ版の機能を有効にします。
[Log Settings] まで下にスクロールし、両方のスイッチを切り替えて、[Dialogflow のインタラクションをログに記録] と [Google Cloud Stackdriver のすべてのインタラクションをログに記録] をオンにします。これは、後でアクションをデバッグする場合に必要になります。

[保存] をクリックします。
[完了] をクリックします

Actions on Google を設定する

右側のパネルの [Google アシスタントでの動作を確認] にある [Google アシスタント] のリンクをクリックします。

http://console.actions.google.com を開きます。

注: Dialogflow と同じ Google アカウントでログインしていることを確認してください。

Actions on Google を初めて使用する場合は、まずこちらのフォームに入力する必要があります。

プロジェクト名をクリックして、シミュレーターでアクションを開いてみてください。**
メニューバーで [Develop] を選択します。

[ユーザーの言語設定と一致させる] チェックボックスをオフにします。テキスト読み上げの音声合成機能が、アシスタントのデフォルト言語によってオーバーライドされないようにします。

[保存] をクリックします。
メニューバーの [テスト] を選択します。

シミュレータが [English] に設定されていることを確認して、[Talk to my test-app] をクリックします。

このアクションにより、Dialogflow の基本的なデフォルトインテントが表示されます。つまり、Action on Google との統合の設定がうまくいったということです。

Google Cloud を構成する

このチュートリアルでは、請求先アカウントが関連付けられた GCP アカウントが必要です。アカウントをお持ちでない場合は、以下の手順で作成できます。

通常、請求先アカウントにはクレジットカードなどのお支払い方法が必要です。このワークショップでは、ワークショップクレジットをご利用いただけますが、その場合はこのプロセスを省略できます。

この URL に移動してログインします

gcpcredits.com/wivnl

こちらをクリックしてクレジットにアクセスするをクリックします。
[同意して続行

これで準備完了です。25 ドルの請求先アカウントを作成しました。Cloud Functions を長期間使用するにはこれで十分です。

Google Sheets API を有効にする

エージェントが静的なインテントレスポンス以上のものを必要とする場合（ウェブサービス、データベース、スプレッドシートからデータを取得する場合など）、フルフィルメントを使用してウェブサービスをエージェントに接続する必要があります。ウェブサービスを接続すると、ユーザーの式に基づいてアクションを実行し、動的なレスポンスをユーザーに返すことができます。

たとえば、ユーザーがブログや本のヒントを受け取りたい場合、ウェブサービスがデータベースをチェックし、ユーザーに記事を返すことができます。

このチュートリアルでは、データベースを使用せず、代わりに Google スプレッドシートを使用します。シートが更新されると、Google アシスタントのアクションも更新されます。使用できます。

この Google スプレッドシートを新しいブラウザタブで開きます（まだ開いていない場合）。
https://docs.google.com/spreadsheets/d/1UWx3WYVCrqz0D4uJ_pO56WeqEPa9rQDG1cfc_H11kgY/edit#gid=1240329448
重要: このシートのコピーを作成してください。[ファイル] >コピーを作成
シートがコピーされたら、[共有] をクリックします。
Dialogflow サービスアカウントに編集権限を付与する必要があります。これを行うには、Dialogflow >設定（歯車）
[Google Project] まで下にスクロールします。
サービスアカウント（メールアドレス）のアドレスをコピーします。次のようになります: dialogflow-<someid>@<my-gcp-project>.iam.gserviceaccount.com

このサービスアカウントを Google スプレッドシートの [Share] ポップアップに貼り付けて、編集権限を付与します。

次に、現在作業しているシート ID を覚えておく必要があります。

    The Sheets URL will look something like this:

https://docs.google.com/spreadsheets/d/1fPd8b_z19U7ZzAaY327QhYoogn6q8c1rpGSNF8KIR_o/edit#gid=1240329448

    But we are only interested in the Sheet id, which is the part between:

https://docs.google.com/spreadsheets/d/ および /edit#gid=1240329448（スラッシュなし）

    So it will look something like this: **1fPd8b_z19U7ZzAaY327QhYoogn6q8c1rpGSNF8KIR_o**

    **Write this Sheet ID down**, or copy it to Notepad. In the Webhook steps we will use this again.

別のブラウザタブで開くhttp://console.cloud.google.com.（他にも Google Cloud プロジェクトがある場合は、新しい Dialogflow プロジェクト yourname-wiv を有効にしてください）。- 検索バーで「Google Sheets API」を検索します。

ここをクリックして、上部の [Google Sheets API を有効にする] ボタンをクリックします。

3. カスタムエンティティ

エンティティとは、アプリやデバイスがアクションを実行するオブジェクトです。パラメータ / 変数と考えることができます。私たちの行動では、以下について尋ねます。

「Google Chat の

chatbot

音声*"*

チャットボット、音声、両方という表現のどれを使用しても、これらはカスタムエンティティから収集され、ウェブサービスへのリクエストでパラメータとして使用されます。

Dialogflow エンティティの詳細については、こちらをご覧ください。

チャネルエンティティの作成

Dialogflow コンソールのメニュー項目 [Entities] をクリックします。
[エンティティを作成] をクリックします。
エンティティ名: tech（すべて小文字にしてください）
オプションと類義語を指定します。（インターフェースは Tab キーで移動できます）。

Chatbots - Chatbots, Chat, Web
Voice - Voice, Voicebots, Voice Assistants
Both - Both, All

5**.**青色の保存ボタンの横にあるメニューボタンをクリックして、[**Raw Edit**] モードに切り替えます。

すべてのエンティティを CSV 形式で入力することもできます。これは、作成する必要があるエンティティが多い場合に役立ちます。

"Chatbots","Chatbots","Chat","Web"
"Voice","Voice","Voicebots","Voice Assistants"
"Both","Both","All"

[保存] をクリックします。

4. インテント

Dialogflow は、インテントを使用してユーザーの意図を分類します。インテントにはトレーニングフレーズが含まれます。トレーニングフレーズとは、ユーザーがエージェントに話しかける可能性のあるフレーズのサンプルです。

たとえば、ユーザーが次の予定を知りたい場合は、次のように質問します。

「次の会合はいつ？」

ユーザーが何かを書いたり話すことを「ユーザー表現」と呼び、Dialogflow はユーザー表現をエージェント内の最適なインテントにマッチングします。インテントのマッチングは「インテント分類」とも呼ばれます。

Dialogflow インテントの詳細については、こちらをご覧ください。

Default Welcome Intent の変更

新しい Dialogflow エージェントを作成すると、2 つのデフォルトインテントが自動的に作成されます。Default Welcome Intent（デフォルトのウェルカムインテント）は、エージェントとの会話を開始したときに最初に表示されるフローです。Default Fallback Intent（デフォルトのフォールバックインテント）は、エージェントがユーザーを理解できない場合や、話した内容とインテントをマッチングできない場合に発生するフローです。

[Intents（インテント）] >Default Welcome Intent（デフォルトのウェルカムインテント）

Google アシスタントの場合は、Default Welcome Intent で自動的に起動します。これは、Dialogflow が Welcome イベントをリッスンしているためです。ただし、入力したトレーニングフレーズのいずれかを言って、インテントを呼び出すこともできます。

以下は、Default Welcome Intent のウェルカムメッセージです。

ユーザー	エージェント
「OK Google, <あなたの名前>-WIV と話して」	「こんにちは。Women in Voice の仮想エージェントの Anna です。」「ミートアップの情報、Women in Voice、読書のヒントについて質問できます。」

[Responses] までスクロールします。
すべての返信テキストをクリアします。
デフォルトタブで、次の 3 つのレスポンスを作成します。（改行ごとに、[Add Responses] > [Text] または [SSML Response] をクリックします）。

こんにちは、Women in Voice の仮想エージェントのアンナです
ミートアップ、Women in Voice、読書のヒントについて質問できます。
確認したい情報

構成はこのスクリーンショットのようになります。

上記の出力は chatbot に使用されており、特に Google アシスタント用に出力を少し変更できます。SSML（音声合成マークアップ言語）を使用して、文章に一時停止を組み込んでいきます。[Google Assistant] タブをクリックします。

このチャットボットメッセージは再利用されないため、[デフォルト] の切り替えは有効にしないでください。
[回答を追加 >シンプルなレスポンス
次のテキストバージョンを追加します。

Hey there, I'm Anna, the virtual agent of Women in Voice.

You can ask me for information about meetups, Women in Voice or a reading tip. What would you like to know?

[音声出力をカスタマイズ] をクリックします。
次の SSML バージョンを追加します。

<speak><p><s>Hey there, I'm Anna, the virtual agent of Women in Voice.</s><s>

You can ask me for information about meetups, Women in Voice or a reading tip.</s></p><break time="500ms"/><p><s> What would you like to know?</s></p></speak>

構成はこのスクリーンショットのようになります。

[保存] をクリックします。

Actions on Google の SSML について詳しくは、こちらをご覧ください。

このインテントをテストしましょう。まず、Dialogflow シミュレータでテストします。

「Hello」と入力します。このメッセージが返されます。

Actions on Google コンソールに戻りましょう

（別のタブで開いたままにしておくことをおすすめします）。

[Talk to my test app] をクリックします。新しいウェルカムメッセージも確認します。

デフォルトのフォールバックインテントの変更

[Intents（インテント）] >デフォルトのフォールバックインテント
[Responses] までスクロールします。
すべての返信テキストをクリアします。
デフォルトタブで、次のレスポンスをそれぞれ改行して作成します。これにより、オプションが交互に切り替わります。

Sorry, can you repeat this?
I didn't understand you. You can ask me questions about Women in Voice, a book or article tip or when the next meetup will be.

[保存] をクリックします。

Google アシスタントの出力を入力しない場合は、デフォルトの出力が使用されます。

停止インテントを作成する

[Intents] メニュー項目をクリックします。
[インテントを作成] をクリックします。
[Intent Name] に、Stop Intent を入力します。
[トレーニングフレーズを追加] をクリックします。

No
That's it
Bye
I don't want that
Goodbye
It's ok for now
Quit
I want to stop
Close this
End the conversation

[Responses] まで下にスクロールします。>レスポンスを追加
次のテキストオプションを追加します。

Alright! Hopefully we will see you at one of our meetups!
No problem. See you at one of our meetups!

スイッチを切り替える: [Set this intent as the end of conversation]。これにより、このインテントが一致すると、Google アシスタントのアクションが終了します。

[保存] をクリックします。

Meetup インテントを作成する

Meetup Intent には、会話の以下の部分が含まれます。

ユーザー	エージェント
「次の会合はいつ？」	「次のミーティングは <日付><time> に場所: <location>。トピックは <topic> です。スピーカーは <speakers> です。ニュースレターからご登録ください。」

[Intents] メニュー項目をクリックします。
[インテントを作成] をクリックします。
[Intent Name] に Meetup Intent を入力します（M と I を必ず大文字で表記します。- インテントの表記が違うと、バックエンドサービスは機能しなくなります）。
[トレーニングフレーズを追加] をクリックします。

When is the next meetup?
Do you have any events?
Which events are in the planning?
Are there meetup events soon?
I would love to attend a meetup
Can I join a virtual meetup?
When will you get together?
Can I join?
What does your calendar look like?

[Fulfillment] >フルフィルメントを有効にする

[Enable Webhook call for this intent] スイッチをオンにします。

[保存] をクリックします。

Tip Intent を作成する

Tip Intent には、会話の以下の部分が含まれます。

ユーザー	エージェント
「読書のヒントが欲しい。」	「chatbot、音声、またはその両方について、もっと読みたいですか？」
"音声"	「はい、こちらが今日のヒントです。<type><title><author> のテーブル。他の書籍や記事のヒントが必要ですか？また、ミートアップや Google の活動についても説明いたします。どのようなご用件でしょうか？」

[Intents] メニュー項目をもう一度クリックします。
[インテントを作成] をクリックします。
インテント名として「Tip Intent」を入力します（L と I を必ず大文字にしてください）。- インテントの表記が違うと、バックエンドサービスは機能しなくなります）。
[トレーニングフレーズを追加] をクリックして、以下の内容を追加します。

Can I get a tip for an article?
I would like to receive a reading tip
Any book tips?
What's nice to read?
I want to learn more about Chatbots, what should I read?
What are nice blogs?
Do you have book suggestions?
I want to receive information about Both
Can I have Chatbots reading tip
I would like to read more about Voice
Voice please
Both are okay.
Reading tip
Tip
Blog
Article
Book
Book suggestions
Yes
Yeah
Another tip
Yes one more

[Action and parameters]（アクションとパラメータ）まで下にスクロールします。
[tech] を [必須] としてマーク

[Define Prompt] をクリックして、次のように入力します。

Do you want to read more about Chatbots, Voice or Both?

[Fulfillment] >フルフィルメントを有効にする

今回はレスポンスをハードコードしません。Cloud Functions の関数からレスポンスが返されます。したがって、[Enable Webhook call for this intent] スイッチをオンにします。

[Fulfillment] >フルフィルメントを有効にする

[Enable Webhook call for this intent] スイッチをオンにします。

[保存] をクリックします。

5. ナレッジコネクタ

ナレッジコネクタは、定義済みのインテントを補完します。ナレッジドキュメントを解析して自動レスポンスを見つけます。（CSV ファイル、オンラインウェブサイト、PDF ファイルなどに含まれるよくある質問や記事など）。ナレッジベースを構成するには、ナレッジベース（ナレッジドキュメントの集合）を 1 つ以上定義します。

ナレッジコネクタの詳細

試してみましょう。

en タグを選択し、上部のメニューで英語を選択します。
メニューから [Knowledge]（ベータ版）を選択します。

右側の青いボタン [Create Knowledge Base] をクリックします。
ナレッジベース名として入力します。[Women in Voice] を選択して [保存] をクリックします。
[Create the first one] リンクをクリックします。

ウィンドウが開きます。

次の構成を使用します。

ドキュメント名: Women in Voice FAQ シート

ナレッジベースの種類: よくある質問

MIME タイプ: CSV

このシートのデータが必要です。データシートが開いていることを確認し、[よくある質問] タブを選択します。
[ファイル >ダウンロード >CSV

Dialogflow に戻り、[Upload File from Computer] をクリックして、ダウンロードした CSV ファイルを選択します。[作成] をクリックします。

ナレッジベースが作成されました。

[レスポンスを追加] をクリックします。

以下の回答を作成して [保存] をクリックします。

$Knowledge.Answer[1]

[詳細を表示] をクリックします。

これにより、Dialogflow に実装した FAQ がすべて表示されます。

簡単！

また、よくある質問が掲載されたオンライン HTML ウェブサイトにリンクして、エージェントによくある質問をインポートすることもできます。テキストブロックを含む PDF をアップロードすることも可能で、Dialogflow 自体が質問を生成します。

Dialogflow メニューの [Knowledge (beta)] をクリックして、すべてのナレッジベースコネクタに戻ります。
ナレッジベースの強みと弱みは変更できます。これは、よくある質問が自身の意図に勝っている、または不得手であると考える場合は理にかなっています。インテントが少ないため、ナレッジベースをもう少し強化しましょう。スケールを -0.2 に変更します。スライダーをドラッグすると、値が自動的に保存されます。

よくある質問は「補足情報」と見なされるようになりました追加することもできます。ナレッジベースに関するよくある質問ではモデルをトレーニングできません。そのため、まったく異なる方法で質問すると、自然言語理解（ML モデル）を活用しないため、適合しない可能性があります。そのため、FAQ をインテントに変換するメリットもあります。

6. Webhook フルフィルメント

Google Cloud Functions の関数を作成する

別のブラウザタブで http://console.cloud.google.com に移動します。
左側のメニューで [Cloud Functions] を選択します。
[関数を作成] をクリックします。

次の構成を指定します。

名前: dialogflow
割り当てられるメモリ: 256 MiB
トリガー: HTTP
URL をクリップボードにコピーします。
[Inline Editor] を選択します。
ランタイム: NodeJS 8
実行する関数: dialogflow

この認証チェックボックスがオンになっていることを確認します。

package.json の内容は次のとおりです。これをコピーして、エディタの package.json タブに貼り付けます。

このコードによって、適切な npm ライブラリが Google Cloud に読み込まれます。

{
 "name": "dialogflow",
 "description": "Cloud Functions",
 "engines": {
   "node": "8"
 },
 "dependencies": {
   "request": "^2.85.0",
   "request-promise": "^4.2.5",
   "dialogflow-fulfillment": "^0.6.1",
   "actions-on-google": "^2.2.0",
   "googleapis": "^48.0.0",
   "moment": "^2.24.0"
 },
 "devDependencies": {
   "eslint": "^5.12.0",
   "eslint-plugin-promise": "^4.0.1",
   "ngrok": "^3.2.7"
 },
 "private": true
}

index.js の内容は次のとおりです。これをコピーして、エディタの index.js タブに貼り付けます。

このコードを googleapis ライブラリと統合して、Google スプレッドシートからデータを取得します。actions-on-google ライブラリを使用して、Google アシスタントデバイスにカードを表示します。ライブラリ dialogflow-fulfillment を使用して、Dialogflow のインテントを分類します。また、ライブラリ moment を利用して日時オブジェクトを処理します。

/* jshint esversion: 8 */
'use strict';

process.env.DEBUG = 'dialogflow:debug';

const ACCOUNTS_SHEET_ID = '1UWx3WYVCrqz0D4uJ_pO56WeqEPa9rQDG1cfc_H11kgY';

const {
 BasicCard,
 Button,
} = require('actions-on-google');

const {google} = require('googleapis');
const moment = require('moment');
moment.locale('nl');
const { WebhookClient } = require('dialogflow-fulfillment');
var books;
var meetups;

const SHEETS_SCOPE = 'https://www.googleapis.com/auth/spreadsheets.readonly';

/**
* Authenticates the Sheets API client for read-only access.
*
* @return {Object} sheets client
*/
async function getSheetsClient() {
   // Should change this to file.only probably
   const auth = await google.auth.getClient({
       scopes: [SHEETS_SCOPE],
   });
   return google.sheets({version: 'v4', auth});
}

/**
* Return a natural spoken date
* @param {string} date in 'YYYY-MM-DD' format
* @returns {string}
*/
var getSpokenDate = function(date){
   let datetime = moment(date, 'YYYY-MM-DD');
   return `${datetime.format('D MMMM')}`;
};


/* When the tipIntent Intent gets invoked.  */
function tipIntent(agent) {
 var par = agent.parameters.tech;
   var selection = [];
   //console.log(par);
   //console.log(books);
    for(var i = 0; i<books.length; i++){
     if(books[i][2].toLowerCase() == par.toLowerCase()) {
         selection.push(books[i]);
       }
   }
    var random = Math.floor(Math.random() * selection.length);
   var booktip = selection[random];
   //console.log(selection[random]);

   let spokenText = `<p><s>Alright, here's the tip of the day!</s></p><p>The ${booktip[6]} ${booktip[0]} of ${booktip[1]}.</p>`;
   let writtenText = `Alright, here's the tip of the day! The ${booktip[6]} ${booktip[0]} of ${booktip[1]}.`;
   //console.log(booktip[8]);
    if (agent.requestSource === agent.ACTIONS_ON_GOOGLE) {
       let conv = agent.conv();
       conv.ask(`<speak>${spokenText}</speak>`);
       conv.ask(new BasicCard({
           title: `Tip of the day!`,
           subtitle: `${par}`,
           text: `The ${booktip[6]} ${booktip[0]} of ${booktip[1]}.`,
           buttons: new Button({
               title: 'Read',
               url: `${booktip[8]}`,
           })
       }));
       conv.ask(`<speak><p><s>Do you want another book or article tip? Also, I can tell you more about meetups or what we do. How can I help?</s></p></speak>`);
       // Add Actions on Google library responses to your agent's response
       agent.add(conv);
   } else {
       agent.add(writtenText + ' Do you want another book or article tip? Also, I can tell you more about meetups or what we do. How can I help?');
   }
}


function meetupIntent(agent) {
 let conv = agent.conv();
 let record;
  console.log(meetups);
  for(var i = 0; i<meetups.length; i++){
   let d = moment(meetups[i][0], 'YYYY-MM-DD');
   let today = moment(new Date());

   if(moment(d).isSameOrAfter(today)) {
     // the i event is not in the past
     record = meetups[i];
     console.log(record);
     break; 
   }
 }
  let date = getSpokenDate(record[0]);
 let spokenText1 = `The next meetup will be ${date} at ${record[1]} in ${record[3]}.`;
 let spokenText2 = `The topic will be <emphasis level="moderate">${record[2]}.</emphasis>`;
 let spokenText3 = `You can register via our newsletter.`;
  let writtenText = `${spokenText1} The topic will be ${record[2]}. ${spokenText3}`;

 if (agent.requestSource === agent.ACTIONS_ON_GOOGLE) {
   conv.ask(`<speak>${spokenText1} ${spokenText2} ${spokenText3}</speak>`);
   conv.ask(new BasicCard({
     title: `Meetup`,
     subtitle: `${record[2]}`,
     text: `${record[0]} ${record[1]} - ${record[3]}`,
     buttons: new Button({
       title: 'Register',
       url: `http://www.meetup.com`
     })
   }));
   conv.ask('<speak><p><s>Is there anything else I can help you with?</s></p></speak>');
   agent.add(conv);
 } else {
   agent.add(`${writtenText} Is there anything else I can help you with?`);
 }
}

exports.dialogflow = async (request, response) => {
 var agent = new WebhookClient({ request, response });

 console.log('Dialogflow Request headers: ' + JSON.stringify(request.headers));
 console.log('Dialogflow Request body: ' + JSON.stringify(request.body));
  const client = await getSheetsClient();   
 const allBooks = await client.spreadsheets.values.get({
   spreadsheetId: ACCOUNTS_SHEET_ID,
   range: 'Books&Blogs!A:I',
 });
 const allEvents = await client.spreadsheets.values.get({
   spreadsheetId: ACCOUNTS_SHEET_ID,
   range: 'Meetups!A:D',
 });
  books = allBooks.data.values;
 meetups = allEvents.data.values;
 books.shift();
 meetups.shift();

 var intentMap = new Map();
 intentMap.set('Tip Intent', tipIntent);
 intentMap.set('Meetup Intent', meetupIntent);
 agent.handleRequest(intentMap);
};

[環境変数、ネットワーキング、タイムアウトなど] リンクをクリックします。

Dialogflow 統合サービスアカウントを選択します。

（デフォルトでは GAE App Engine サービスアカウントを使用しますが、このチュートリアルの最初のステップで Google スプレッドシート内で共有したサービスアカウントと同じサービスアカウントにする必要があります）。

Cloud Functions の関数をデプロイする前に、[index.js] タブのコードの 1 行を変更します。コードの 3 行目は次のとおりです。

const ACCOUNTS_SHEET_ID = '1Yo_E8KONgSiUm00ZmTOqtjXCwULmc2JuI3sjxRyvrkE';

最初の手順の 1 つで、このキーをメモ帳に書き留めました。この ID をコピーしてコードに貼り付けます。

これで準備は完了です。[Create] ボタンをクリックします。サーバーレス関数をデプロイしているため、少し時間がかかります。

Dialogflow でフルフィルメントを有効にする

Dialogflow に戻す
メインメニューで [Fulfillment] をクリックします。
[Webhook] スイッチを有効にします。
クリップボードにコピーされた Cloud Functions の関数の URL を入力します。

例: https://us-central1-leeboonstra-wiv-uhtefa.cloudfunctions.net/dialogflow

[保存] をクリックします。

Webhook をテストしてコードが機能するかどうかを確認し、Dialogflow シミュレータで直接フローをテストします。

7. Actions on Google

Actions on Google は、Google アシスタントの開発プラットフォームです。これにより、サードパーティによる「アクション」（拡張機能を提供する Google アシスタント用のアプレット）の開発が可能になります。

アプリを開くか話しかけて、Google アクションを呼び出す必要があります。

アクションが開き、ボイスが変わります。「native」はそのままにします。Google アシスタントのスコープ。つまり、この時点からエージェントに依頼する内容はすべて、自分で作成する必要があります。自分のアクションで、Google アシスタントに突然 Google の天気情報を尋ねることはできない。まず、現在のアクション（アプリ）の範囲から離れる（閉じる）必要があります。

Google アシスタントシミュレータでアクションをテストする

次の会話をテストしてみましょう。

ユーザー	Google アシスタント
「OK Google, テスト用アプリに話しかけて」	「アプリのテスト版を入手します。」
ユーザー	[自分の名前]-WIV
-	「こんにちは。Women in Voice の仮想エージェントの Anna です。ミートアップ、Women in Voice、読書のヒントについて私に質問できます。どのようなことをお知りになりたいですか？」
ブログに関するヒントを教えてもらえますか？	「chatbot、音声、またはその両方について、もっと読みたいですか？」
chatbot	「はい、こちらが今日のヒントです。The Article Chatbots And The Challenge Of Invisible Affordances of Cobus Greyling.その他の書籍や記事のヒントが必要ですか？また、ミートアップや Google の活動についても説明いたします。どのようなご用件でしょうか？」
次の交流会はいつ？	「次回のイベントは、4 月 29 日の午後 6 時にバーチャルハングアウトで開催されます。トピックは「オンラインワークショップ: Dialogflow で Google アクションを作成する」です。ニュースレターからご登録ください。他に何かご不明な点はございませんか？」
ウェブサイトの URL をご記入ください。	「www.womeninvoice.com からアクセスできます。他に何かご不明な点はございませんか？」
いいえ、結構です	「承知いたしました。イベントでお会いできることを楽しみにしています。」

Google アシスタントシミュレータに戻す

https://console.actions.google.com を開きます。

マイクのアイコンをクリックして、以下の質問をします。

Talk to my test app.

ここで、次の質問をしてみましょう。

Can I have a tip for a blog?

次のような出力が返されます

「chatbot、音声、またはその両方について、もっと読みたいですか？」

Chatbots

「はい、こちらが今日のヒントです。「The Article chatbots And The Challenge Of Invisible Affordances of Cobus Greyling」。

他の書籍や記事のヒントをご希望ですか？また、ミートアップや Google の活動についても説明いたします。どのようなご用件でしょうか？」

同じ質問の別のバージョンを試してみましょう。

"Yes, I want to read more about Voice"

「はい、こちらが今日のヒントです。『The Book Designing Voice User Interfaces: Principles of Conversational Experiences』。... キャシーパール）

他の書籍や記事のヒントをご希望ですか？また、ミートアップや Google の活動についても説明いたします。どのようなご用件でしょうか？」

Dialogflow でこのトレーニングフレーズを使用したことがないことに注意してください。適切なインテントに一致しました。

また、Dialogflow が続行するのに十分な情報を提供したため、フォローアップの質問は返されませんでした。

次のフレーズで Dialogflow を続けます。

What's the URL for your website
Bye

エラー:ログを確認してください。

Cloud Functions の関数のコードで console.log() を使用するたびに、GCP ログ（Stackdriver）にデータが書き込まれます。これらのログにアクセスするには、 Cloud コンソール >ロギング。

最初のプルダウンで、[Cloud Functions の関数 >ダイアログフローを使用してログをフィルタします。

8. 完了

Dialogflow を使用した最初の Google アシスタントアクションの作成が完了しました。

お気づきのように、アクションは Google アカウントに関連付けられたテストモードで実行されていました。iOS または Android スマートフォンの Google Nest デバイスまたは Google アシスタントアプリに、同じアカウントでログインする場合。アクションをテストすることもできます。

次はワークショップのデモですただし、実際に Google アシスタントのアプリケーションを構築する場合は、アクションを送信して承認を受けることもできます。詳しくは、こちらのガイドをご覧ください。

学習した内容

Dialogflow v2 を使用して chatbot を作成する方法
Dialogflow でカスタムエンティティを作成する方法
Dialogflow で直線的な会話を作成する方法
Dialogflow と Google Cloud Functions を使用して Webhook フルフィルメントを設定する方法
Actions on Google を使用してアプリケーションを Google アシスタントに取り込む方法

次のステップ

この Codelab はいかがでしたか？優れたラボをご確認ください。