Documentation Index

Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

会話キャンバス

Prev Next

Classic/VPC環境で利用できます。

会話キャンバスは、会話フローを素早く簡単に作成できる機能です。会話キャンバスは、AiCallの会話フローを設計するのに役立ちます。会話リストでは会話フローを把握するのが難しかった場合でも、会話キャンバスを利用することで会話フローを一目で把握できるため、より効率的に会話を作成することができます。FAQ形式の会話を作成する場合よりも、フローが明確な会話を作成する必要がある場合、会話キャンバスをより有効に活用できます。

注意
  • 会話キャンバスは、Internet Explorerブラウザではサポートされていません。
  • AiCallドメインの場合にのみ、会話キャンバスのメニューが有効になります。
  • 会話キャンバスでは、画像、選択肢型、スタンプ、flex返答、JSONといった回答タイプはサポートされていません。当該回答タイプに関する設定は「エクスポート」を行った後、会話リストで再度タスクを行うことをお勧めします。
  • 会話キャンバスからエクスポートする場合、既存の会話リストに追加された内容が削除され、会話キャンバスで編集した内容で上書きされることがあります。そのため、会話リストで追加タスクを行った場合は、必ず会話キャンバスに「インポート」を行った上で、再度「エクスポート」を行うことをお勧めします。

会話キャンバスのタスク手順

1.事前タスク
エンティティ、ユーザー変数、アクションメソッドなどに関する企画および設定が完了している必要があります。

2.ドメイン作成
チャットボットサービスを作成するために、ドメインを作成します。ドメイン作成時に AiCallを選択することで、会話キャンバスメニューが有効になります。

3.会話キャンバス作成
会話キャンバスで会話の作成とリンクを行います。作成されたダイアログボックスをリンクして会話フローを設計し、会話フローをアクティビティ単位に分割して会話をグループ化できます。1つの会話グループに推奨されるボックスの数は50個以下です。1つの会話グループ内に100個以上の会話を作成すると、ロードに時間がかかる場合があります。
* 過去に登録された会話がある場合は、 [インポート] ボタンをクリックして会話をインポートした上で作成します。
* ダイアログボックスの追加方法については、ダイアログボックス追加をご参照ください。

4.会話リストへのエクスポート
会話キャンバスで作成した内容を保存した後、会話リストにエクスポートします。会話リストを「エクスポート」した後、会話リストでユーザーの質問を追加したり、コンテキストの詳細設定(保持、削除)、システムエラーメッセージの設定、JSONの入力などの追加タスクを行うことができます。

参考

会話キャンバスでは、画像、選択肢型、スタンプ、flex返答、JSONといった回答タイプはサポートされていません。

会話キャンバスの画面構成

会話キャンバスの画面構成と各項目に関する説明は、次の通りです。
chatbot-chatbot-2-7_canvas01_ko

領域 説明
① メニュー
  • ファイル
    • 保存(Ctrl+s / Cmd+s): 現在タスク中の内容を保存(自動保存機能もサポート、保存後に「エクスポート」することを推奨)。
    • 新しい会話グループ: 新しい会話グループを作成し、他の会話グループとリンク可能
    • エクスポート: 現在の会話キャンバスの内容をチャットボットの会話リストにエクスポート
      エクスポートを行うと会話リストの内容が上書きされてしまうため、会話リストをインポートした後にエクスポートすることを推奨
      サポートされていない回答タイプ(画像、選択肢型、スタンプ、flex返答、json)は削除されることがある
    • インポート: チャットボットの会話リストにある内容を会話キャンバスにインポート
      会話のレイアウトが一部再調整されることがある
      回答タイプのうち、画像、選択肢型、スタンプ、flex返答、jsonはインポート機能をサポートしない
  • 変更
  • 元に戻す、やり直し、コピー、切り取り、貼り付けといった一般的な編集タスクが可能
  • ソート
    • キャンバス拡大(Ctrl + スクロールアップ / Ctrl + スクロールアップ)
    • キャンバス縮小(Ctrl + スクロールダウン / Ctrl + スクロールダウン)
    • 自動ソート: 自動的にレイアウトをソート
    • 画面最適化: ボックスサイズが自動的に調整され、すべてのダイアログボックスが1つの画面に表示
    • 矢印を一番前へ: 矢印をダイアログボックスの前にソート
    • 矢印を一番後ろへ: 矢印をダイアログボックスの後ろにソート
② 会話グループタブ フローがリンクされる会話をまとめたグループ
+(ボックス追加) 会話キャンバスにボックスを追加可能
会話名で検索 会話名を入力して会話を検索可能
インポート 会話リストでタスクを行った内容を会話キャンバスにインポート
エクスポート 会話キャンバスの会話を会話リストにエクスポート
履歴 会話の「エクスポート」および「インポート」のタスク履歴を確認可能
⑧ タブ検索 タブ名を入力してタブを検索可能

会話グループタブ
会話グループでは、ページごとにスペースを分けたり、フローがリンクされている会話を会話グループとしてまとめて管理できます。会話グループを追加しない場合、すべての会話はデフォルトで「Home」グループに属します。「Home」グループは変更または削除できません。

  • [Home] タブの横にある [+] ボタンをクリックすると、「会話グループ 1」が作成されます。
  • グループ名はダブルクリックすると変更でき、一意に設定する必要があります。
  • 各タブの右側にある [x] ボタンをクリックすると、その会話グループが削除され、グループ内のすべての会話が削除されます。
  • 会話グループの位置を変更するには、 [会話グループ] タブをドラッグして、目的の位置に配置します。
  • 会話グループの数が増えた場合は、 [< >] ボタンをクリックして会話グループを照会できます。
  • [会話グループ] タブの右側にある [⠇] ボタンをクリックすると、会話グループを検索できます。

インポート
ドメインの会話リストに追加されたすべての会話をインポートするには、 [インポート] ボタンをクリックします。

  • 会話リストで変更、削除した後に「インポート」を行うと、会話キャンバスに同様に反映される項目は、ツールボックス(通話終了、番号リンク)、Edit Panel(条件、ユーザー変数、待機)となります。
  • 追加されたデータのみアップデートされます。変更や削除が必要な場合、会話キャンバス上で直接削除できる項目は、会話グループ、ダイアログボックス(ウェルカムメッセージ/無応答/失敗メッセージ、一般会話、システムレスポンス)、ツールボックス(コンテキスト、会話リンク)、Edit Panel(ユーザー発話、システムレスポンス)となります。
  • サポートされていない回答タイプは「インポート」できないため、当該項目に関するタスクは最終的な「エクスポート」後に実施することをお勧めします。
  • 「インポート」時に会話グループ当たりの推奨されるボックスの数は50個以下です。1つの会話グループ内に100個以上の会話を作成すると、ロードに時間がかかる場合があります。

エクスポート
会話キャンバスに追加されたすべての会話を会話リストにエクスポートするには、 [エクスポート] ボタンをクリックします。

  • 会話キャンバスに登録された会話が、会話リストに登録されている会話を上書きします。
  • 会話リストにはあっても会話キャンバスにはない会話や、現在サポートされていないタイプの回答は削除されます。したがって、会話リストで追加タスクを行った場合は、必ず会話キャンバスに「インポート」を行った上で、再度「エクスポート」を行うことをお勧めします。
  • 画像、選択肢型、スタンプ、FLEX返答、JSONといった回答タイプはサポートされていません。

履歴
失敗した履歴の [詳細] ボタンをクリックすると、ポップアップをキャンバス内で自由に移動させながら、エクスポート/インポートで失敗した内容を変更できます。
chatbot-chatbot-2-7_failhistory_ko.png

ダイアログボックス追加

共通編集方法

ダイアログボックスを追加した後、追加したダイアログボックスをリンクして会話フローを作成できます。ボックスを追加するには、会話キャンバスの左上にある [+] をクリックし、追加したいボックスを選択してから会話キャンバスにドラッグ&ドロップします。

Edit panel
作成されたボックスをクリックすると、質問と回答を入力できる Edit panelが右側に表示されます。

ボックスリンク
ボックスとボックスのリンクは、outputコンテキストで矢印をリンクするか、登録済みの回答から矢印でリンクできます。

  • 一般会話(共通メッセージ)-一般会話(共通メッセージ): output contextから一般会話ボックスへリンク
  • 一般会話(共通メッセージ)-システムレスポンス: 回答からシステムレスポンスボックスへリンク
  • 一般会話(共通メッセージ)-会話リンク: 回答 /outputコンテキストでは、会話リンクボックスの両方にリンク可能
  • 一般会話(共通メッセージ)-コンテキスト: outputコンテキストからコンテキストボックスへリンク
  • 一般会話(共通メッセージ)-番号リンク/通話終了: 回答からリンク/終了ボックスへリンク
  • システムレスポンス-システムレスポンス: 回答からシステムレスポンスボックスへリンク
  • システムレスポンス-一般会話(共通メッセージ): outputコンテキストから一般会話ボックスへリンク

複数選択
ダイアログボックスとノートコンポーネントを複数選択できます。[Shift] キーを押したままマウスポインタをドラッグすると、複数のボックスを選択できます。
chatbot-chatbot-2-7_multi01_ko.png

一般会話追加

会話キャンバスにダイアログボックスを追加し、会話の内容を構成できます。各項目についての詳細な説明は、会話作成をご参照ください。
会話キャンバスで一般会話を追加する方法は、次の通りです。

  1. チャットボットビルダの会話キャンバス > [+] (ボックス追加)ボタンをクリックします。
  2. ボックスリストから一般会話をドラッグして、キャンバスにドロップします。
    • 画面右側に Edit panelが表示されます。
  3. [ユーザー発話] タブに質問を入力した後、 [質問追加] ボタンをクリックします。
    • 一般質問、正規表現質問、インテントのタイプを選択できます。
    • 登録された質問を削除したい場合は、 [⠇] アイコンをクリックし、 [削除] ボタンをクリックします。
    • 入力項目に関する説明は、質問登録をご参照ください。
  4. [システムレスポンス] タブの回答領域に回答を入力します。
    • 現在、会話キャンバスでサポートされている回答タイプは、テキストを入力できる「基本回答」、オーディオを登録できる「オーディオ回答」、回答を行わず条件とユーザー変数を確認する「回答なし」です。
    • [新しい吹き出しを追加] をクリックすると、連続した吹き出しで回答でき、最大20個の吹き出しを追加できます。
  5. [システムレスポンス] タブの条件項目では、回答に対して ANDや ORの論理式を用いて様々な条件を設定できます。
    • 5つの AND条件と10つの OR条件、最大50個の条件を設定できます。条件が設定された回答は条件が設定されていない回答よりも優先して返され、条件を満たす回答がない場合は失敗のレスポンスが返されることがあります。
    • 入力項目についての説明は、回答条件設定をご参照ください。
  6. ユーザー変数項目では、会話セッション内でユーザーとの会話を通じて得られた情報を変数として管理できます。
    • 会話キャンバスでユーザー変数を設定する前に、チャットボットビルダの左側メニューにある [ユーザー変数] メニューの [追加] ボタンをクリックして、ユーザー変数を作成しておく必要があります。ユーザー変数を作成した後、会話キャンバスでそのユーザー変数を設定できます。設定されたユーザー変数は、当該回答がレスポンスされる時点でアップデートされます。
    • ユーザー変数を変更するには登録済みのユーザー変数をクリックして変更し、ユーザー変数を削除するには [x] ボタンをクリックします。条件を追加するには、 [ADD] ボタンをクリックします。
  7. 待機項目では、チャットボットが回答をレスポンスした後の動作を設定できます。
    • 音声認識モードを選択した場合、チャットボットはユーザーからのレスポンスがあるまで待機します。設定された待機時間が経過してもユーザーから何らかの入力がなかった場合、共通メッセージの無応答メッセージでレスポンスを返します。
    • キーパッド認識モードを選択した場合、チャットボットはユーザーからのキーパッド入力があるまで待機します。設定された待機時間が経過してもユーザーから何らかの入力がなかった場合、共通メッセージの失敗メッセージでレスポンスを返します。
    • 選択なしを選択した場合、ユーザーが何も入力しなかった場合でもチャットボットは無応答メッセージでレスポンスを返しません。
  8. 回答フィールドの旗アイコンは「マーカー設定」です。
    • マーカーは、 [チャットボット設定] で会話ログの一時保存を「保存」に設定した場合に表示されます。
    • マーカー設定を有効にすることで、${`previousChatbot} built in アクションメソッドが呼び出された時点で、その会話の回答やコンテキストを活用できます。回答の一部である吹き出しでマーカーが無効になっている場合、その吹き出しは対象から除外されます。
    • ${`previousChatbot} built in アクションメソッドの詳細は、アクションメソッドガイドをご参照ください。
  9. すべての回答設定が終わったら、 [回答追加] ボタンをクリックします。
    • 登録済みの回答を削除したい場合は、⠇アイコンをクリックした後、 [削除] ボタンをクリックします。
    • 登録済みの回答を変更したい場合は、回答を変更した後に会話キャンバス領域をクリックします。

システムレスポンス追加

システムレスポンスとは、チャットボットがレスポンスした後、ユーザーの次の入力を待たずにすぐチャットボットのレスポンスを続ける機能です。会話の主導権をユーザーに譲らず、チャットボットが保持しようとする場合に使用します。

  • 会話キャンバスにインポートしたシステムレスポンスボックスをクリックすると、画面右側の Edit panelで変更できます。
  • [システムレスポンス] タブで回答を入力できます。
  • 他のダイアログボックスとシステムレスポンスをリンクする場合、コンテキスト動作は考慮されません。したがって、一般会話-システムレスポンス、またはシステムレスポンス-システムレスポンス間の矢印リンクは、Outputコンテキストではなく回答からボックスへとリンクできます。

例)
chatbot-chatbot-2-7_system01_ko

タスクダイアログ

タスクダイアログは、ユーザーの発話から情報を収集し、簡単な予約や宅配便の照会などのタスクを実行する機能です。

  1. 会話キャンバスで、タスクダイアログボックスをクリックします。画面右側の Edit panelで変更できます。
  2. [タスク] タブでスロット情報を設定します。
    • スロット名: スロットの名前を入力します。 当該タスク内で、重複しない値を入力します。
    • エンティティ: スロットに受け取るエンティティを選択します。ドメインエンティティとシステムエンティティの両方を活用できます。
    • 値: ユーザーが埋めたスロットの値を、最終的な回答に挿入して回答できます。埋まったスロットの値を使用するための表現式を入力します。
    • 確認質問: スロットを埋めるための確認質問を入力します。チャットボットは、リストされたスロットの順序に従って確認質問に回答し、スロットを埋めていきます。
    • 必須ボタン: チェックボックスをクリックして、必須スロットとオプションスロットの設定を切り替えることができます。必須スロットが埋まっていないタスクは実行に失敗し、最終的な回答はレスポンスされません。一方、オプションスロットはユーザーが情報を入力しなくても、タスクに失敗することなく実行できます。
    • 現在、タスクダイアログの「その他の設定」は、会話キャンバスではサポートされていません。
  3. システムレスポンスに最終的な回答を登録します。
    • 必須スロットがすべて埋まると、チャットボットは最終的な回答をレスポンスします。
    • スロット値の表現式を活用することで、ユーザーの発話に基づいた回答をレスポンスできます。回答入力欄に値をそのまま入力すると、ユーザーが入力したスロットの内容がそのままインポートされ、チャットボットがレスポンスすることになります。
      chatbot-chatbot-2-7_task01_ko.png

失敗メッセージ追加

ユーザーの質問に対する回答が見つからない場合は、代わりにレスポンスする失敗メッセージを作成できます。

  1. チャットボットビルダの会話キャンバス > [+] (ボックス追加)ボタンをクリックします。
  2. ボックスリストから失敗メッセージをドラッグ&ドロップして、キャンバス上に配置します。
    • 画面右側に Edit panelが表示されます。
  3. 基本回答、条件、ユーザー変数、待機設定を完了したら、 [回答追加] ボタンをクリックします。
参考
  • 会話キャンバスでサポートされている回答タイプは、テキストを入力できる「基本回答」、オーディオを登録できる「オーディオ回答」、回答を行わず条件とユーザー変数を確認する「回答なし」です。
  • システムエラーにより回答をレスポンスできない場合の代替となる「システムエラーメッセージ」は、会話キャンバスでは作成できません。チャットボットビルダの [共通メッセージ] メニューから追加してください。

例)
chatbot-chatbot-2-7_fail01_ko.png

ウェルカムメッセージ追加

ウェルカムメッセージとは、会話が始まった際にチャットボットがユーザーに送る最初のメッセージのことです。
会話キャンバスでウェルカムメッセージを追加する方法は、次の通りです。

  1. チャットボットビルダの会話キャンバス > [+] (ボックス追加)ボタンをクリックします。
  2. ボックスリストからウェルカムメッセージをドラッグ&ドロップして、キャンバス上に配置します。
    • 画面右側に Edit panelが表示されます。
  3. 基本回答、条件、ユーザー変数、待機設定を完了したら、 [回答追加] ボタンをクリックします。
参考
  • ウェルカムメッセージは、他のダイアログボックスや Outputコンテキストの矢印とリンクできますが、他のダイアログボックスからウェルカムメッセージへ矢印でリンクすることはできません。
  • 会話キャンバスでサポートされている回答タイプは、テキストを入力できる「基本回答」、オーディオを登録できる「オーディオ回答」、回答を行わず条件とユーザー変数を確認する「回答なし」です。

例)
chatbot-chatbot-2-7_welcom01_ko.png

無応答メッセージ追加

ユーザーとの通話中、指定された音声入力待機時間内にユーザーから何も発話がない場合、ユーザーの発話を促す無応答メッセージを設定できます。
会話キャンバスで無応答メッセージを追加する方法は、次の通りです。

  1. チャットボットビルダの会話キャンバス > [+] (ボックス追加)ボタンをクリックします。
  2. ボックスリストから無応答メッセージをドラッグ&ドロップして、キャンバス上に配置します。
    • 画面右側に Edit panelが表示されます。
  3. 基本回答と条件、ユーザー変数、待機設定を完了したら、 [回答追加] ボタンをクリックします。

例)
chatbot-chatbot-2-7_noreponse01_ko.png

会話リンク追加

会話リンクは、別の会話グループの会話へ移動したり、同じ会話グループ内でも位置の関係で矢印でのリンクが難しい会話へのリンクを表示します。会話リンクボックスは、設定した会話の代理としてのロールを果たします。
会話キャンバスにインポートした「会話リンク」ボックスをクリックし、右側の Edit panelでリンクしたい「会話グループ」と「会話名」を設定します。この際、「会話グループ」を先に選択すると、その「会話グループ」内の「会話名」を照会して選択でき、「会話名」欄からリンクする「会話名」を直接照会して入力することも可能です。
リンクしたいダイアログボックスで、矢印をクリックして会話リンクボックスとリンクします。会話リンクボックスに設定された会話に対しても、どの会話とリンクされているかを表示するセットリンクボックスが自動的に作成されます。会話リンクの設定が変更されたり削除されると、セットリンクボックスにも自動的に反映されます。

参考
  • リンクされた会話グループが削除されると、会話リンクも削除されます。
  • 会話リンクボックスやセットリンクボックスをダブルクリックすると、リンク先の会話に移動します。
  • 同じ会話にリンクされているリンクボックスが増えた場合、セットリンクボックスにはリンクされている会話の数が表示され、右側の Edit panelにはリンクされている会話のリストが表示されます。

例)
chatbot-chatbot-2-7_link_ko.png

コンテキスト追加

コンテキスト名を自分で設定したい場合や、矢印をまとめて1つのコンテキストであることを示したい場合は、コンテキストボックスを直接追加して使用します。会話を矢印でリンクするとコンテキストを作成できますが、この場合コンテキスト名はチャットボットによって任意に付与されます。
chatbot-chatbot-2-7_context_ko.png

参考
  • コンテキストの保持、追加、削除は、会話キャンバスではサポートされていません。チャットボットに「エクスポート」を行った後、会話リストでタスクを行うことをお勧めします。
  • 会話キャンバスにインポートした「コンテキスト」ボックスをクリックすると、右側の Edit panelでコンテキスト名を直接入力できます。
  • コンテキストをリンクしたい前後の会話を「コンテキスト」ボックスにリンクします。

番号リンク

会話の事後動作 > 番号リンクと同じ機能です。会話を続けている途中で電話をつなぐ必要がある場合に使用します。

  1. 会話キャンバスに表示された「番号リンク」ボックスをクリックし、右側の Edit panelでリンクする電話番号を入力します。
  2. 電話をつなげたいダイアログボックスの「システムレスポンス」欄から、「番号リンク」ボックスへ矢印をリンクします。
    chatbot-chatbot-2-7_phonecall_ko.png

通話終了

会話の事後動作 > 通話終了と同じ機能で、これ以上会話を続ける必要がなく、通話を終了したい場合に使用します。通話を終了したい会話ボックスの「システムレスポンス」欄から、会話キャンバスにインポートした「通話終了」ボックスへ矢印をリンクします。
chatbot-chatbot-2-7_endofcall_ko.png

ノート

特定の会話に対するタスク案内文を追加したり、変更内容に関するメモを残したりするなど、ユーザーの目的に合わせて様々な用途に活用できます。ダブルクリックすると、テキストを変更したりノートの色を変更できます。

  • ノートをクリックすると、右上に編集アイコンが表示されます。ゴミ箱のアイコンをタップすると削除できます。
  • ノートの右下をクリックしてドラッグ&ドロップすると、ノートのサイズを変更できます。
    chatbot-chatbot-2-7_note_ko.png