コンポーネント

コンポーネントは、特定のタスクを実行する再利用可能なブロックです。特定の入力を取得し、入力を処理し、構造化された出力を提供します。

コンポーネントは Answers で構築され、Answers チャットボットと同じビルディングブロックを使用します。したがって、チャットボットの小型バージョンです。チャットボットなどの複数のソリューションに統合できます。

例: エンドユーザー認証を行い、フィードバックを収集し、FAQ に回答するための個別のコンポーネントを作成し、複数の NTT CPaaS ソリューションで使用します。

コンポーネントは、チャットボットなどのソリューション内でのみ使用できます。

コンポーネントの利点

再利用性: チャットボットの一部のセクションは、同じチャットボットまたは複数のチャットボットで繰り返される場合があります。同じセクションを複数の場所に再作成する代わりに、コンポーネントを作成し、必要な場所で使用します。

同じソリューション内または複数のソリューション内でコンポーネントを使用できる回数に制限はありません。

より簡単な更新: 変更を加える必要がある場合は、コンポーネントが使用されているソリューションではなく、コンポーネントを更新します。変更は、コンポーネントが使用されている場所に自動的に適用されます。これにより、時間が節約され、一貫性が向上します。

メンテナンスとトラブルシューティングの簡素化: 大規模なタスクを複数のコンポーネントに分割します。各コンポーネントは特定のタスクに焦点を当てているため、メンテナンスとトラブルシューティングが容易になります。

ソリューション設計の簡素化: コンポーネントは、ソリューションの設計を簡略化するのに役立ちます。例: コンポーネントを使用すると、チャットボットに必要なダイアログの数を減らすことができます。

プラットフォームに依存しない: コンポーネントは、Answers チャットボットなどの複数の NTT CPaaS ソリューションで使用できます。

コラボレーションのサポート: コンポーネントはモジュール式であるため、異なるユーザーが別々のコンポーネントで同時に作業できます。その後、これらのコンポーネントをソリューションに追加できます。

NTT CPaaS ソリューションでコンポーネントを使用する

積	使用方法	例
答え	- Answersでコンポーネントを作成します。 - チャットボットのコンポーネントを使用して、特定のタスクを実行します。	コンポーネントを作成して、ユーザー情報の検証や最寄りの店舗の場所の提供など、さまざまなタスクを実行します。

コンポーネントのしくみ

プロセスの概要

コンポーネントは Answers で作成されます。
Answers チャットボットなどの NTT CPaaS ソリューションがコンポーネントを呼び出します。
コンポーネントは、ソリューションから入力値を受け取ります。
コンポーネントは入力を処理し、出力を生成します。
コンポーネントは、出力値をソリューションに返します。
その後、ソリューションはこれらの値を使用してさらに処理するか、エンドユーザーと共有します。

コンポーネントの種類

コンポーネントには、次のタイプがあります。

チャネルにとらわれない
チャネル固有

チャネルにとらわれない

チャネル非依存型コンポーネントは、特定の通信チャネルに依存しません。これらは、チャネルに関係なく、サポートされているすべてのソリューションで使用できます。

これらのコンポーネントには、Send 要素は含まれていません。そのため、メッセージを送受信することはできません。ただし、他のタイプの処理を実行することはできます。

チャネル固有

チャネル固有のコンポーネントは、特定の通信チャネル用にチャネル用に設計されています。これらは、コンポーネントと同じチャネルを持つサポートされているソリューションでのみ使用できます。

これらのコンポーネントには Send 要素が含まれています。そのため、メッセージを送受信できます。

チャットボットとコンポーネントの違い

コンポーネントは、チャットボットの小さいバージョンです。以下は、チャットボットとコンポーネントの違いです。

チャットボット	コンポーネント
複数のタスクを実行できる	特定のタスクを実行する
Answers 要素を使用します	コンポーネントには、Answers 要素に加えて、コンポーネントの結果を返す Exit エレメントがあります。
ユーザー向けソリューション	エンドユーザーと直接対話しません。ソリューションから入力を取得し、出力をソリューションに返します。
チャネル固有	チャネル固有またはチャネルに依存しない
送信者がいる	送信者なし
インテントがある	インテントなし

「コンポーネント」タブ

チャットボット > コンポーネントタブでは、すべてのコンポーネントを表示および管理できます。

次の操作を行えます。

コンポーネントのリストを表示します。各コンポーネントには、次の情報が表示されます。
- 名前: コンポーネントの名前。
- ステータス: コンポーネントが 公開済み または ドラフト ステータスのいずれであるかを示します。
- 最終更新日: コンポーネントが最後に更新された日付。
- 作成者: コンポーネント作成者の名前と作成日。
コンポーネントを並べ替えます。並べ替える列ヘッダーを選択します。
コンポーネントの作成。
インポートは、設定やセットアップなど、以前にエクスポートされたコンポーネントです。
編集、重複、エクスポート、および削除コンポーネント。
コンポーネントを検索します。検索ボックスを使用します。

Answersでコンポーネントを作成する

コンポーネントは Answers で構築されます。コンポーネントを作成するプロセスは、Answers チャットボットを作成するプロセスと似ています。

プロセスの概要

次のいずれかの方法を使用して、下書きコンポーネントを作成します。
- 手動を作成します。
- 既存のチャットボットのダイアログからを作成します。
入出力属性の作成をコンポーネントに追加します。コンポーネントはチャットボットから入力を取得し、これらの属性を介して出力を渡します。
デザインコンポーネント。
settingsを構成します。
テストコンポーネント。
公開コンポーネント。
チャットボットでコンポーネントを使用する。

ドラフトコンポーネントを手動で作成する

ドラフト構成部品を手動で作成するには、次の操作を行います。

NTT CPaaS Web インターフェイス (opens in a new tab)で、Answers > チャットボット >コンポーネント タブに移動します。
[コンポーネントの作成] を選択します。
新しいコンポーネント 画面で、次のフィールドに入力します。
- コンポーネント名: 一意の名前を入力します。
- チャンネル
  - チャネル固有のコンポーネントを作成するには、必要なチャネルを選択します。
  - チャネルに依存しないコンポーネントを作成するには、[任意のチャネル] を選択します。
[コンポーネントの作成] を選択します。

新しいコンポーネントが作成され、[ダイアログ]タブで開きます。Default ダイアログには、Start ダイアログブロックが含まれています。

既存のチャットボットダイアログから下書きコンポーネントを作成する

既存のチャットボットで特定のダイアログとダイアロググループを選択して、下書きコンポーネントを作成します。

コンポーネントに含まれるもの

このコンポーネントには、ソースチャットボットからの次のチャットボット構成要素が含まれています。

ダイアログ: 選択したダイアログとダイアロググループ
備考
デフォルトダイアログはコピーされません。コンポーネントには、Start ブロックを含む新しい Default ダイアログがあります。
チャットボットの構成要素: 選択したダイアログで使用される場合、以下が含まれます。これらのダイアログで使用されていないチャットボットの構成要素は、テンプレートに追加されません。
- キーワードと同義語
- 属性
設定: コンポーネントにも適用されるチャットボット設定。コンポーネントで使用できないチャットボット設定はコピーされません。

ドラフトコンポーネントを作成する

NTT CPaaS Web インターフェイス (opens in a new tab)で、Answers > チャットボット に移動します。
コンポーネントを作成するチャットボットを開きます。
コンポーネントに追加する 1 つ以上のダイアログとダイアロググループを選択します。すべてのダイアログとダイアロググループを選択するには、すべて選択を使用します。
[コンポーネントの作成] を選択します。
コンポーネントの作成画面で、次のフィールドに入力します。
- コンポーネント名: 一意の名前を入力します。
- チャンネル
  - 選択したダイアログの 1 つ以上にチャネル固有の要素が含まれている場合は、チャネルを変更できません。このコンポーネントは、チャットボットと同じチャネルを使用します。
  - 選択したダイアログにチャンネル固有の要素が含まれていない場合は、チャットボットとは異なるチャンネルを選択できます。
    - チャネル固有のコンポーネントを作成するには、必要なチャネルを選択します。
      備考
      現在、WhatsApp、Live Chat、Messenger、または Telegram にのみ変更できます。
    - チャネルに依存しないコンポーネントを作成するには、[任意のチャネル] を選択します。
[コンポーネントの作成] を選択します。

新しいドラフト構成部品が作成され、「ダイアログ」(Dialogs) タブで開きます。Default ダイアログには、Start ダイアログブロックが含まれています。

コンポーネントの入力属性と出力属性を作成する

コンポーネントはチャットボットから入力を取得し、出力を返します。

属性タブで、コンポーネントに必要な入力と出力の attributes を作成します。また、コンポーネントで使用されるその他の属性も作成します。

次の操作を行います。

属性の追加 を選択します。
[属性の作成] ウィンドウで、次のフィールドを設定します。
- 名前: 各属性には一意の名前が必要です。
- タイプ: 属性のデータタイプ。
- 既定値 (オプション): 属性の既定値を指定します。
- スコープ: 次のいずれかを選択します。
  - ダイアログ: 属性値はダイアログに固有です。この属性を他のダイアログで使用する場合、それらのダイアログの属性値はデフォルト値または空白のいずれかになります。
    
    例: opt_in 属性のデフォルト値は False です。特定のダイアログでは、opt_in 属性値が True に変わります。ただし、他のすべてのダイアログでは、属性のデフォルト値 False のままです。
  - コンポーネント: 属性値は、コンポーネント内のすべてのダイアログで同じです。
    
    例: opt_in 属性のデフォルト値は False です。特定のダイアログでは、opt_in 属性値が True に変わります。他のすべてのダイアログでは、属性の値は True になります。
- エージェントが利用可能: このフィールドを選択すると、チャットがチャットボットからConversationsのエージェントに転送されるときに、属性値がエージェントに表示されます。Conversations では、属性値は会話のコンテクストカードと会話履歴に表示されます。
  
  機密データ も選択した場合、属性値は Answers と Conversations にハッシュ値として表示されます。
  
  エージェントから属性値を非表示にするには、このフィールドの選択を解除します。
  
  例: accountId 属性の場合、エージェントが利用可能 フィールドが有効になっています。したがって、Conversations では、次の図に示すように、この属性がコンテクストカードに表示されます。
- 機密データ: このフィールドを選択すると、デフォルト値を含む属性値がデータベースに格納されるときに暗号化されます。これは、Answers と Conversations にハッシュデータとして表示されます。
  
  例:メッセージは次のように表示されます。
  
  このフィールドが無効になっている場合: *アカウント残高は 2123.32 です。
  
  このフィールドが有効な場合: *アカウント残高は ####.## です。
  
  属性に機密データが含まれている場合は、このフィールドを使用します。この設定は、チャットがライブエージェントに転送される場合に特に便利です。
  
  この設定は、送信メッセージに存在する機密属性にのみ適用されます。
[保存] を選択します。

属性は属性タブに一覧表示されます。

コンポーネントを設計する

チャットボットと同様に、コンポーネントには 1 つ以上のダイアログが含まれています。これらのダイアログは連携してタスクを実行します。

デフォルト ダイアログがコンポーネントに自動的に追加されます。他のダイアログ関連のタスクに加えて、デフォルト ダイアログは、チャットボットから入力値を取得するために使用されます。

ダイアログをデザインするには、次の操作を行います。

(既定のダイアログのみ)デフォルトダイアログ>Startダイアログブロックで、作成した必要な入力属性を選択します。
必要に応じて elements を追加して、ダイアログを設定します。
ダイアログの最後に、終了エレメントまたは 終了] ダイアログ エレメントを追加します。各ダイアログには、これらの要素のいずれかが必要です。

Exit エレメントはコンポーネント処理を終了し、出力属性の値をチャットボットに渡します。したがって、このエレメントを関連するダイアログに追加します。
「終了」エレメントで、必要な出力属性を選択します。

備考
選択した出力属性は、コンポーネント内のすべての Exit 要素で使用されます。1 つの Exit エレメントで出力属性を更新すると、変更はすべての Exit 要素に適用されます。

Image that shows an example of a component dialog

コンポーネント設定を構成する

コンポーネント設定を構成します。

コンポーネントをテストする

テスト テストタブのコンポーネント。

テストタブに移動します。
入力属性の値を入力します。
Start simulation を選択します。
ダイアログ開始などの構成要素を選択すると、右側のパネルに処理が表示されます。[終了] を選択して、出力属性の値を表示します。

シミュレーションを再開する

シミュレーションは、次のように再開できます。

同じ入力値を使用するには、シミュレーションの再起動を選択します。
異なる入力値を使用するには、[入力値の変更] を選択します。

コンポーネントを公開する

公開を選択します。

重要

同じコンポーネント ID を持つ既存の公開済みコンポーネントがある場合、そのコンポーネントは非公開になります。新しいコンポーネントは、それが使用されるすべてのソリューションで既存のコンポーネントを置き換えます。

コンポーネント設定

コンポーネント名: コンポーネントを説明する一意の名前を使用します。
コンポーネントの説明 (オプション): コンポーネントの説明を追加します。[テキスト] アイコンを選択して、フォントサイズや見出しなどの書式設定を使用します。
コンポーネント ID: 既定では、コンポーネント ID が作成されます。ID は、手動または自動で更新するには、[生成] を選択します。
Voice メッセージ: コンポーネントで音声機能を使用します。

この設定は、メッセージング要素を含むチャネル固有のコンポーネントに適用されます。
コンポーネントのタイムアウト: コンポーネントが内部処理の結果または API 呼び出しからの応答を待機する時間を構成します。このフィールドには、5 分の事前定義値があります。
トラッキングと URL 短縮: メッセージにリンク(URL)が含まれている場合は、URL を短縮して URL のクリックをトラッキングできます。

ソリューションでコンポーネントを使用する

コンポーネントの作成をAnswersで作成します。
コンポーネントに入力(Input)属性と出力(Output)属性を作成します。
Answers チャットボットなどのサポートされているソリューションでは、コンポーネントを呼び出す。
ソリューションでは、入力属性を使用してコンポーネントに入力を提供します。
コンポーネントは入力を処理し、出力を生成します。
コンポーネントは、出力属性を介して出力を返します。

Answers チャットボットでコンポーネントを使用する

チャットボットで、コンポーネント エレメントを追加します。
エレメントで、コンポーネントを選択します。

重要
チャットボットと同じチャネルを持つコンポーネントのみ追加できます。

このエレメントには、選択したコンポーネントで使用される入力属性と出力属性が表示されます。
入力属性の値を入力します。
コンポーネントの出力属性をチャットボット属性にマッピングします。
エラーを管理するためのフォールバックを設定します。例: コンポーネントの呼び出しに失敗するか、コンポーネント処理が失敗します。

このような場合、フォールバックアクションがトリガーされます。

詳細については、フォールバックドキュメントをご参照ください。
ユースケースと要件を満たすようにチャットボットを構成します。
テスト > シミュレーター タブでコンポーネントの機能をテストします。

コンポーネントの開始 フィールドには、コンポーネントの入力が表示されます。

その他の項目は、コンポーネント内の処理を示します。

コンポーネント終了 フィールドには、コンポーネントからの出力が表示されます。
チャットボットをアクティブ化します。

重要
選択したコンポーネントが削除された場合は、チャットボットをアクティブ化する前に、別のコンポーネントを使用するか、コンポーネントエレメントを削除する必要があります。
選択したコンポーネントが公開されていない場合は、チャットボットをアクティブ化する前に公開する必要があります。

コンポーネントの管理

コンポーネントの編集

コンポーネントを編集するには、[コンポーネント] タブに移動します。コンポーネントの横にある 3 つのドットを選択し、[編集] を選択します。

備考

公開済み コンポーネントは編集できません。duplicate または unpublish のいずれかです。

コンポーネントの削除

コンポーネントを削除するには、[コンポーネント] タブに移動します。コンポーネントの横にある 3 つのドットを選択し、[削除] を選択します。

備考

公開済み コンポーネントは削除できません。duplicate または unpublish のいずれかです。
コンポーネントを削除した後、そのコンポーネントが使用されているすべてのソリューションでコンポーネントへの参照を削除します。

コンポーネントの非公開

コンポーネントを非公開にすると、ソリューションで選択できなくなります。ステータスが 公開済み から ドラフト に変わります。

コンポーネントで 非公開 を選択します。

備考

アクティブなソリューションで使用されているコンポーネントを非公開にすることはできません。コンポーネントを duplicate するか、そのコンポーネントが使用されているすべてのソリューションから削除します。

例: コンポーネントがアクティブなチャットボットで使用されている場合は、チャットボットを非アクティブ化し、チャットボット内のコンポーネントを削除または置き換えてから、チャットボットをアクティブ化します。

コンポーネントの複製

既存のコンポーネントに類似した新しいコンポーネントを作成する場合は、[複製] オプションを使用します。これにより、コンポーネントを最初から作成する必要がないため、コンポーネントの作成にかかる時間が短縮されます。その後、複製したコンポーネントを要件に合わせて変更できます。

コンポーネントを複製するには、次の手順に従います。

[コンポーネント] タブに移動します。
次のいずれかの操作を行います。
- コンポーネントの横にある 3 つのドットを選択し、[複製] を選択します。
- コンポーネントを開き、複製を選択します。
これで、コンポーネントが Draft ステータスの Components タブにリストされます。
複製コンポーネントで、次の操作を行います。
- コンポーネントの名前を変更します。
- 既存のコンポーネントが使用されているすべてのソリューションで既存のコンポーネントを置き換える場合は、コンポーネント ID を更新しないでください。
- 既存のコンポーネントと新しいコンポーネントの両方を保持する場合は、コンポーネント ID を更新します。
- 要件に合わせてその他の変更を行います。
公開を選択します。

同じコンポーネント ID を持つ既存の公開済みコンポーネントがある場合、そのコンポーネントは非公開になります。新しいコンポーネントは、それが使用されるすべてのソリューションで既存のコンポーネントを置き換えます。

次のいずれかのオプションを選択します。
- セッションを正常に終了する: 既存のコンポーネントは、完了するまで処理を続行します。次にコンポーネントが呼び出されるときに、新しいコンポーネントが使用されます。
  
  猶予期間を選択します。最小期間は 10 分、最大 24 時間です。デフォルトの期間は 24 時間です。
- セッションを即時に終了: 既存のコンポーネントは、処理を直ちに停止します。次にコンポーネントが呼び出されるときに、新しいコンポーネントが使用されます。
公開を選択します。

コンポーネントのエクスポート/インポート

既存のコンポーネントに類似した新しいコンポーネントを作成する場合は、既存のコンポーネントをエクスポートし、新しいコンポーネントとしてインポートします。その後、インポートしたコンポーネントを要件に合わせて変更できます。

エクスポート/インポートは、コンポーネントを最初から作成する必要がないため、コンポーネントの作成にかかる時間を短縮します。

コンポーネントをエクスポート/インポートできる回数に制限はありません。

権限

コンポーネントをエクスポートするために、特定のユーザーロールは必要ありません。コンポーネントをインポートするには、マネージャー または デザイナー ロールが必要です。

すべての Answers plans はエクスポートとインポートをサポートしています。

エクスポート

前提条件

コンポーネントをエクスポートできるのは、コンポーネントが Answers によって検証され、エラーがない場合のみです。これにより、コンポーネントのインポート時にエラーが発生する可能性が低くなります。

ガイドライン

コンポーネントをエクスポートする場合、次のガイドラインと条件が適用されます。

エクスポートされたコンポーネントは、人間が判読できる形式です。コンテンツを検索し、要件に合わせて変更できます。
エクスポートされた構成部品には、次のものが保持されます。
- 属性
- ダイアログ

コンポーネントのエクスポート

コンポーネントをエクスポートするには、次の操作を行います。

[コンポーネント] タブに移動します。
エクスポートするコンポーネントの横にある 3 つのドットを選択し、[エクスポート] を選択します。

コンポーネントにエラーがないかどうかがチェックされます。検証エラーがない場合、ファイルはエクスポートされ、ローカルデバイスに .export 形式で保存されます。

インポート

前提条件

インポートするファイルは .export 形式である必要があります。
コンポーネントを別のアカウントにインポートする場合、ターゲットアカウントは、エクスポートされたコンポーネントで使用されるチャネルをサポートしている必要があります。例: WhatsApp コンポーネントを アカウント A からエクスポートする場合、WhatsApp が アカウント B で有効になっている場合にのみ、コンポーネントを アカウント B にインポートできます。

ガイドライン

コンポーネントをインポートする場合、次のガイドラインと条件が適用されます。

コンポーネントのインポート時にチャネルを変更することはできません。
コンポーネントは、同じアカウントの新しいコンポーネントとして、またはエクスポートされたコンポーネントで使用されるチャネルをサポートする別のアカウントにインポートできます。

コンポーネントをインポートする

[コンポーネント] タブに移動します。
[コンポーネントのインポート] を選択します。
必要な .export ファイルをアップロードします。
Import (インポート) を選択します。

エクスポートファイルに画像、ビデオ、またはファイルが含まれている場合は、アップロードの進行状況を表示したり、アップロードをキャンセルしたりすることもできます。

ダイアログ概要