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

Dialogflow ES コンソールを使用して、エージェントをビルドしてテストします。

始める前に

始める前に、次の手順を完了してください。

エージェントを作成する

  1. Dialogflow ES コンソールに移動します。
  2. プロンプトが表示されたら、Dialogflow コンソールにログインします。詳細については、 Dialogflow コンソールの概要をご覧ください。
  3. サイドバー メニューで [Loading agents] を展開します。
  4. [Create new agent] をクリックします。
  5. エージェント名、デフォルト言語、デフォルト タイムゾーンを入力します。
  6. 既存のプロジェクトを入力します。Dialogflow コンソールでプロジェクトを作成するには、 [Create a new Google project] を選択します。
  7. [作成] をクリックします。

インテント

インテントによって、1 回の会話ターンにおけるエンドユーザーの 意図が分類されます。エージェントごとに、完全な会話を処理する多数のインテントを定義します。

デフォルト インテント

エージェントを作成すると、Dialogflow によって次の 2 つの デフォルト インテントが作成されます。

  • デフォルトの Welcome インテント: エンドユーザーがエージェントとの会話を開始すると、このインテントとエージェントのマッチングが行われます。このインテントでは、会話の開始にあたりエージェントがどのように動作するか、またはどのような発話をするかをエンドユーザーに知らせるレスポンスを返します。
  • デフォルトのフォールバック インテント: エンドユーザーの表現と他のすべてのインテントとの間で一致がない場合に、このインテントとのマッチングが行われます。

これらのインテントを表示するには、エージェントのインテント リストに移動します。

  1. Dialogflow ES コンソールに移動します。
  2. 作成したエージェントを選択します。
  3. サイドバー メニューで [Intents] をクリックします。

Dialogflow コンソール の真ん中に、エージェントのインテントのリストが表示されます。

インテント リストのスクリーンショット

デフォルトのフォールバック インテントをテストする

シミュレータのスクリーンショット

Dialogflow シミュレータは、コンソールの右側にあります。シミュレータを使用すると、メッセージを発声または入力してエージェントをテストできます。

エージェントを試してみましょう。

  1. [Try it now] フィールドをクリックします。
  2. 「What is your name?」と入力します。
  3. Enter キーを押します。

エージェントのレスポンスは、[Default Response] セクションに表示されます。入力した内容がどのインテントにも一致しなかったため、デフォルトのフォールバック インテントとのマッチングが行われ、デフォルト レスポンスのいずれかが返されます。

インテントを作成する

このセクションの手順では、「What is your name?」という質問に答えるインテントを作成します。 インテントごとに、多数のトレーニング フレーズを定義します。 トレーニング フレーズは、エンドユーザーによるエージェントへの入力または発声のサンプルです。エンドユーザー表現とも呼ばれます。Dialogflow が表現をインテントにマッチングできるようにするトレーニング フレーズを定義します。

インテントを 1 つ作成します。

  1. サイドバー メニューで [Intents] の横にあるインテント追加 button をクリックします。
  2. [Intent name] フィールドに「get-agent-name」と入力します。
  3. [Training Phrases] セクションで、[Add training phrases] をクリックします。

  4. 次のトレーニング フレーズを入力します。

    • What is your name?
    • Do you have a name?
    • Tell me your name

    トレーニング フレーズのスクリーンショット

  5. [Responses] セクションで、[Text Response] セクションに次のように入力します。

    • My name is Dialogflow!

    トレーニング フレーズのスクリーンショット

  6. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。

インテントをテストする

シミュレータのスクリーンショット

シミュレータでWhat's your name?と入力して Enter キーを押します。

入力されているトレーニング フレーズとは少し異なっていても、エージェントは表現に対して適切に応答します。

Dialogflow は、トレーニング フレーズを機械学習モデルのサンプルとして使用して、エンドユーザー表現とインテントのマッチングを行います。モデルは、エージェント内のすべてのインテントに照らして表現をチェックし、すべてのインテントにスコアを設定して、最高スコアのインテントをマッチングします。スコアが最も高いインテントでも、スコアが非常に低い場合は、フォールバック インテントが一致するインテントとなります。

パラメータとエンティティ

実行時にインテントが一致すると、Dialogflow はエンドユーザーの表現から抽出された値をパラメータとして提供します。各パラメータにはエンティティ タイプというタイプがあります。エンティティ タイプによって、データの抽出方法が指定されます。未加工のエンドユーザー入力とは異なり、パラメータは、ロジックの実行やレスポンスの生成に簡単に使用できる構造化データです。

エージェントを作成する際にデータの抽出方法を制御するには、トレーニング フレーズの一部にアノテーションを付け、関連するパラメータを構成します。

パラメータを作成する

インテント パラメータを作成します。

  1. サイドバー メニューで [Intents] の横にあるプラス ボタン をクリックします。
  2. インテント フォームの上部にあるインテント set-language に名前を付けます。
  3. 次のトレーニング フレーズを追加します。
    • I know English
    • I speak French
    • I know how to write in German

  4. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。

    アノテーション付きトレーニング フレーズのスクリーンショット

Dialogflow はトレーニング フレーズから、 システム エンティティとして認識されるパラメータを自動的に検出します。システム エンティティは、多数の一般的なデータ型（場所、色、日付など）向けに Dialogflow が用意したエンティティです。

トレーニング フレーズを追加すると、Dialogflow によって [Action &parameters] テーブルに行が作成されます。

アノテーション付きトレーニング フレーズのスクリーンショット

  • Required: チェックされていません。このパラメータは省略可能です。
  • Parameter Name: 言語として認識されるため、自動的に language というパラメータ名が付けられます。
  • Entity: @sys.language システム エンティティとして認識されます。
  • Value: このパラメータの値を参照するときに使用する識別子です。
  • Is List: チェックされていません。このパラメータはリストではありません。

レスポンスでパラメータ データを使用する

パラメータの値は、レスポンスで使用できます。たとえば、エージェントをビルドする際に、レスポンスに $language パラメータ参照を使用できます。実行時に、エージェントはエンドユーザー表現で指定された言語に置き換えます。

パラメータを使用するレスポンスを追加します。

  1. [Responses] セクションに移動します。
  2. [Text Response] セクションに以下を追加します: Wow! I didn't know you knew $language.
  3. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。

パラメータをテストする

シミュレータのスクリーンショット

シミュレータで「I know Russian」と入力します。Dialogflow が、値「Russian」の language パラメータを正しく抽出していること、レスポンスでこのパラメータ参照が使用される場所に「Russian」が正しく挿入されていることがわかります。

独自のエンティティを作成する

ほとんどの場合、システム エンティティでは提供されない特定のデータをユーザーから収集する必要があります。このような状況に対応するには、カスタム エンティティ を作成できます。

カスタム エンティティを作成するには、次の手順を行います。

  1. サイドバー メニューで [Entities] の横にあるエンティティ追加 button をクリックします。
  2. エンティティの名前として「language-programming」と入力します。

  3. 次のエンティティ エントリ（行）を追加します。

    参照値 同義語
    JavaScript JavaScript、js、ECMAScript
    Java Java
    Python Python、py

  4. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。

エンティティ使用のスクリーンショット

Dialogflow では複数形や大文字と小文字などの単純な違いには対処できます。 エントリには考えられるあらゆる同義語を追加してください。追加する同義語が多ければ多いほど、エージェントは正確にエンティティを判断できます。

新しいエンティティを使用する

新しいエンティティを使用するトレーニング フレーズを set-language インテントに追加します。

  1. サイドバー メニューで [Intents] をクリックします。
  2. set-language インテントをクリックします。
  3. 次のトレーニング フレーズを追加します。
    • I know javascript
    • I know how to code in Java
  4. これらのトレーニング フレーズのプログラミング言語にアノテーションが自動的に付けられ、プログラミング言語が [Action and Parameters] セクションでパラメータに追加されることに注意してください。
  5. [Responses] セクションに、次の 2 番目のテキスト レスポンスを追加します。$language-programming is an excellent programming language。
  6. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。

新しいエンティティをテストする

シミュレータのスクリーンショット

シミュレータで「I know how to code in py」と入力します。Dialogflow は、language-programming パラメータで py を正しく抽出し、Python エンティティとして識別して、その値をレスポンスに挿入します。

コンテキスト

会話の流れを制御するには、 コンテキストを使用します。

フォローアップ インテントを追加する

フォローアップ インテントを使用すると、 コンテキストを手動で作成して管理しなくても、会話を制御できます。

フォローアップ インテントを作成すると、 出力コンテキスト が親インテントに追加され、同じ名前の 入力コンテキスト が子インテントに追加されます。これは、前の会話ターンで親インテントが一致している場合にのみ、フォローアップ インテントとのマッチングが行われることを意味します。

カスタムのフォローアップ インテントを set-language インテントに追加します。

  1. 前の手順で作成した set-language インテントを選択します。
  2. [Response] セクションでテキスト レスポンスを更新します。
    • Wow! I didn't know you knew $language. How long have you known $language?
  3. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。
  4. サイドバー メニューで [Intents] をクリックします。
  5. set-language インテントにカーソルを合わせ、[Add follow-up intent] をクリックします。
  6. リストで [Custom] をクリックします。
  7. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。

フォローアップ インテントに、set-language - custom という名前が自動的に付けられます。

フォローアップのスクリーンショット

フォローアップ インテントを使用したインテント マッチング

フォローアップ インテントが一致するのは、親インテントが一致した後のみです。 インテントが一致するのはset-language インテントの後のみであるため、ユーザーは「How long have you known $language?」という質問を受けたばかりです。set-language - customこの質問に対するユーザーの回答として想定されるトレーニング フレーズを追加します。

  1. サイドバー メニューで [Intents] をクリックします。
  2. set-language - custom インテントをクリックします。
  3. 次のトレーニング フレーズを追加します。
    • 3 years
    • about 4 days
    • for 5 years
  4. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。

フォローアップ インテントをテストする

シミュレータに「I know French」と入力し、質問「How long have you known French」に「about 2 weeks」と答えます。

2 番目の表現（about 2 weeks）に対するレスポンスはありませんが、 適切なインテント（set-language - custom）に表現がマッチングされ、duration パラメータが正しく解析されたこと（2 weeks）がわかります。

インテントとコンテキスト

set-language インテントを調べ、set-language-followup が出力コンテキストとしてリストされ 、その前に数字 2 が付けられていることを確認します。この数字は、 有効期間と呼ばれます。

出力コンテキストのスクリーンショット

set-language インテントがマッチングで一致すると、set-language-followup コンテキストがアクティブになります。このコンテキストは、次の 2 ターンの会話（有効期間 2）にわたって会話に関連付けられます。したがって、「How long have you known $language?」のような質問に答えると、set-language-followup コンテキストがアクティブになります。

set-language - custom インテントを調べ、set-language-followup が入力コンテキストとしてリストされ、 set-language インテントの出力コンテキストと同じであることを確認します。

Dialogflow がインテントのマッチングを行う場合、アクティブなコンテキストと一致する入力コンテキストが含まれるインテントが 優先されます 。

コンテキストとパラメータ

コンテキストはパラメータの値を格納します。set-language インテントの出力コンテキストがアクティブであれば、このインテントに定義されたパラメータの値にアクセスできます。set-language - custom インテントでは、ユーザーが言語を知っている期間のみを尋ね、参照される言語自体は尋ねていません。

レスポンスで言語を参照するには:

  1. set-language - custom インテント テキスト レスポンスを I can't believe you've known #set-language-followup.language for $duration! に更新します。
  2. [Save] ボタンをクリックし、[Agent Training] ダイアログにトレーニングが完了したことが示されるまで待ちます。

#set-language-followup.language 参照は、アクティブなコンテキストの パラメータ参照です。

コンテキスト パラメータをテストする

シミュレータに「I know French」と入力し、質問に「1 week」と答えます。なお、language パラメータ値はコンテキストから取得されます。

本番環境

エージェントを本番環境で実行する前に、 本番環境のベスト プラクティスを実装してください。

次のステップ

フルフィルメント クイックスタートを試します。

前へ
設定とクリーンアップ
次へ
フルフィルメント