アダプティブカード

ボットビルダーはボット応答でのアダプティブカードの使用をサポートしています。ストーリーインテントとコンテキストに基づいた対話の処理のためにボットをトレーニングするために使用されます、ルールコンテキストによって変化しないメッセージに対するボットの応答を定義するために使用されます。、フォールバック宛先がリッチメディアをサポートしない場合に送信される代替のプレーンテキスト。で使用できます。

アダプティブカード中央から右上隅に矢印が向いている正方形のアイコン。は、Microsoftによって開発された、リッチメッセージングボタン、画像、メニュー、オプションピッカーなどのデジタルメッセージの要素。コンテンツを作成する方法です。これはオープンなカード交換フォーマットで、UIコンテンツを共通の一貫した方法で送信することができます。アダプティブカードを使えば、標準的なリッチメディア要素だけを含むものよりも複雑で役に立つインタラクティブなメッセージを送ることができます。

現在のところ、デジタルチャットのみがしています。他のチャネルでアダプティブカードのメッセージが送信された場合、指定されたフォールバック宛先がリッチメディアをサポートしない場合に送信される代替のプレーンテキスト。テキストが代わりに使用されます。

ボットビルダーがデフォルトで利用できるアダプティブカードはありません。ボットビルダーに組み込まれているMicrosoft アダプティブカードデザイナーを使用して独自のデザインを作成する必要があります。

アダプティブカードデザイナーを使用すると、ボットビルダーで使用するアダプティブカードテンプレートを作成できます。ボットがアダプティブカードテンプレートを含む応答を実行すると、そのインタラクションに適した情報がテンプレートに動的に入力され、コンタクトに送信されます。

アダプティブカードチャネル別サポート

アダプティブカードはサポートされているチャネルでのみ使用できます。現在、以下のチャネルでサポートされています。

ボットが、アダプティブカードをサポートしているチャネルだけでなく、サポートしていないチャネルでもメッセージを送信する場合は、リッチメッセージングフォールバック宛先がリッチメディアをサポートしない場合に送信される代替のプレーンテキスト。を設定する必要があります。フォールバックは、サポートされていないチャネルでアダプティブカードの代わりに送信されます。アダプティブカードを使用するボット応答ごとにリッチメッセージングフォールバックを設定できます。

アダプティブカードデザイナー

アダプティブカードデザイナーを使用すると、ボットビルダーで使用するアダプティブカードテンプレートを作成できます。ストーリー、ルール、またはフォールバックを作成するときに、アダプティブカードボットアクションを追加し、作成したアダプティブカードのいずれかを選択できます。

アダプティブカードデザイナーはボットビルダーに組み込まれたMicrosoft製品です。デザイナーの使用に関する詳細なドキュメントは、Microsoft アダプティブカード Webサイト中央から右上隅に矢印が向いている正方形のアイコン。で入手できます。

開発するカードでは、利用可能なアダプティブカード要素をすべて使用できます。アダプティブカードを動的にカスタマイズするには、スロット連絡先のメッセージから抽出され、ボット応答で使用するために保存されたエンティティ。変数に似ています。変数を使用できます。ボットにデータを返す場合は、ボタンなどの要素の設定にポストバックデータを含めることができます。たとえば、これにより、コンタクトの選択に関連付けられたインテントをボットに返すことができます。

スロット変数でアダプティブカードをカスタマイズする

アダプティブカードにスロット変数を含めることができます。これにより、カードがコンタクトに送信されたときに、カードのスロット連絡先のメッセージから抽出され、ボット応答で使用するために保存されたエンティティ。変数に似ています。に関連付けられたエンティティボットとの会話中にコンタクトのメッセージから収集された情報を表示できるようになります。

スロット変数は、中括弧で囲まれたスロットに関連付けられたエンティティの名前を使用して構築されます。たとえば、{phone_number}などです。アダプティブカードデザイナー内の要素のプロパティでスロット変数を使用できます。アダプティブカードデザイナーのカードペイロードエディターセクションで要素を見つけて、スロット変数を要素に追加することもできます。たとえば、「text」：「電話番号：{phone_number}」。

インタラクティブボタン

アダプティブカードにインタラクティブなボタンを含めることができます。プロパティにアクションセクションがある任意の要素に追加できます。アダプティブカードデザイナーには使用できるボタンの種類がいくつかあります。次のボタンタイプは特にボットビルダーで役立ちます。

URLボタン：このボタンをクリックするとURLが開きます。このタイプのボタンのJSONは次の例のようになります。
```
{
  "type": "Action.OpenUrl",
  "title": "View",
  "url": "http://www.nice.com"
}
```
ポストバックボタン：顧客がボタンをクリックまたはタップすると、ボタンはポストバックデータをボットに送信します。これを使用して、ボットにインテント連絡先の発言/入力する内容の背後にある意味または目的。連絡先が伝えたいこと、または達成したいこと。を送り返すことができます。このタイプのボタンのJSONは次の例のようになります。
```
{
 "type": "Action.Submit",
 "title": "Connect with agent",
 "data": {
	"text": "/[intentName]"
 }
```

アダプティブカードの作成

デフォルトでサンプルの要素セットを使用して新規にアダプティブカードが開始します。サンプル要素を変更したり、すべて削除したりして、カードを最初から作成することもできます。

アダプティブカードを作成したら、それをボット応答で使用できます。

CXoneで、アプリセレクターをクリックして、選択しますその他 > ボットビルダー.
作業したいボットをクリックします。
環境設定 > アダプティブカードをクリックします。
フォルダーを作成するには、プラス記号をクリックして名前を入力し、Enterキーを押します。
アダプティブカードを追加するフォルダーで、プラス記号をクリックします。
カードの名前を入力してEnterキーを押します。
カードに要素を追加します：
- 追加するカード要素の下のオプションをダブルクリックします。
- カード要素セクションからカードプレビューに要素をドラッグアンドドロップします。
- 要素のコンパスをクリックし、要素を新しい場所にドラッグします。
要素のプロパティを設定します。
- プレビューまたはカード構造セクションで要素を選択します。要素プロパティセクションには、選択した要素のプロパティが表示されます。必要に応じて変更してください。各要素には異なるプロパティセットがあります。
- 要素のプロパティを表示、設定、または変更するには、カードペイロードエディターを使用します。
- 要素を削除するには、プレビューの右上隅にあるXをクリックします。
要素のプロパティフィールドにエンティティ名を入力して、要素内のスロットを使用します。名前を中括弧で囲みます。たとえば、{phone_number}などです。
カードにインタラクティブボタンを追加するには、次のようにカード内のアクションを設定します。
- URLを開く：アクションタイプとしてAction.OpenURLを選択し、URLを入力します。
- ポストバックデータを送信する：アクションタイプとしてAction.Submitを選択し、{"text":"/[intentName]"}の形式を使用してデータフィールドにインテント名を入力します。
プレビューセクションでカードの外観をテストするには、[サンプルデータエディター]セクションのデフォルトデータをカードのサンプルデータに置き換えます。
変更は自動的に保存されます。