カスタム質問応答プロジェクトを Power Virtual Agents に追加する
プロジェクトから回答を提供するように Power Virtual Agents ボットを作成して拡張します。
注意
このチュートリアルで示す統合はプレビュー段階であり、運用環境へのデプロイを意図したものではありません。
このチュートリアルでは、以下の内容を学習します。
- Power Virtual Agents ボットを作成する
- システム フォールバック トピックを作成する
- Power Automate フローとしてカスタム質問応答のアクションをトピックに追加する
- Power Automate ソリューションを作成する
- Power Automate フローをソリューションに追加する
- Power Virtual Agents を公開する
- Power Virtual Agents をテストし、カスタム質問応答プロジェクトから応答を受け取る
Note
QnA Maker サービスは、2025 年 3 月 31 日に廃止される予定です。 Azure AI Language の一部として、質問応答機能の新しいバージョンが提供されました。 言語サービス内のカスタム質問応答機能については、「カスタム質問応答」を参照してください。 QnA Maker の新しいリソースは、2022 年 10 月 1 日以降作成できません。 既存の QnA Maker のナレッジ ベースをカスタム質問応答に移行する方法については、移行ガイドを参照してください。
プロジェクトを作成して発行する
- クイックスタートに従ってカスタム質問応答プロジェクトを作成します。 プロジェクトをデプロイします。
- Language Studio からプロジェクトをデプロイしたら、[予測 URL の取得] を選択します。
- 予測 URL のホスト名に含まれるサイト URL と、アカウント キー (Ocp-Apim-Subscription-Key) を取得します。
- カスタム質問応答コネクタを作成します。コネクタのドキュメントに従って、質問応答への接続を作成します。
- Language Studio からボットを作成するのではなく、Power Virtual Agents を使ってボットを作成するには、このチュートリアルを使います。
Power Virtual Agents でボットを作成する
Power Virtual Agents を使用すると、チームは、ガイド付きでコードのないグラフィカル インターフェイスを使用して、強力なボットを作成できます。 データ サイエンティストや開発者は必要ありません。
「Power Virtual Agents ボットの作成と削除」の手順に従ってボットを作成します。
システム フォールバック トピックを作成する
Power Virtual Agents で、アクションを実行してユーザーの質問に回答するために、一連のトピック (サブジェクト領域) を持つボットを作成します。
ボットはどのトピックからでもプロジェクトに接続できますが、このチュートリアルではシステム フォールバック トピックを使います。 フォールバック トピックは、ボットが回答を見つけられなかった場合に使用されます。 ボットでは、ユーザーのテキストをカスタム質問応答クエリ ナレッジベース API に渡し、プロジェクトからの応答を受け取り、それをメッセージとしてユーザーに表示します。
「Power Virtual Agents でシステム フォールバック トピックを構成する」の手順に従って、フォールバック トピックを作成します。
作成キャンバスを使用してアクションを追加する
Power Virtual Agents の作成キャンバスを使って、フォールバック トピックをプロジェクトに接続します。 トピックは、認識されていないユーザー テキストから始まります。 そのテキストをカスタム質問応答に渡して、回答をメッセージとして表示するアクションを追加します。 回答を表示する最後の手順は、このチュートリアルで後ほど別個の手順として処理されます。
このセクションでは、フォールバック トピックの会話フローを作成します。
新しいフォールバック アクションには、あらかじめ会話フローの要素が含まれていることがあります。 [Options](オプション) メニューを選択して、 [Escalate](エスカレーション) 項目を削除します。
[メッセージ] ノードの下にある、(+) アイコンを選び、[Call an action] (アクションを呼び出す) を選びます。
[Create a flow](フローの作成) を選択します。 これで Power Automate ポータルに移動します。
次のように Power Automate に新しいテンプレートが表示されます。
上に示したテンプレートは使わないでください。
代わりに、Power Automate フローを作成する次の手順を実行する必要があります。 このフローの内容:
- 受信したユーザー テキストを質問として受け取り、カスタム質問応答に送信します。
- 上位の応答をボットに返します。
左側のパネルの [作成] を選択し、[OK] をクリックしてそのページから離れます。
[Instant Cloud flow] (インスタント クラウド フロー) を選びます
このコネクタをテストするには、[PowerVirtual Agents からフローが呼び出されるとき] を選択し、[作成] を選択します。
[新しいステップ] を選択し、「Power Virtual Agents」を検索します。 [入力の追加] を選び、テキストを選びます。 次にキーワードと値を入力します。
[新しいステップ] を選択し、「言語 - カスタム質問応答」を検索し、3 つのアクションから [プロジェクトから応答を生成する] を選択します。
このオプションは、プロジェクトを使って指定した質問に応答するのに役立ちます。 プロジェクト名、デプロイ名、API バージョンを入力し、前の手順で選んだ質問を選びます。
[新しいステップ] を選択し、「変数を初期化する」を検索します。 変数の名前を選び、[文字列] 型を選びます。
もう一度 [新しいステップ] を選択し、「それぞれに適用」を検索し、前の手順の出力を選び、[変数の設定] のアクションを追加し、コネクタ アクションを選びます。
[新しいステップ] を選択し、「Power Virtual Agents に値を戻す」を検索してキーワードを入力し、応答で前の変数名を選びます。
完了したステップの一覧は次のようになります。
[保存] を選択してフローを保存します。
ソリューションを作成してフローを追加する
ボットがフローを見つけて接続するには、そのフローが Power Automate ソリューションに含まれている必要があります。
- 引き続き Power Automate ポータルで、左側のナビゲーションから [Solutions](ソリューション) を選択します。
- [+ New solution](+ 新しいソリューション) を選択します。
- 表示名を入力します。 ソリューションの一覧には、組織または学校のすべてのソリューションが含まれています。 フィルター処理して自分のソリューションだけを表示するのに役立つ名前付け規則を選択します。 たとえば、ソリューション名 jondoe-power-virtual-agent-question-answering-fallback の前に自分のメール アドレスを付けることができます。
- 選択肢の一覧から公開元を選択します。
- 名前とバージョンには、既定値をそのまま使用します。
- [Create](作成) を選択して、このプロセスを完了します。
フローをソリューションに追加する
- ソリューションの一覧から、先ほど作成したソリューションを選択します。 リストの一番上に表示されていると思います。 見つからない場合は、ソリューション名の一部になっている電子メール名で検索してください。
- ソリューションで [+ Add existing](+ 既存を追加) を選択し、一覧から [Flow](フロー) を選択します。
- [ソリューション外部] リストからフローを検索し、次に [追加] を選択してプロセスを完了します。 多数のフローがある場合は、 [Modified](変更) 列を見て最新のフローを探してください。
ソリューションのフローを Power Virtual Agents に追加する
- Power Virtual Agents のボットが表示されているブラウザー タブに戻ります。 作成キャンバスがまだ開いていると思います。
- フローに新しいステップを挿入するには、[メッセージ] アクション ボックスの上方にある (+) アイコンを選びます。 次に、 [Call an action](アクションの呼び出し) を選択します。
- [フロー] ポップアップ ウィンドウで、[Generate answers using Question Answering Project] (質問応答プロジェクトを使用して応答を生成する) という名前の新しいフローを選択します。新しいアクションがフローに表示されます。
- 入力変数を QnA Maker アクションに正しく設定するには、 [変数を選択] を選択してから、 [bot.UnrecognizedTriggerPhrase] を選択します。
- 出力変数をカスタム質問応答アクションに正しく設定するには、[メッセージ] アクションで [UnrecognizedTriggerPhrase] を選び、変数を挿入するアイコン {x} を選び、[FinalAnswer] を選びます。
- コンテキスト ツール バーから、 [Save](保存) を選択して、このトピックに対する作成キャンバスの詳細を保存します。
最終的なボット キャンバスは次のようになります。
ボットのテスト
Power Virtual Agents でボットを設計する際に、[テスト ボット] ペインを使用して、ボットがボットの会話を通じて顧客を導く方法を確認できます。
- テスト ペインで、 [Track between topics](トピック間を追跡する) を切り替えます。 これにより、1 つのトピック内だけでなく、トピック間の進行を観察できます。
- 次の順序でユーザー テキストを入力して、ボットをテストします。 成功したステップは、作成キャンバスに緑色のチェック マークでレポートされます。
| 質問の順序 | テスト質問 | 目的 |
|---|---|---|
| 1 | こんにちは | 会話を開始します。 |
| 2 | Store hours | サンプル トピック。 これは、追加の作業を行わなくても自動的に構成されます。 |
| 3 | はい | "Did that answer your question?" (ご質問の回答は得られましたか?) の返信 |
| 4 | [非常に良い] | "Please rate your experience." (エクスペリエンスを評価してください。) の返信 |
| 5 | はい | "Can I help with anything else?" (他に何かお手伝いできますか?) の返信 |
| 6 | クエリ予測のスループットのパフォーマンスを向上させるにはどうすればよいですか。 | この質問により、フォールバック アクションがトリガーされます。それにより、回答するためのテキストがプロジェクトに送信されます。 次に、回答が表示されます。 個々のアクションの緑色のチェックマークは、各アクションが成功したことを示します。 |
ボットを公開する
組織のすべてのメンバーがボットを利用できるようにするには、それを公開する必要があります。
ボットの公開に関するページの手順に従って、ボットを公開します。
ボットを共有する
ボットを他のユーザーが利用できるようにするには、まずボットをチャネルに公開する必要があります。 このチュートリアルでは、デモ Web サイトを使用します。
デモ Web サイトを構成するには、ライブまたはデモ Web サイトのチャットボットの構成に関するページの手順に従います。
その後、学校または組織のメンバーと Web サイトの URL を共有できます。
リソースをクリーンアップする
プロジェクトが完成したら、QnA Maker リソースを Azure portal から削除してください。