この機能はプラットフォームのバージョン 7.3 でリリースされたもので、(ベータ版) の状態です。

バーチャル エージェントは、主に一連のメッセージのやり取りを含む会話型インターフェイスを使用してエンドユーザーと関わります。しかし大抵の場合、続行するにはエンドユーザーから情報を収集することが必要になります。例として、e コマース エージェントとのやりとり中に配送先住所を提供する、ITSM エージェントへの報告中に問題の詳細を提供する、CRM オポチュニティの作成中にオポチュニティの詳細を提供する、銀行口座を作成するために顧客の詳細情報を取得する、などが挙げられます。

標準のダイアログ タスクでは、このシナリオは一連のエンティティ ノードを配置して設計されており、ユーザーはこれらのエンティティの値を次々に要求されますが、これは非常に面倒で煩わしいものです。これらの代わりとして、ユーザーからすべての情報を簡単かつ効率的に取得するための対話型のユーザー インターフェイスが理想的です。

Kore.ai のデジタル フォームは、エンドユーザーから必要な詳細情報を取得するために必要な入力フィールドに情報を入力することで、このような要件に対応しています。ユーザーがフォームに入力した後、入力した内容をバーチャル エージェントに送信し、タスクを進めることができます。

この文書では、Kore.ai ボット プラットフォームのデジタル フォームの機能と実装について説明しています。デジタル フォームの段階的な実装についてのユースケースに移動するには、こちらをクリックしてください。

フォームの作成

デジタル フォームは、定義、およびユーザー入力を取得するための様々なコンポーネントを含みます。

フォーム作成の手順:

1. 左側のパネルで、[ボット タスク] をクリックします。
2. ボット タスク ページで、[デジタル フォーム]>[新しいフォームの作成] をクリックします。
3. 新しいフォームページで以下の情報を入力します。
   • フォームの名前
   • フォームの表示名
   • フォームの説明
4. フォームの作成を [保存して続行] します。

コンポーネントの追加

• 左側のパネルで利用可能なコンポーネントをキャンバスにドラッグ＆ドロップし、プロパティを設定してフォームを作成することができます。コンポーネントおよびプロパティの詳細については、下記を参照してください。
• 指定されたコンポーネントを検索したり、リストをスクロールしたりすることができます。
• グリッド形式で表示します。

フォーム操作

フォームの一覧ページからは以下のことが行えます。

• 新しいフォームを作成します。(上記を参照)
• フォームを編集します。(下記を参照)
• ブランディング オプションを使用してフォームをカスタマイズします。(こちらを参照)
• フォームをテストします。(こちらを参照)
• フォームを削除します。

編集

フォーム一覧の編集オプションを使ってフォームを編集することができます。以下の操作は編集モードでフォームに対して実行することができます。

• コンポーネント リストを使用すると、ドラッグ＆ドロップの簡単な操作でコンポーネントを選択してフォームに追加することができます。
• トグラーの表示を使用して、デスクトップ ビューとモバイル ビューを切り替えます。
• それぞれのコンポーネントに対してハンドルバーを使用して、ドラッグ＆ドロップの簡単な操作で位置を変更します。
• フォーム アクションを使用して以下を実行します。
  • フォームをテストして、ボットビルダーのデジタル フォームのプレビューを確認する。
  • フォームを削除する。
  • 名前、表示名、説明などのフォーム設定を変更する。
• コンポーネント アクションを使用して、コンポーネントの設定、複製、および削除を利用します。
• コンポーネントの設定ポップアップからコンポーネントのプロパティを変更することができます。
  • コンポーネント ドッカーを使用して、設定パネルを画面にドッキング/ドッキング解除します。
  • コンポーネント セレクタを使用して、フォーム上のコンポーネントを検索します。

ブランディング

ブランディング オプションを使用して、組織の標準を反映するようにフォームの外観を変更します。すぐにプレビューが表示され、新しい色でフォームがどのように見えるかが分かり、保存またはデフォルトに戻すスキームのオプションを選択することができます。

テスト

フォームをテストしてプレビューを確認します。

フォームの呼び出し

以下はデジタル フォームを呼び出す方法です。

1. タスクから: タスクを定義するためのダイアログ タスクのコンポーネントとしてフォームを含めることができます。ダイアログ タスクには、フォームデータを入力するためのフォーム体験および通常の会話体験があります。やり取りのチャネルまたはその他の基準に基づいて、要件に応じて好きな方を選択することができます。
2. strong>UI フローから: パネルにデジタル フォームを追加し、パネルからフォームが送信されたときにトリガーされるダイアログ タスクを選択することができます。

以下のセクションでは、上記のそれぞれの呼び出しプロセスについて説明しています。

タスクから

デジタル フォームは、フォーム ノードを介してユーザー入力を取得するために、ダイアログ タスク内で使用することができます。

ダイアログ タスクからフォームを呼び出す手順。

1. デジタル フォームを呼び出したい場所からダイアログを作成/開きます。
2. フォームを追加したいノードの隣にある ＋ をクリックします。
3. フォーム オプションを選択し、表示されたリストからフォームを選択します。デジタル フォームを直接追加するか、既存のフォーム ノードを使用するかを選択することができます。
   
4. フォーム体験を選択するように促されます。
   
   • • フォーム UI のみ – フォーム ノードを作成し、選択されたデジタル フォームと関連付けられます。こちらはデフォルトのオプションです。
       
     • フォーム UI および会話体験の両方 – こちらを選択した場合、さらにチャネルの選択が促されます。ユーザーが選択したチャネルのいずれかを使用している場合にはフォーム UI が表示され、それ以外のチャネルのユーザーは会話体験が提供されます。
       
       このオプションは、以下を作成します。
       • 以下のノードを含むグループ (詳細はこちら)。グループ化の名前を変更したり削除したりすることができます。
         • 選択されたチャネルに基づいてフォーム ノードとサブダイアログ ノードへの転送を決定するためのロジック ノード。
         • 上記の「フォーム UI のみ」で生成されたものと同じ、デジタル フォーム用のフォーム ノード。
         • 会話体験に必要なエンティティ (コンポーネントを使用してデジタル フォームで定義されている) を取得するためのサブダイアログ ノード。マッピングについては以下を参照してください。

         

5. 追加されたそれぞれのノードにプロパティを設定することができます。
   • フォーム ノード (詳細はこちら)。
     特に注目すべき点は、以下のコンポーネント プロパティです。
     • メッセージの送信 – フォームの送信が成功した際にエンドユーザーに表示されるメッセージです。
     • ウェブ/モバイル SDK フォームの動作 – このオプションを使用すると、フォームをチャット ウィンドウにインライン表示するか、ページ全体で開くことができます。
   • ロジック ノードは、会話体験フローの場合にも設定可能です。(詳細はこちら)
     特に注目すべき点は、以下の事項です。
     • コンテキスト変数の管理は、コンテキスト変数の作成や値の設定に使用することができます。キー フィールドには、変数のフルパスを使用することを忘れないようにしてください。(例: context.BotUserSession.)
     • ボットのパフォーマンスに影響を与える可能性があるため、接続設定には変更を加えないことを強くお勧めします。
   • サブダイアログ ノードは、通常通りに設定できます。(詳細はこちら)
     特に注目すべき点は、以下の事項です。
     • エンティティの割り当て後を使用して、ユーザー入力を取得します。
       
     • サブダイアログやソース フォームを変更した場合、ダイアログの再生成というオプションが表示されます。これにより、タスク全体を再構築しなくとも変更をタスクに反映させることができます。このサブダイアログが使用されるすべての場所で変更が反映されることにご注意ください。
       
6. ユーザー入力は以下のようにアクセスできます。
   • フォームのコンポーネントの値には、{{context.forms..}}を使用してアクセスすることができます (詳細はこちら)。
   • サブダイアログの場合は、割り当て後の設定で使用する変数を{{context.}}とします。
7. お客様のビジネス ニーズに応じてダイアログ タスクを続行することができます。例えば、データ更新のためにフォーム コンポーネントの値をサービス ノードへの入力として使用したり、スクリプト ノードを使用してさらに処理を行ったりすることができます。会話体験も使用している場合、自動生成されたサブダイアログをプロセス フローに接続することを忘れないようにしましょう。

パネルから

ウィジェットとパネルを設定することで、デジタル ビューでデジタル フォームを表示することができます。デジタル ビューの詳細についてはこちらを参照してください。

ウィジェットとパネルを使用してフォームを呼び出す手順。

1. ウィジェットを作成してデジタル フォームを呼び出します。
   1. 名前を入力します。
   2. デジタル フォームをソースとして選択します。
   3. ドロップダウン リストから選択してフォームを追加します。
   4. ドロップダウン リストから送信時に呼び出すダイアログを選択します。
      デジタル フォームを使用して、複数のウィジェットを定義したり、複数のパネルに追加したりすることができますが、すべてのウィジェットとパネルにまたがる単一のダイアログ タスクに関連付けられることにご注意ください。
   5. ウィジェットを保存します。
      
2. 既存のパネルにウィジェットを追加するか、新しいパネルを作成します。
   パネルに直接フォームを追加すると、デフォルトでウィジェットが作成されます。
   
3. パネルをテストすることができます。
4. パネルを公開およびホストするには、こちらに記載されている手順に従ってください。

プロセス フロー

エンドユーザーがダイアログを開始し、フォーム ノードに接続しているノードに到達すると、以下のイベントが発生します。設計時に選択した体験および呼び出しのチャネルに応じて、フローは以下のようになります。

• フォーム体験:
  • フォームへのリンクがユーザーに提示されます。
    同期 Webhook チャネルでは、リンクの代わりに完全なフォーム定義が送信されることにご注意ください。詳細はこちらを参照してください。
    
  • リンクをクリックすると、選択した内容に基づいて、全画面またはインライン モードでフォームを開くことができます。リンクに関して特に注目すべき点は、以下の通りです。
    • リンクは一定期間のみ有効で、それ以降は無効になります。
    • 有効期間内であっても、限られた回数しか使用できません。
  • エンドユーザーは、コンポーネント/フィールドの値を入力することができます。
    
  • すべてのフォームにはデフォルトで [送信] ボタンが含まれています。これはフォームの入力を検証し、不足している値があればプロンプトを表示します。
    
  • フォームが検証されて送信されると、値はコンテキスト変数で使用可能になり、以下のコードを使用してアクセスすることができるようになります。context.forms..
    ここでは、メッセージ ノードを使用してユーザーの入力を取得し、表示しています。
    
• 会話体験:
  • エンドユーザーは、操作のチャネルからフォーム内でそれぞれのコンポーネントの値を入力するように促されます。
  • 値はサブダイアログのコンテキストで利用可能になり、上記のように Entity Post Assignment を使用して取得することができます。
  • 以下は会話モードでのユーザー体験です。
    

例外

フォーム ノードでのダイアログ実行中に例外が発生した場合、以下のように処理されます。

パネル フロー

ユーザーは、パネルとウィジェットを使用してフォームにアクセスすることができます。体験は、フォームを使用したプロセス フローの場合と同じです。

フォームが検証されて送信されると、値はコンテキスト変数で使用可能になり、以下のコードを使用してアクセスすることができるようになります。context.forms..

体験は以下のようになります。

ボット管理

公開

デジタル フォームを使用したボットの公開フローには、以下のような特殊なケースがあります。

• 他のボットと同様に、デジタル フォームは以下の状態で存在します。
  • フォームが作成された場合、開発中。
  • フォームが公開に投稿され、リクエストが管理者のアクションを待っている場合、承認待ち。
  • 管理者によって公開リクエストが拒否された場合、拒否。
  • 管理者が公開リクエストを承認した場合、公開済み。
  • 公開済みのフォームが管理者によって一時停止された場合、一時停止。
• 公開リクエストが処理される前に、以下の検証が行われます。
  • デジタル フォームを含むダイアログ タスクは、以下の場合にのみ公開することができます。
    • 対応するデジタル フォームが既に公開されている
    • 対応するデジタル フォームも公開用に選択されている
  • ダイアログ タスクを起動するように設定されたデジタル フォームは、以下の場合にのみ公開することができます。
    • 対応するダイアログ タスクが既に公開されている
    • 対応するダイアログ タスクが公開用に選択されている
  • 依存関係は一緒に公開されますが、次のような場合、実行時にすべての依存関係が利用できない可能性があります。
    • ダイアログ タスクは公開されているがデジタル フォームが公開されていない場合、以下がトリガーされます。
      • タスクの失敗イベントとそれに対応する動作が呼び出される
      • 関連する標準応答が表示される
      • 「分析」で失敗したタスクとしてログに記録される。
    • デジタル フォームは公開されている状態であるがダイアログ タスクが利用できない場合、フォーム送信時にエンドユーザーにフォームのエラー メッセージが表示されます。

インポート/エクスポート

ボットのエクスポート

• 開発中および公開済みのコピーでデジタル フォームをエクスポートするオプションが利用可能です。
• デジタル フォームは、ボット タスクのカテゴリのボット エクスポート ページから選択/解除することができます。
• 依存ダイアログを含むオプションを選択して、ウィジェットを定義するために選択したデジタル フォームと統合されたダイアログ タスクをエクスポートします。これにはデジタル フォームを使用して生成されたサブダイアログ タスクは含まれないことにご注意ください。
• 選択されたそれぞれのフォームの完全な情報はエクスポート ファイルで利用可能です。これには以下が含まれます。
  • フィールド
  • フィールド プロパティ
  • フォームの統合

ボットのインポート

• デジタル フォームは、ボットの完全および増分インポートに含まれています。
• フル インポートの場合:
  • フル インポートは、他のすべてのボット コンポーネントと同様に、デジタル フォーム全体とボット内のフォームの詳細を置き換えます。
• 増分インポートの場合:
  • インポートにデジタル フォームを含めるかどうかを選択することができます。
  • このインポートにより、インポート ファイルに共通のデジタル フォームが完全にボットに置き換えられます。
  • ファイル内の追加フォームはボットにインポートされます。
  • ボット内の追加フォームは保持されます。
  • インポート後、無効なデジタル フォームの統合の詳細は、対応するフォームと切り離されます。

コンポーネントの詳細

コンポーネント リスト

以下は利用可能なコンポーネントのリストです。各コンポーネントのプロパティの詳細については、下記を参照してください。

コンポーネント	説明	サンプル
ベーシック
	[テキスト フィールド] – 一行入力に使用されます。
	[テキスト 領域] – 複数行入力に使用されます。
	[数値] – 数値エントリに使用されます。
	[ラジオ ボタン] – 与えられたリストの選択オプションとして使用されます。
	[ドロップダウン] – 与えられたリストの選択オプションとして使用されます。複数選択可能です。
	[チェック ボックス] – 与えられたリストの複数選択オプションとして使用されます。
	[日付] – 日付の入力に使用され、ユーザーが日付を選択するための Datepicker を与えます。
	[日付および時間] – 日付と時間の入力に使用され、ユーザーが日付と時間を選択するための DateTimePicker 与えます。 日付コンポーネントを使用して時間オプションを「はい」に設定し、12 時間または 24 時間フォーマットから選択します。
	[電話番号] – 電話番号の入力に使用され、ユーザーが国コードを選択できるようにします。
	[メール] – メール アドレスの入力に使用され、xxx@uuu.com 形式で検証されます。
	[トグル] – 2 つの値の切り替えに使用され、「はい/いいえ」形式の入力に最適です。
	[住所] – 住所の入力に使用されます。
	[URL] – ウェブ URL の入力に使用され、xxx.com 形式で検証されます。
	[範囲スライダー] – 指定された最小値と最大値の間で値を選択します。パーセンテージで表すことができます。
詳細
	[ボタン] – フォームを送信、リセット、または外部 URL を開くためのクリック可能なコンポーネントとして使用されます。Primary、Secondary、Tertiary、Ghost、Danger から選択できます。
	[ラベル] – 静的なテキスト ボックスを表示するために使用されます。ユーザーによる操作は不要です。
	[プロチップ] – エンドユーザーにとって重要な情報をマークするために使用します。ユーザーによる操作は不要です。
	[注釈] – エンドユーザー向けの情報をマークするために使用されます。ユーザーによる操作は不要です。

コンポーネント プロパティ

それぞれのコンポーネントに設定可能なプロパティは以下の通りです。

注：すべてのプロパティがすべてのコンポーネントに対して有効であるとは限りません。マッピングについては、プロパティマトリックスを参照してください。

コンポーネントマッピング

プロパティ

ベーシック

詳細

ダイアログ ノード

以下のマッピングは、デジタルフォームから自動生成されたときにサブダイアログに含まれるエンティティのタイプを示しています。

コンテキストオブジェクト

以下のマッピングは、サンプルコンテキストオブジェクトとともにコンポーネント値を取得するためのコンテキストオブジェクトを提供します。

制限事項

• 以下のチャネルでは、デジタルフォームは予測通りに動作しません。
  • Amazon Alexa
  • Cisco Jabber
  • Google Assistant
  • IVR Voice
  • Twilio Voice

  これらのチャネルの会話体験を選択することをお勧めします。

• 親Botで作成されたデジタルフォームは、スマートBotには引き継がれません。
• デジタルフォームの機能は、ユニバーサルBotには適用されません。