フロー

多くの場合、複雑なダイアログでは複数の会話トピックが関与します。たとえば、ピザの配達エージェントの場合、料理の注文、顧客情報、確認という別個のトピックが考えられます。各トピックでは、エージェントがエンドユーザーから関連する情報を取得するため、複数の会話ターンを実行する必要があります。

フローは、これらのトピックと、関連する会話パスを定義するために使用されます。すべてのエージェントには、デフォルトの開始フローと呼ばれるフローが 1 つあります。単純なエージェントであれば、このフローのみで十分でしょう。より複雑なエージェントでは追加のフローが必要になる場合があります。さまざまな開発チームのメンバーに、これらのフローの構築と保守を担当させることができます。たとえば、ピザの配達エージェントのフローは次のようになります。

Dialogflow CX のフローは、Dialogflow ES メガ エージェントのサブエージェントと同様の目的で機能します。フローを使用すると会話をより適切に制御できます。追加のコストは発生しません。

デフォルトの開始フロー

エージェントを作成すると、デフォルトの開始フローが自動的に作成されます。単純なエージェントの場合は、このフローを唯一のフローとして使用できます。より複雑なエージェントの場合は、フローをさらに追加して、デフォルトの開始フローを会話へのシンプルなエントリ ポイントとして利用できます。

注: デフォルトの開始フローは削除できません。

API を使用する場合、次のフロー ID を使用してデフォルトの開始フローを参照できます。

00000000-0000-0000-0000-000000000000

フローのスタートページ

各フローには、コンソールに Start という名前の特別なページがあります。コンソールでフローを選択すると、スタートページがグラフ上のノードとして表示されます。フローが最初にアクティブになると、このページが現在のアクティブなページになります。

スタートページには、通常のページのようなパラメータやレスポンス メッセージがありません。ただし、次のいずれかの方法でメッセージを送信できます。

• インテントの伝播
• 単純な true 条件を、フルフィルメント レスポンスがあるルートまたは、エントリ フルフィルメントを持つ通常のページへの遷移ターゲットで使用します。
• カスタム イベント

API を使用する場合、次のページ ID でフローのスタートページを参照できます。

START_PAGE

フローの作成

フローを作成するには:

コンソール

1. Dialogflow CX Console を開きます。
2. GCP プロジェクトを選択します。
3. エージェントを選択します。
4. [Flows] セクションの追加 ボタンをクリックします。
5. フローの表示名を入力します。
6. 作成したフローをクリックします。

API

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

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

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

終了

フローデータ

フローのデータにアクセスするには:

コンソール

1. Dialogflow CX Console を開きます。
2. エージェントの GCP プロジェクトを選択します。
3. リストでエージェントを見つけます。
4. エージェントの表示名をクリックします。
5. [Flows] セクションでフローをクリックします。
6. フローのページが [Pages] セクションに入力されます。ページの編集については、ページガイドをご覧ください。
7. グラフ上のフローをクリックします。
8. フロー編集パネルが表示されます。このパネルから、追加のフローデータを閲覧、編集できます。
9. [保存] をクリックして変更を保存します。

API

フローについては、Flow タイプの get と patch/update をご覧ください。Flow API リファレンスに移動

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

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

終了

ページについては、Page タイプの get メソッドと patch/update メソッドをご覧ください。Page API リファレンスに移動

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

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

終了

次のデータはフローに関連付けられています。

• ページ: フローを構成するページのリスト。
• ルート: フローのスタートページがアクティブなときに、これらのすべてのルートが呼び出される場合があります。フローの他のページがアクティブな場合は、インテント要件のあるルートが適用される場合があります。詳細については、ステート ハンドラのスコープと、フローレベルのルートをご覧ください。
• イベント ハンドラ: これらのハンドラは、フローがアクティブなときに呼び出される場合があります。詳細については、フローレベルのイベント ハンドラをご覧ください。

フローの設定

フローには次の設定を使用できます。

• 表示名: 人が読める形式のフローの名前。
• 説明: フローの説明。
• ML 設定 フローの ML 設定は、エージェントの ML 設定にも記載され、説明されています。
• 音声の詳細設定: これらの音声設定では、必要に応じて同じエージェントの音声設定をオーバーライドできます。

フローの設定にアクセスするには:

コンソール

1. Dialogflow CX Console を開きます。
2. GCP プロジェクトを選択します。
3. エージェントを選択します。
4. [Flows] セクションのフローにカーソルを合わせます。
5. [オプション ] ボタンをクリックします。
6. [Flow settings] を選択します。
7. 設定をブラウジングまたは編集します。
8. [保存] をクリックして変更を保存します。

API

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

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

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

終了

フローの削除

フローを削除するには:

コンソール

1. Dialogflow CX Console を開きます。
2. GCP プロジェクトを選択します。
3. エージェントを選択します。
4. [Flows] セクションのフローにカーソルを合わせます。
5. 設定 ボタンをクリックします。
6. [削除] を選択します。

API

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

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

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

終了

フローのトレーニング

フローをトレーニングする手順は、次のとおりです。

コンソール

1. Dialogflow CX Console を開きます。
2. GCP プロジェクトを選択します。
3. エージェントを選択します。
4. [エージェント設定] をクリックします。
5. [ML] タブを開きます。
6. 単一のフローをトレーニングするには、対応する行の [トレーニング] をクリックします。
7. 複数のフローをトレーニングするには、チェックボックスをオンにしてそれらのフローを選択し、[Train selected flow NLU model] をクリックします。

API

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

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

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

終了