SmartAssistでアダプティブカードを設定する

SmartAssistバーチャルエージェントがコンタクトに送信するメッセージでアダプティブカードを使用できます。  アダプティブカードはデジタルチャットチャネルでのみサポートされています。

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

前提条件

SmartAssistでアダプティブカードを使用するには、以下が必要です。

• Amelia管理コンソールにアクセスできること。
• デジタルスクリプトを備えた、機能的なデジタルSmartAssist統合があること。
• Microsoftコンソールに組み込まれているツールであるアダプティブカードデザイナーAmeliaを使用すること。
• SmartAssistでデジタルチャットチャネルを使用すること。

Ameliaでアダプティブカードを作成する

管理コンソールにMicrosoft組み込まれたアダプティブカードデザイナーAmeliaを使用できます。

1. Ameliaバーチャルエージェント管理コンソールにログインします。
2. [会話フロー]で、カスタムカードをクリックし、新規作成をクリックします。
3. Microsoftアダプティブカードデザイナーツールを使用して、アダプティブカードを作成します。 ツールの詳細についてはMicrosoftドキュメントを参照してください。
4. Microsoftアダプティブカードデザイナーツールを使用して、アダプティブカードを作成します。 ツールの詳細についてはMicrosoftドキュメントを参照してください。
5. アダプティブカードでは、コンタクトからの入力を保持するすべてのブロックに一意のIDを割り当てます。 これには、テキスト、時刻、数値、日付などが含まれます。 アダプティブカード送信機能は、IDを使用してコンタクトからの入力を取得します。
6. 変更を保存するにはフロッピーディスクをクリックします。

アダプティブカード用のDEBフローを作成する

Amelia管理コンソールで、アダプティブカードをデジタル従業員ビルダー(DEB)フローに割り当てる必要があります。

1. Ameliaバーチャルエージェント管理コンソールにログインします。
2. [会話フロー]の下で、会話フローをクリックします。
3. 新しいフローを作成するフォルダーを選択し、プラス記号の付いたページをクリックしてフローを作成します。
4. メインフローウィンドウで、2つの要素間のスペースにあるプラス記号をクリックし、ポップアップメニューでカードをクリックします。
5. メインウィンドウで新しいカード要素を選択します。
6. 右側のペインの要素プロパティで、カード要素の名前を変更します。
7. カードドロップダウンリストから、以前に作成したアダプティブカードを選択します。
8. 変更を保存するにはフロッピーディスクをクリックします。
9. 準備ができたら、デプロイをクリックしてフローをデプロイします。

AmeliaアダプティブカードをVirtual Agent Hubテストする

1. CXoneで、アプリセレクターをクリックし、選択します：その他>自動化とAI、次いでVirtual Agent Hubの順にクリックします。 また、Studioスクリプトで使用しているバーチャルエージェントアクションをダブルクリックして、Virtual Agent Hubを起動することもできます。
2. ページの左側にあるリストでSmartAssistバーチャルエージェントをクリックします。
3. テストパネルで、ようこそインテントで開始をクリックします。 ボットが適切に応答したら、次の手順に進みます。 ボットが適切に応答しない場合は、問題を調査して修正します。
4. メッセージを入力フィールドに、run the workflow [name of adaptive card flow in Amelia]コマンドを入力します。
5. テストペインの出力でアダプティブカードの形式が正しいことを確認します。 期待どおりに表示されない場合は、Ameliaに戻って修正し、再度テストしてください。

アダプティブカードを送信するStudioスクリプトを変更する

アダプティブカードを送信するには、SmartAssistで使用するスクリプトを変更する必要があります。

1. Studioにログインして、SmartAssistバーチャルエージェントで使用するデジタルスクリプトを開きます。 スクリプトはデジタルチャットチャネルを経由してルーティングする必要があります。

2. Textbot Exchangeアクションを右クリックしてプロパティを表示し、customPayloadVarName (out)プロパティから変数名をコピーします。

3. TextmsgまたはAskcallerアクションを右クリックし、MessageFormatプロパティがPromptSequenceに設定されていることを確認します。

4. TextmsgまたはAskcallerのMessageプロパティに、TEXTBOT EXCHANGEからコピーした変数名を貼り付けます。 変数の末尾に..promptSequence.asjson()を追加し、全体を中括弧で囲みます。 例えば、 {customPayloadFromBot.promptSequence.asjson()} 。

5. 変更を保存します。