ページにチャットボットを追加する
Power Apps ポータルでは、ポータルのページに訪問者が投稿した質問に答える Power Virtual Agents チャットボットを追加することができます。 さまざまなトピックとトリガー フレーズで構成されたチャットボット (ボット) は、チャットの会話で訪問者が投稿した質問に自動的に回答することができます。
前提条件
Power Virtual Agents のボットを Power Apps のポータルページに追加する前に、ボットを作成する必要があります。 まだ利用可能なボットやニーズに合ったボットがない場合は、ポータルで Power Virtual Agents にアクセスしてボットを作成できます。 ボットの作成方法については、Power Virtual Agents ボットの作成と削除にアクセスしてください。
重要
この機能には、スターター ポータル パッケージとポータル ホスト用の次のバージョンが必要です。
- ポータル ホスト バージョン 9.3.4.x またはそれ以降。
- スターター ポータル パッケージ 9.2.2103.x またはそれ以降。 詳細: 追加の考慮事項
チャットボット コンポーネントの追加
チャットボットを作成後は、次の手順でポータル ページにこのコンポーネントを追加することができます:
Power Apps に移動します。
左側のウィンドウから、アプリ を選択します。
ポータルを選択します。
ポータルの Studio を開いて、編集 を選択します。
左側のウィンドウで、コンポーネント を選択します。
チャットボット コンポーネントを選択します。
ボットを選択します。
注意
ボットをまだ作成していない、またはポータルで使用する新しいボットを作成する場合は、Power Virtual Agents を選択します。 ボットを作成したら、ボットの変更を反映させるには、ポータルスタジオ内の 構成の同期 を選択します。
ボットをポータルのすべてのページに表示するか、特定のページに表示するかを選択します。
特定のページ を選択した場合、ページ内のボットを管理する を使用して、このボットを使用できるページを制御します。
ポータル内のさまざまなページにまたがって、ご使用の環境からさらにボットを追加できます。 たとえば、職場に関連する質問に答えるボットを HR ページに追加できます。 また、給与計算の基本的な質問に答えるボットを Finance ページに追加することもできます。 ただし、1 ページで複数のボットを使用することはできません。
高度な構成
チャットボットのコンポーネントは、Power Virtual Agents と呼ばれる Web テンプレートを使用してレンダリングされます。
"window.PvaEmbeddedWebChat.renderWebChat()" 関数内の次のパラメーター値を変更できます。
| 番号 | パラメーター | 値 |
|---|---|---|
| 1 | width | 変数 "chatWidth" を使用します。 変更するには、幅をピクセル単位で更新します: let chatWidth = "320px"; |
| 2 | height | 変数 "chatHeight" を使用します。 変更するには、高さをピクセル単位で更新します: let chatHeight = "480px"; |
| 3 | headerText | ボットのタイトルです。 既定では、これはボットの名前を使用します。 変更するには、ボット ヘッダー値を使用して "headerText" パラメーターを追加します。 "headerText": 'Contoso chatbot'; |
| 4: fontColor5: backgroundColor | webChatHeaderStyleOptions | フォントの色や背景など、チャットボットコンポーネントのヘッダー スタイルを決定します。 変更するには、"webChatHeaderStyleOptions" パラメータを "fontColor" や "backgroundColor" プロパティの値で更新します。 "webChatHeaderStyleOptions": {"fontColor":'black',"backgroundColor":'white'} |
| 6: backgroundColor7: bubbleBackgroundcolor8: bubbleTextColor9: bubbleFromUserBackground10: bubbleFromUserTextColor | webChatCanvasStyleOptions | チャットボットとユーザーからの背景やバブルの背景など、チャットボットコンポーネントのチャット キャンバス スタイルを決定します。 変更するには、"webChatCanvasStyleOptions" パラメーターを " backgroundColor"、"bubbleBackgroundcolor"、"bubbleTextColor"、"bubbleFromUserBackground"、および "bubbleFromUserTextColor" プロパティの値で更新します。 "webChatCanvasStyleOptions": {"backgroundColor": "#123FFF","bubbleBackground":"#2340F0","bubbleTextColor": "#323130","bubbleFromUserBackground": "#412644","bubbleFromUserTextColor": "#F345FF"} |
| 11: backgroundColor12: iconColor | webChatWidgetStyleOptions | アイコンの色や背景など、ChatWidget コンポーネントのヘッダー スタイルを決定します。 変更するには、"webChatWidgetStyleOptions" パラメータを "backgroundColor" や "iconColor" プロパティの値で更新します。"webChatWidgetStyleOptions": {"backgroundColor": "#486744","iconColor": "#DF234F"} |
Web テンプレートを変更した後は、必ず 構成の同期 を選択して、構成を更新して変更を反映します。
注意
上記で説明されたパラメーター以外の Power Virtual Agents Web テンプレートへの変更は、サポート対象外です。
さらに考慮すべきこと
ポータルサイト内で Power Virtual Agents チャットボットを使用する際には、以下の点を考慮してください:
ポータル テンプレート バージョン
この機能を利用するには、スターター ポータル パッケージのバージョン 9.2.2103.x またはそれ以降が必要です。 ポータル テンプレートがチャット ボット コンポーネントに対応していない場合、コンポーネントを追加しようとすると以下のメッセージが表示されます:
ポータルのアップグレードが必要です: この機能をポータルで使用するには、アップグレードが必要です。ポータルをアップグレードした場合は、構成を同期して、現在のポータル スタジオ セッションを新しいポータル パッケージで更新してください。
このメッセージが表示されたら、ポータル パッケージをアップグレードしてください。 ソリューション ID の詳細については、ポータルソリューションの更新 を参照してください。
注意
スターター ポータル パッケージをアップグレードすると、ご利用環境に追加されたポータルでも、チャット ボット コンポーネントの使用が可能になります。 詳細: スターター ポータル パッケージの更新
ソリューションの削除
この機能には、MicrosoftPortalBot というポータルソリューションが付属しており、表示名は Dynamics 365 ポータル - ボット となっています。 このソリューションを削除し、次の操作を行わないと、ポータルが機能しなくなります。
MicrosoftPortalBot ソリューションを削除した場合、ポータルを再起動して、ポータルが正しく機能させる必要があります。
ポータルを再起動するには:
使用しているポータルの Power Platform 管理センター を開きます。
左側のペインで、ポータル アクション を選択します。
再起動 を選択し、ポータルを再起動します。
重要
ポータルを再起動すると、数分間はポータルを使用できなくなり、この間ユーザーはポータルの URL にアクセスできません。
再起動 を選択し、ポータルの再起動を確認します。
関連項目
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
フィードバックの送信と表示