インテント

インテントによっては、1 回の会話ターンにおけるエンドユーザーの意図（含意）を分類します。 ES インテントと比較すると、CX インテントは簡素化され、より再利用が可能なリソースになりました。

インテントには以下のデータが含まれます。

用語	定義
表示名	インテントのコンソールに表示される名前。
ラベル	インテントの分類に役立つラベル。例: 主なインテント。
トレーニング フレーズ	トレーニング フレーズは、エンドユーザーの発話に含まれる可能性があるフレーズのサンプルであり、エンドユーザー入力と呼ばれます。エンドユーザー入力がこれらのフレーズのいずれかと似ている場合、Dialogflow によりインテントと照合されます。考えられるすべてのサンプルを定義する必要はありません。Dialogflow の組み込み機械学習機能によって類似するフレーズが追加され、リストが拡張されます。
パラメータ	トレーニング フレーズを定義してパラメータを使用し、エンドユーザー入力の特定部分から値を抽出する。
DTMF のパターン	テレフォニー統合用の DTMF をご覧ください。

インテント マッチング

エンドユーザーが入力（テキスト、音声、電話のキーの押下）を行うと、Dialogflow は入力をインテントのトレーニング フレーズと比較して、最も一致するものを見つけます。このプロセスはインテント マッチングと呼ばれます。インテント マッチングは、スコープ内のインテント ルート（インテント要件のある状態ハンドラ）に関連付けられたインテントに対してのみ行われます。

キーの押下入力は、DTMF パターンに従って照合されます。ただし、テキストに対する一致するインテントを検索する場合、Dialogflow はインテント検出信頼度（信頼スコアとも呼ばれます）を使用して一致候補をスコア付けします。この値の範囲は、0.0（完全に不確実）～1.0（完全に確実）です。インテントがスコア付けされると、次の 2 つの結果が考えられます。

• 最高スコアのインテントの信頼スコアが分類しきい値設定以上の場合は、一致として返されます。
• しきい値を満たすインテントがない場合、不一致イベントが呼び出されます。

Dialogflow ML モデルでは、大文字と小文字がある程度区別されます。このため、エンドユーザーの入力で大文字小文字表記のみが異なる場合、一致スコアが若干異なることがあります。詳しくは、エージェント設計のベスト プラクティス ガイドをご覧ください。

トレーニング フレーズ

注: エージェント設計のベスト プラクティス ガイドには、トレーニング フレーズに関する多くの重要なベスト プラクティスが記載されています。

トレーニング フレーズは、エンドユーザー入力と呼ばれるエンドユーザーの発話に含まれる可能性のあるフレーズのサンプル フレーズです。目的ごとに、多くのトレーニング フレーズを作成します。エンドユーザー入力がこれらのフレーズのいずれかと似ている場合、Dialogflow によりインテントと照合されます。

たとえば、「ピザが欲しい」というトレーニング フレーズは、「ピザを入手する」や「ピザを注文する」など、そのフレーズに類似したエンドユーザーの入力を認識するようトレーニングします。

考えられるすべてのサンプルを定義する必要はありません。Dialogflow の組み込み機械学習機能によって類似するフレーズが追加され、ユーザーのリストが拡張されます。エージェントがさまざまなエンドユーザー入力を認識できるように、少なくとも 10～20 個（インテントの複雑さによって異なります）のトレーニング フレーズを作成する必要があります。たとえば、エンドユーザーの好きな色に関する入力をインテントに認識させるには、次のトレーニングフレーズを定義します。

• 「I like red」
• 「My favorite color is yellow」
• 「black」
• 「Blue is my favorite」
• …

トレーニング フレーズにアノテーションを付ける

注: エージェント設計のベスト プラクティス ガイドに記載されているトレーニング フレーズのアノテーションには、多くの重要なベスト プラクティスがあります。

トレーニング フレーズの一部にアノテーションを付け、関連するパラメータを構成することによってデータの抽出方法を制御します。

たとえば、「What is the forecast tomorrow for Tokyo?」（東京の明日の予報は？）といったトレーニング フレーズを考えてみましょう。「tomorrow」には date パラメータ、「Tokyo」には location パラメータをそれぞれアノテーションとして付ける必要があります。トレーニング フレーズの一部にアノテーションを付けると、Dialogflow は、実行時にエンドユーザーが提供する実際の値の例であることを認識します。「What is the forecast on Friday for Sydney?」（金曜日のシドニーでの予報は？）などのエンドユーザー入力では、Dialogflow は「Friday」（金曜日）から date パラメータ、「Sydney」から location パラメータをそれぞれ抽出します。

パラメータとして抽出するすべてのトレーニング フレーズの部分に、アノテーションを付ける必要があります。そうしないと、Dialogflow は値を抽出しません。

コンソールを使用してエージェントを作成するときに、既存のエンティティ タイプと一致するテキストを含むトレーニング フレーズを追加すると、パラメータが自動的に作成されます。これらの部分はコンソールでハイライト表示されます。必要に応じて、これらのアノテーションやパラメータを編集できます。

トレーニング フレーズにコンソールで手動でアノテーションを追加するには、次の手順を行います。

1. トレーニング フレーズのアノテーションを追加する部分を選択します。
2. リストから目的のエンティティ タイプを選択します。
3. 以下のパラメータ表にパラメータが作成されます。

API を使用してエージェントを作成する場合は、トレーニングフレーズ部分に手動でアノテーションを付ける必要があります。Intent 型で使用されている TrainingPhrase 型をご覧ください。Intent API リファレンスに移動

インテント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	インテント リソース	インテント リソース
RPC	インテント インターフェース	インテント インターフェース
C++	IntentsClient	利用できません
C#	IntentsClient	利用できません
Go	IntentsClient	利用できません
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	提供なし	利用できません
Python	IntentsClient	IntentsClient
Ruby	提供なし	利用できません

終了

トレーニング フレーズによって作成された暗黙的なエンティティ

注: 暗黙的に定義されたカスタム エンティティの値によるよりも、エンティティを明示的に定義する必要があります。

ほとんどのカスタム エンティティは、エンティティ タイプを作成してエンティティ エントリを追加することで明示的に定義されます。ただし、カスタム エンティティに暗黙的な値も含まれる場合があります。これは、トレーニング フレーズのテキストにアノテーションを付ける場合に発生します。この場合に、アノテーション付きテキストは、選択したエンティティ タイプで定義された値ではありません。アノテーション付きテキストは、暗黙的に追加されたエンティティ エントリのエンティティ参照値になります。エンティティ タイプがマップ エンティティの場合、テキストはエンティティ エントリの類義語にもなります。

Default Welcome Intent

エージェントを作成すると、デフォルトのウェルカム インテントが作成されます。一部の言語では、インテントに、最初のエンドユーザー入力と照合させるための簡単なトレーニング フレーズ（「Hi」や「Hello」など）があります。このインテントを必要に応じて編集できます。

API を使用すると、次のインテント ID でこのインテントを参照できます。

00000000-0000-0000-0000-000000000000

エージェントが会話を開始したら、API を使用してこのインテントをトリガーできます。detectIntent メソッドまたは streamingDetectIntent メソッドを呼び出す場合は、QueryInput.intent.intent フィールドの値 projects/<PROJECT_ID>/locations/<LOCATION_ID>/agents/<AGENT_ID>/intents/00000000-0000-0000-0000-000000000000 を使用します。

デフォルトのネガティブ インテント

エージェントを作成すると、デフォルトのネガティブ インテントが作成されます。このインテントに、ネガティブ サンプルとして機能するトレーニング フレーズを追加できます。エンドユーザーの入力が通常のインテントのトレーニング フレーズとわずかに似ていても、それらの表現を通常のインテントにマッチングさせたくない場合があります。

たとえば、部屋予約エージェントに「I'd like to book a room.」などのトレーニング フレーズが含まれているとします。一方で、エンドユーザーが部屋に関する本を購入したい場合、「I'd like to buy a book about rooms.」と言うかもしれません。このエンドユーザーの入力がインテントにマッチングしないようにするには、そのフレーズをネガティブ サンプルとして追加します。

さらに、どのインテントにも一致しないように、エージェントのスコープ外である可能性のあるフレーズを追加する必要もあります。ただし、これらのフレーズを大量に追加することは避けてください。たとえば、10,000 個のデフォルトのネガティブ インテント フレーズを定義すると、通常のインテント マッチングに悪影響を与えます。

これらのフレーズは定期的に確認してください。これらのエージェントの中には、当初はエージェントの対象外であったものの、その後にインテントに追加されたものもあるためです。

デフォルトのネガティブ インテントは、すべてのインテント マッチングにわたって影響します。それに追加したフレーズは、あるインテントではマッチングに役立ちますが、別のインテントではマッチングの妨げになります。たとえば、デフォルトのネガティブ インテントに「国際電話」を追加して、海外旅行のインテントにマッチングしないようにできます。ただし、これはフレーズが国際通話のインテントとマッチングしないようにもします。

API を使用すると、次のインテント ID でこのインテントを参照できます。

00000000-0000-0000-0000-000000000001

キャンセル インテント

会話中、エンドユーザーが現在の会話トピックをキャンセルする場合があります。たとえば、現在アクティブなページは新しい予約の日付を要求していますが、エンドユーザーが新しい予約を作成しないことを決定した場合です。エンドユーザーが、「キャンセル」や「新しい予約を希望しません」などの発言を行うことがあります。この状況に対処するには、エージェントに 1 つ以上のキャンセル インテントを作成します。これらのキャンセル インテントには任意の名前を付けることができますが、名前に「cancel」を含めることが一般的です。これらのキャンセル インテントを、会話の関連ポイントの範囲内にあるインテント ルートに関連付ける必要があります。これらのインテント ルートは、キャンセルを処理するための適切なページに遷移する必要があります。

キャンセル インテントのトレーニング フレーズは、一般的なキャンセルの行とトピック固有のキャンセル試行の両方を処理する必要があります。次に例を示します。

• キャンセル
• 停止
• キャンセル
• キャンセル
• 従来のコンソールに戻す
• 戻る
• 新しい予約を希望しない
• 新しい予約をキャンセルする
• 新しい予約を削除する

インテントを作成する

インテントを作成するには、次の手順を行います。

コンソール

1. Dialogflow CX Console を開きます。
2. ご自身の Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. [+作成] をクリックします。
7. インテント データを入力します。
8. [保存] をクリックします。

API

Intent 型の create メソッドをご覧ください。Intent API リファレンスに移動

インテント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	インテント リソース	インテント リソース
RPC	インテント インターフェース	インテント インターフェース
C++	IntentsClient	利用できません
C#	IntentsClient	利用できません
Go	IntentsClient	利用できません
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	提供なし	利用できません
Python	IntentsClient	IntentsClient
Ruby	提供なし	利用できません

終了

インテントを削除する

インテントを削除するには、次の手順を行います。

コンソール

1. Dialogflow CX Console を開きます。
2. ご自身の Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. 削除するインテントにカーソルを合わせます。
7. [削除] ボタンをクリックします。

API

Intent 型の delete メソッドをご覧ください。Intent API リファレンスに移動

インテント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	インテント リソース	インテント リソース
RPC	インテント インターフェース	インテント インターフェース
C++	IntentsClient	利用できません
C#	IntentsClient	利用できません
Go	IntentsClient	利用できません
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	提供なし	利用できません
Python	IntentsClient	IntentsClient
Ruby	提供なし	利用できません

終了

インテント データにアクセスする

インテント データにアクセスするには、次の手順を行います。

コンソール

1. Dialogflow CX Console を開きます。
2. ご自身の Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. アクセスするインテントをクリックします。
7. インテント データを表示または更新します。
8. [保存] をクリックして変更を保存します。

API

Intent 型の get メソッドと patch/update メソッドをご覧ください。Intent API リファレンスに移動

インテント リファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	インテント リソース	インテント リソース
RPC	インテント インターフェース	インテント インターフェース
C++	IntentsClient	利用できません
C#	IntentsClient	利用できません
Go	IntentsClient	利用できません
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	提供なし	利用できません
Python	IntentsClient	IntentsClient
Ruby	提供なし	利用できません

終了

インテントの候補

注: この機能は現在、global リージョンと us-central1 リージョンでのみ利用可能です。他のリージョンでこの機能が必要な場合は、Google Cloud アカウント チームにお問い合わせください。

注: 一般的なエージェント設定でインテント提案を有効にする必要があります。

Dialogflow は、会話中の不一致のオカレンスを自動的に分析し、新しいインテントを提案することも、既存のインテントに対して追加のトレーニング フレーズを推奨することもできます。これらの提案を受け入れると、その後、不一致が発生することを回避できます。

提案を使用する場合は、クラスタサイズを調整できます。クラスタサイズの値が小さいほど、インテントあたりのトレーニング フレーズが少なく、より多くのインテントが提案されます。クラスタサイズの値が大きいほど、インテントあたりのトレーニング フレーズが多く、より少ないインテントが提案されます。

インテントの提案を受け入れるには:

コンソール

1. Dialogflow CX Console を開きます。
2. ご自身の Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. [Suggestions] タブをクリックします。
7. 必要に応じてクラスタサイズを調整します。
8. 提案を選択します。
9. 目的のトレーニング フレーズを選択します。
10. ターゲット インテントに対して、既存のインテントまたは新しいインテントにトレーニング フレーズを追加します。
11. [保存] または [新規作成] をクリックして変更を保存します。インテントの提案を受け入れた場合、そのインテントは提案リストに残ります。

インテントを分割する

コンソールを使用して、1 つのインテントを 2 つのインテントに分割できます。このインターフェースでは、ソース インテントからトレーニング フレーズを選択し、新しいインテントに移動できます。

コンソール

1. Dialogflow CX Console を開きます。
2. プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. 分割するインテントを選択します。
7. [スプリット] をクリックします。
8. ソース インテントからインテントを選択します。
9. [右に移動] をクリックします。
10. ターゲット インテントの他の詳細を指定します。
11. [スプリット] をクリックします。

インテントを比較して統合する

コンソールを使用して、2 つのインテントを比較したり、1 つのインテントに統合したりできます。

コンソール

1. Dialogflow CX Console を開きます。
2. プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. 比較または統合する 2 つのインテントを選択します。
7. [Compare] をクリック
8. 比較のために、トレーニング フレーズが並べて表示されます。
9. [統合] をクリックして 2 つのインテントを統合します。

インテントをエクスポートおよびインポートする

インテントをエクスポートしてインポートし、エージェント間で共有できます。

エクスポート形式のオプションの 1 つである CSV には、次の列があります。

• インテントの表示名
• 言語
• フレーズ

各エントリには、表示名、言語、最初のトレーニング フレーズのいずれか、または以前に宣言されたインテントのトレーニング フレーズのみが含まれます。Dialogflow はエクスポートされたトレーニング フレーズにアノテーションをエンコードし、インポート時にアノテーションが復元されるようにします。このエンコードの形式は次のとおりです。

(annotated part)[entity, parameter]

例:

Intent Display Name,Language,Phrase
Shirt Selection,en,I want a (green)[@sys.color, color] shirt
,,I would like a (yellow)[@sys.color, color] shirt
Store Hours,en,When are you open?
,,What are your hours?

インテントをインポートするときに、既存のエージェントのインテントの表示名がインポートされたインテントの表示名と一致すると、マージの競合が発生する可能性があります。次のいずれかを選択して、インテントの表示名が一致する際のマージの動作を制御できます。

• Replace existing intents: インポートされたインテントは、既存のエージェントにある同じ名前のインテントを上書きします。
• 新しいインテントとして名前を変更しインポートする: インポートされたインテントは名前が変更され、表示名に「_1」が追加されます。
• Merge with existing intents: インポートされたインテントのトレーニング フレーズが、既存のインテントに追加されます。同じトレーニング フレーズが存在する場合は、重複しません。
• 元のインテントを維持する: 既存のインテントは変更されず、競合するインテントは無視されます。競合していないインテントがインポートされます。

インテントをエクスポートするには、次の手順に従います。

コンソール

1. Dialogflow CX Console を開きます。
2. ご自身の Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. エクスポートする各インテントを選択します。
7. [Export selected intent] をクリックします。
8. 目的の形式と宛先を選択します。
9. [送信] をクリックします。

インテントをインポートするには、次の手順に従います。

コンソール

1. Dialogflow CX Console を開きます。
2. ご自身の Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. [Import（インポート）] をクリックします。
7. ソースを選択します。
8. 競合がある場合は、マージ動作を選択できるダイアログ ウィンドウが表示されます。
9. [送信] をクリックします。

トレーニング フレーズをエクスポートおよびインポートする

既存のインテントのトレーニング フレーズをエクスポートおよびインポートできます。

インポートのファイル形式は、列見出しのない単一列の CSV です。例:

"I want a pony"
"I need a pony"
"I must have a pony"

トレーニング フレーズをインポートするときは、次のいずれかのインポート モードを選択できます。

• Import as new training phrases: ファイル内のフレーズは、既存のフレーズのリストに追加されます。
• Replace existing training phrases: 既存のトレーニング フレーズが削除され、ファイルのトレーニング フレーズが追加されます。

デフォルトでは、インポートされたトレーニング フレーズに自動的にアノテーションが付けられます。この動作を無効にするには、[Skip auto annotation] を選択します。

インテントのトレーニング フレーズをインポートするには、次の手順に従います。

コンソール

1. Dialogflow CX Console を開きます。
2. ご自身の Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. インテントを選択します。
7. [Training phrase] セクションまでスクロールします。
8. エクスポートするトレーニング フレーズを選択します。
9. [エクスポート] をクリックします。

インテントのトレーニング フレーズをインポートするには、次の手順に従います。

コンソール

1. Dialogflow CX Console を開きます。
2. ご自身の Google Cloud プロジェクトを選択します。
3. エージェントを選択します。
4. [Manage] タブを選択します。
5. [Intents] をクリックします。
6. インテントを選択します。
7. [Training phrase] セクションまでスクロールします。
8. 必要に応じて、[skip auto annotation] を選択します。
9. トレーニング フレーズリストのすぐ上にあるインポート ボタンをクリックします。
10. ファイルとインポート モードを選択します。
11. [送信] をクリックします。

主インテントと補助インテント

エージェントを設計する際には、インテントを主インテントまたは補助インテントとして考えると便利な場合があります。

注: 「主インテント」のラベルは、インテントに適用できるシステムラベルです。これは、分析データをフィルタする場合に役立ちます。

主インテントは、エージェントとのやり取りに関するエンドユーザーの主要な目的を識別します。補助インテントは、主インテントに関連するエンドユーザーの後続の質問を識別します。これらの後続の質問により、エンドユーザーのニーズに関する追加の内容が提示される場合や、エンドユーザーが何かを明確にしたり、より深く理解したりするのに役立つフォローアップの質問である場合があります。

主インテントは通常、会話内で最初に一致するインテントの 1 つで、その後のエンドユーザーの質問は補助インテントと一致します。次に例を示します。

対話	説明
エンドユーザー: 新しいスマートフォンを有効にしてください エージェント: 承知しました。お手伝いいたします。有効にする電話番号の末尾 4 桁は何ですか？	主インテントが一致します
エンドユーザー: 1234 エージェント: スマートフォンをすぐに有効にする準備はできていますか？	パラメータが設定されます
エンドユーザー: すべてのメッセージは新しいスマートフォンに引き継がれますか？ エージェント: ...	補助インテントが一致します

注: ルートグループを使用すると、関連する補助インテントを複数のページに簡単に一括で追加できます。