このトピックでは、Kore.aiボットビルダーのダイアログビルダーツールを使用して、ダイアログタスクでユーザーとボットの間の会話フローを作成するためのユーザーインターフェイスについて説明します。

ダイアログビルダー

検索フィールドでは、find-as-you-typeを使用して、任意の文字または単語に対してコンポーネントのタイトルを検索できます。検索が一致した場合、コンポーネントのタイトルが強調表示されます。

ノードの追加

プラットフォームver9.0では、会話駆動型ダイアログビルダーが導入されました。このダイアログビルダーを使用すると、次の3つの方法のいずれかでダイアログタスクを作成できます。

• 会話優先アプローチを使用します、詳細についてはここを参照してください。
• パネルからダイアログビルダーにノードをドラッグアンドドロップします、以下を参照してください。
• ダイアログビルダーから直接、以下を参照してください。

ドラッグアンドドロップ

パネルからダイアログタスクの指定された場所にノードをドラッグすることにより、ダイアログタスク内にノードを追加できます。ドロップダウンを使用して既存のノードを再利用し、それをドラッグアンドドロップします。

ダイアログキャンバス

別のノードを追加したいノードの横にある+ボタンを使用します。新しいノードを追加することも、既存のノードを使用することもできます。

コネクタラインにカーソルを合わせると表示されるノードの追加ボタンを使用して、2つの既存のノードの間にノードを追加できます。新しいノードを作成するか、既存のノードリストから選択できます。

ノードのプロパティ

[プロパティ]パネルから、次の場所にアクセスできます：

• 名前、タイプ、コンポーネント専用のプロパティなどのコンポーネントプロパティ。
• インスタンスプロパティは、現在のダイアログで選択したノードに合わせてカスタマイズできます。
• 接続プロパティは、遷移条件を設定するために使用できます。
• インテントとエンティティの認識のためのNLPプロパティ。
• IVRチャネルの音声通話プロパティ（IVR統合後にのみ特定のノードで使用可能）。

追加されたコンポーネントのタイプに応じて、プロパティパネルでさまざまな設定を定義できます。詳細については、対応するコンポーネントタイプのドキュメントを参照してください。

ノードのプロパティ

[プロパティ]パネルから、次の場所にアクセスできます：

• 名前、タイプ、コンポーネント専用のプロパティなどのコンポーネントプロパティ。
• インスタンスプロパティは、現在のダイアログで選択したノードに合わせてカスタマイズできます。
• 接続プロパティは、遷移条件を設定するために使用できます。
• インテントとエンティティの認識のためのNLPプロパティ。
• IVRチャネルの音声通話プロパティ（IVR統合後にのみ特定のノードで使用可能）。

追加されたコンポーネントのタイプに応じて、プロパティパネルでさまざまな設定を定義できます。詳細については、対応するコンポーネントタイプのドキュメントを参照してください。

ボットアクションノード

メモ：このノードは、プラットフォームv9.0で、サービス、スクリプトなどのノードのコンテナーとして導入されました。ボットアクションノードには、ユーザーの操作なしでボットによる処理が必要な次のノードが含まれます：

• サービスノード
• スクリプトノード
• ロジックノード
• Webhookノード
• 処理

これらの上記のノードにアクセスするには、以下の手順に従います：

1. それぞれの位置にボットアクションノードを追加します
2. ボットアクションノードの横にある展開（+）ボタンをクリックします
   
3. ノードパネルは、ボットアクションノードパネルに置き換えられます
   
4. ここから、［+］またはドラッグアンドドロップを使用して、任意のノードを追加します
   
5. ボットアクションノード内のノードは、ボットアクション外のノードに直接接続することはできません。
6. ボットアクションノード内のノードの場合、次の接続を構成できます：
   • ノード接続-このオプションを使用して、ボットアクションノード内のノードに接続する接続ルールを定義できます。次のように構成できます：
     • 対応するボットアクションノード内の任意のノード；
     • 接続されていない；
     • ボットアクションの終了-これにより、ボットフローはボットアクションノードに接続されたノードに移動します。
   • ボットアクション接続-このオプションを使用して、現在のボットアクションの外部のノードに接続する接続ルールを定義できます。これらのルールは、ボットアクションノード全体に適用されます。

   

ノードのグループイング

ノードをグループ化して、フォローアップ、余談、およびおよびエンティティ値の修正でユーザーエクスペリエンスを向上させることができます。ダイアログタスクにグループノードを追加するには、次の手順に従います：

1. グループノードを追加したいダイアログタスクを開きます。
2. ctrlキーと、ダイアログ定義のいくつかのノードをカバーする、マウスの選択アクションを使用してグループを作成します。（v9.0より前のバージョンでは、ダイアログ定義のいくつかのノードをカバーするマウスの選択アクションを使用します。）
   
3. グループの名前を変更、構成、または削除できます。
   

オプションメニュー

オプションメニューから、ダイアログビルダーツールの設定、ビュー設定、ダイアログタスク設定、ダイアログのインポートとエクスポートなどのコマンドにアクセスできます。コマンドにアクセスするには、

• 次のイラストに示すように、オプションメニューで、ダイアログビルダーの右上にあるアイコンをクリックします。ボットで変数ネームスペースが有効になっている場合は、追加の変数ネームスペースの管理オプションが表示されます。
  

表示オプション

表示オプションを使用すると、不要なノード情報を減らし、画面の領域をより有効に活用できます。ダイアログビルダーに表示されるノードタイプ、ノードの詳細、又は接続の詳細の一部又はすべてを表示または非表示にできます。

• すべて表示は、すべてのノード情報を表示します。
• ノードタイプを非表示は、ノード名を削除します。
• ノードの詳細を非表示 は、ノードの説明を削除します。
• すべて非表示 は、基本的なノード情報のみを表示します。

ズームコントロール

ズームオプションは次の目的で使用されます：

• 全画面表示-ダイアログビルダーのコンポーネントと接続のサイズを調整して、ページの解像度に合わせて非スクロールの全画面表示をします。
• ズームのリセット-ズーム設定を実際のサイズにリセットします。

次のイラストに示すように、ダイアログタスクビルダーの左下に追加のズームオプションコントロールがあります。

ダイアログの設定

ダイアログ設定ダイアログでは、ダイアログタスクの基本設定を変更できます。必要に応じて、ダイアログの見え方を設定して、ボットタスクとして使用できるが表示されない非表示のダイアログタスクを作成できます。

ダイアログごとに次の設定を追加または変更します：

• 名前-ダイアログタスクの名前。通常はメインユーザーのインテントです。たとえば、「請求書の支払」。
• 説明-ボットビルダーに表示されるダイアログタスクの付加的な説明。
• オプション-エンドユーザーに対するこのダイアログタスクの動作を指定します：
  • サブインテントのみのダイアログ-別のタスクが進行中の場合、タスクはサブタスクとしてのみ呼び出されます。ユーザーがヘルプを要求した場合、タスクはボットタスクとして表示されません。
  • ヘルプから非表示-ユーザーがヘルプを要求した場合、タスクはボットタスクとして表示されません。ユーザーは、ボットと話している間、いつでもこのタスクを呼び出すことができます。前のオプションを選択すると、このオプションが自動的に選択されることに注意してください。
• フォローアップタスク-フォローアップタスク配列には、このダイアログのユーザー発話から検出されたすべてのインテントが含まれています。次のいずれかを実行できます：
  • フォローアップタスクをノード接続の一部として処理する（デフォルト設定）、又は
  • ユーザーにフォローアップタスクを選択させます。
• タスク実行の失敗-タスクの実行でエラーが発生した場合のボットの動作を定義します。次のいずれかに設定できます：
  • ボットレベルの動作と同じ
  • このタスクに専用-タスクを開始するか、スクリプトを実行するか、メッセージを表示します。

トラブルシューティング

ダイアログビルダーの右上にあるダイアログタスクを定義すると、リアルタイムのエラーと警告のセットを利用できます。次のイラストに示すように、情報アイコンをクリックしてエラーまたは警告を表示します。

This topic describes the user interface for creating a conversational flow between a user and a Bot in a dialog task using the Dialog Builder tool in Kore.ai Bot Builder.

Dialog Builder

In the Search field, you can search component titles for any letters or words using find-as-you-type. Search matches are highlighted in the component titles.

Adding Nodes

In ver9.0 of the platform, Conversation Driven Dialog Builder was introduced. This dialog builder allows you to build the dialog tasks in one of the following three ways:

• Using the conversation first approach, refer here for details.
• Drag and drop nodes from the panel onto the dialog builder, refer below.
• Directly from the dialog builder, refer below.

Drag and drop

You can add nodes within the dialog task, by dragging the node from the panel to the designated place in the dialog task. Use the drop-down to reuse existing nodes and drag and drop the same.

Dialog Canvas

Use the + button next to the node where you want to add another node. You can either add a new node or use an existing node.

You can use the Add Node button visible on hover over the connector line, to add nodes between two existing nodes. You can create a new node or pick from the existing node list.

Node Properties

From the Properties panel you can access:

• Component Properties like name, type, and component-specific properties.
• Instance Properties can be customized for the selected node for the current dialog.
• Connection Properties can be used for setting the transition conditions.
• NLP Properties for intent and entity recognition.
• Voice Call Properties for IVR channels (available for certain nodes only after IVR integration).

Depending on the type of component added, you can define various settings in the Properties panel. For more information, see the corresponding component types of documentation.

Bot Action Nodes

Note: This node was introduced in v9.0 of the platform as a container for Service, Script, etc nodes.

Bot Action nodes include the following nodes which need processing by the bot without user interaction:

• Service Node
• Script Node
• Logic Node
• Webhook Node
• Process

To access these above-mentioned nodes follow the below steps:

1. Add Bot Action node in the respective position
2. Click the expand (+) button next to the bot action node
   
3. The nodes panel will be replaced with the Bot Action Nodes panel
   
4. Add any node from here, using either the + or drag and drop
   
5. Nodes inside the bot action node cannot be connected directly to any node outside the bot action.
6. For the nodes inside the bot action node, the following connections can be configured:
   • Node Connections – this option can be used to define the connection rules connecting to nodes within the bot action node. It can be configured to:
     • any node within the corresponding bot action node;
     • Not Connected;
     • End of Bot Action – this would take the bot flow to the node connected to the bot action node;
   • Bot Action Connections – this option can be used to define the connection rules connecting to a node outside of the current Bot Action. These rules would be applied to the bot action node as a whole.

   

Grouping Nodes

You can group nodes to improve the user experience with follow-ups, digressions, and amending entity values.

To add a group node to the dialog task, follow the below steps:

1. Open the Dialog Task where you want to add the Group node.
2. Create a group using the ctrl key and the mouse action of selection covering one or more nodes in the dialog definition. (for pre-v9.0 use the mouse action of selection covering one or more nodes in the dialog definition.)
   
3. You can rename, configure, or delete a group.
   

Options Menu

The Options menu is your access to Dialog Builder tool settings and commands such as view settings, dialog task settings, and dialog import and export. To access commands,

• For the Options menu, click icon on the top-right of the Dialog Builder as shown in the following illustration. If Variable Namespace is enabled for the bot, you can see an additional Manage Variable Namespaces option.
  

Display Options

You can use Display Options to reduce unnecessary node information and better utilize screen real estate.
You can show or hide some or all node types, node details, or connection details displayed in the Dialog Builder.

• Show All to show all the node information.
• Hide Node Type to remove the node name.
• Hide Node Details to remove node descriptions.
• Hide All to show only basic node information.

Zoom Controls

Zoom Options are used to:

• Fit to Page – Resizes Dialog Builder components and connections to fit within the display screen resolution for a single, non-scrolling page.
• Reset Zoom – Resets zoom settings to actual size.

Additional Zoom Option controls are available at the bottom-left of the Dialog Task builder shown in the following illustration.

Dialog Settings

The Dialog Settings dialog allows you to modify the dialog task basic settings, and if desired, set the visibility of a dialog to create a hidden dialog task that is available for use, but not shown as a bot task.

Add or modify the following settings for each dialog:

• Name – The name of your dialog task, usually the main user intent. For example, Pay Bills.
• Description – An optional description of your dialog task displayed in Bot Builder.
• Options – Specify the behavior of this dialog task to the end-user:
  • Sub intent only dialog – Task is invoked only as a sub-task when another task is in progress. The task is not presented as a bot task when the user requests help.
  • Hide from help – Task is not presented as a bot task when the user requests for help. Users can invoke this task anytime while talking to the bot. Note this option is selected automatically when the previous option is selected.
• Follow-up Task – Follow-up task array contains all the intents detected from user utterances from this dialog. You can either:
  • Handle the follow-up tasks as part of node connections (default setting), or
  • Let the user select the follow-up task.
• Task Execution Failure – Define bot behavior when there is an error in task execution. It can be set as either:
  • Same as the Bot Level behavior
  • Specific to this task – initiate a task, run script, or show a message.

Troubleshooting

A real-time set of errors and warnings are available as you define your dialog task located on the top-right of the Dialog Builder. Click the information icon to display any errors or warnings as shown in the following illustration.