ページ

Dialogflow CX の会話(セッション)は、ステートマシンとして記述し、可視化できます。CX セッションの状態はページで表されます。

フローごとに多数のページを定義します。結合されたページでは、フローが設計されたトピックに関する完全な会話を処理できます。どの時点でも、正確に 1 つのページが現在のページであり、また現在のページがアクティブで、そのページに関連付けられたフローもアクティブであるとみなされます。すべてのフローには特別なスタートページがあります。フローが最初にアクティブになると、スタートページが現在のページになります。会話の各ターンでは、現在のページがそのまま表示されるか、別のページに遷移します。

各ページを、そのページが表す会話の状態に関連するエンドユーザーから情報を収集するように構成します。たとえば、次の図にピザ宅配業者の Food Order フローのページ(青で表示)作成します。図の Start ノードは Food Order フローの開始ページを表します。フローが完了すると、Confirmation フローに遷移します。

マルチフロー図の例

ページのライフサイクル

ページがアクティブになると、エージェントはいくつかの手順を遂行します。これには、エントリのフルフィルメント、フォームへの事前入力、状態ハンドラの評価、フォーム パラメータのプロンプト、エンドユーザーへのレスポンス メッセージの送信、ページの変更またはループの繰り返しなどが含まれます。

ページのライフサイクルの図

このプロセスの詳細は次のとおりです。

  1. ページにエントリのフルフィルメントが存在する場合は、そのフルフィルメントが呼び出されます。フルフィルメントによって提供されるレスポンスはすべて、レスポンス キューに追加されます。
  2. ページにフォーム パラメータがある場合は次のように事前入力されます。

  3. いずれかの状態ハンドラがスコープ内にある場合は、ハンドラの評価順序ルールに従って評価されます。 評価には、前のループのイテレーションで呼び出されたルート、イベント ハンドラ、または転送ハンドラが含まれます。状態ハンドラのいずれかが呼び出された場合は、次の一方または両方が発生する可能性があります。

    • 状態ハンドラに対してフルフィルメントが存在する場合、そのフルフィルメントは呼び出されます。フルフィルメントによって提供されるレスポンスはすべて、レスポンス キューに追加されます。
    • ハンドラのターゲット フローまたはページが存在する場合、セッションはターゲットに遷移され、ページは無効になります。
  4. 次のすべてが該当する場合は、フォーム パラメータのプロンプトがレスポンス キューに追加されます。

    • ページにはフォームがあります。
    • 値の入力が必要なフォーム パラメータが他にもあります。
    • 手順 3 で担当者ハンドラが履行されなかった。
  5. レスポンス キューのメッセージがエンドユーザーに送信され、エージェントがエンドユーザー入力を待機します。

  6. エンドユーザーの入力でフォーム パラメータへのプロンプトが表示された場合、パラメータを入力します。手順 3 に進みます。

ページを作成する

ページを作成するには:

コンソール

  1. Dialogflow CX Console を開きます。
  2. GCP プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Flows] セクションでページのフローを選択します。
  5. [Pages] セクションで追加ボタンをクリックします。
  6. ページの名前を入力します。
  7. ページ名の横にある設定ボタンをクリックします。
  8. [編集] を選択します。
  9. 表示されたページ編集パネルのフィールドに入力します。
  10. [保存] をクリックします。

API

create メソッドをご覧ください。

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

プロトコル V3beta1
REST ページリソース
RPC ページ インターフェース

ページデータ

ページのデータにアクセスするには:

コンソール

  1. Dialogflow CX Console を開きます。
  2. エージェントの GCP プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Flows] セクションでフローをクリックします。
  5. フローのページが [Pages] セクションに入力されます。
  6. ページ名の横にある設定ボタンをクリックします。
  7. [編集] を選択します。
  8. 表示されたページ編集パネルのフィールドに入力します。
  9. [保存] をクリックして変更を保存します。

API

get メソッドと patch/update メソッドをご覧ください。

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

プロトコル V3beta1
REST ページリソース
RPC ページ インターフェース

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

  • 名前: フローの表示名。
  • エントリ フルフィルメント(通称エントリ ダイアログ): これは、ページが最初にアクティブになったときに呼び出されるフルフィルメントです。
  • パラメータ: エンドユーザーから構造化された入力を取得するページフォーム内のパラメータ値です。
  • ルート: ページが有効になったときに、これらの状態ハンドラが呼び出される場合があります。詳細については、ページレベルのハンドラのルートをご覧ください。
  • ルートグループ: ページが有効なときに、これらのグループ内のルートが呼び出される場合があります。詳細については、ルートグループをご覧ください。
  • イベント ハンドラ: ページが有効なときに、これらのイベント ハンドラが呼び出される場合があります。詳細については、ページレベルのイベント ハンドラをご覧ください。

ページの削除

ページを削除するには:

コンソール

  1. Dialogflow CX Console を開きます。
  2. GCP プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Flows] セクションでページのフローを選択します。
  5. [Pages] セクションで、ページの名前の横にある設定ボタン をクリックします。
  6. [削除] を選択します。

API

delete メソッドをご覧ください。

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

プロトコル V3beta1
REST ページリソース
RPC ページ インターフェース