Bot Framework Composer の概要
注意
Power Virtual Agents では、Composer なしで これらの機能に対応できるようになりました。
Bot Framework Composer でカスタム トピックを開発し、Power Virtual Agents のボットに追加することで、ボットを強化できます。
Composer は Power Virtual Agents に統合されており、開発者とビジネス ユーザーが一緒にボットを構築できるようになっています。 Composer では、次のような Bot Framework の機能でボットを拡張することができます :
- アダプティブ ダイアログ
- 言語の生成 (LG)
- 正規表現 (RegEx)
- アダプティブ カード
Power Virtual Agents を使用した Composer では、Power Virtual Agents で定義された変数を含む会話メモリとコンテキストにアクセスできます。 これにより、中断、キャンセル、コンテキストの切り替えを処理するトピックを作成できます。 また、アダプティブ カードを追加して、画像やビデオ、フォームなどのインタラクティブな要素をボットに表示することもできます。
Composer には様々な関数や式があらかじめ用意されており、ボットが実行時にランダムに選択する複数のフレーズのバリエーションを定義することも可能です。
Composer で追加されたカスタム トピックは、Power Virtual Agents ボットの他のコンテンツと一緒に展開、ホスティング、実行され、追加の Azure ホスティングは必要ありません。
重要
Composer の統合は、Teams Power Virtual Agents ライセンス のみを持っているユーザーはご利用いただけません。 試用版、もしくは Power Virtual Agents ライセンスの完全版が必要です。
前提条件
主な Compose r用語を理解する
Composer では、Power Virtual Agents で使用されている同様の概念を説明するために、別の一連の用語を使用しています。 以下は、理解すべき重要な用語のリストです:
ダイアログ: ダイアログは、Composer の基本的な構成要素であり、トリガーのコンテナーとして機能します。 各ダイアログは、ボットの機能の一部を表し、ボットが何を行うか、ユーザー入力にどのように反応するかについての指示が含まれています。 ダイアログの詳細については、Composer の会話のビルディング ブロックとしてのダイアログ を参照してください。
メイン ダイアログ: ボットのメイン ダイアログは、ボット エクスプローラーに表示される最初のダイアログであり、Power Virtual Agent ボットを Composer にインポートする際に作成されます。 メイン ダイアログは、Power Virtual Agents ボットに連動しているため、削除しないでください。
トリガー: トリガーは、ダイアログの主要コンポーネントであり、イベントをキャッチして応答できるようにします。 各トリガーには、条件と、条件が満たされたときに実行するアクションのコレクションがあります。 トリガーは、Power Virtual Agents の トピックに相当すると見なすことができます。 トリガーの詳細については、トリガー を参照してください。
action: アクションは、応答の送信、プロパティへの値の作成と割り当て、会話フローの操作、ダイアログの管理、およびその他の多くのアクティビティを可能にするトリガーの主要コンポーネントです。 アクションは、Power Virtual Agents の ノードに相当すると見なすことができます。
Power Virtual Agents でサポートされていない Composer の機能
次の Composer の機能は、Power Virtual Agents ではサポートされていません :
| サポートされていない機能 | 追加情報 |
|---|---|
| LUIS 認識エンジン | Composer の既定の認識エンジンは Power Virtual Agents Natural Language Understanding (NLU) に設定されています。 |
| Bot Framework オーケストレーター | Bot Framework オーケストレーターは、Power Virtual Agents の Composer ではサポートされていません。 |
| ユーザー定義の認識エンジン | Power Virtual Agents の Composerでは、ユーザー定義の認識エンジンはサポートされていません。 |
| ボットのスキル | Power Virtual Agents の Composer のコンテンツではボットのスキルを呼び出すことができません。 |
| QnA Maker | この機能は、Power Virtual Agents の Composer では利用できません。 |
| OAuth ログインとユーザー サインアウト | これらのタイプのアクションは、Power Virtual Agents の Composer ではサポートされていません。 |
| ダイアログの入力と出力 | ダイアログの入力と出力は、Power Virtual Agents の Composer ではサポートされていません。 |
| Composer のトリガーフレーズにおけるエンティティの検出 | Composer では # getUserName my name is {username=userName} は使用できません。 |
| Bot Framework エミュレータでのテスト | すべての Composer コンテンツを公開してから、Power Virtual Agents でテストする必要があります。 |
Composerで Power Virtual Agents のボットコンテンツを作成するためのガイドライン
Composer を使用して Power Virtual Agents 用のボット コンテンツを作成する際には、いくつかの重要なガイドラインがあります:
作成したボットの Power Virtual Agents トピックがダイアログとして Composer に表示されます。 これらのトピックを Composer で編集することはできませんが、選択するとこれらのトピックが Power Virtual Agents で起動し、編集することができます。
Power Virtual Agents Composerでは、
virtualagentスコープを使用してグローバル変数にアクセスします。 このスコープは Composer のプロパティ リファレンス メニューには表示されませんが、式を直接入力することでアクセスできます。Composer でコンテンツを公開すると、変更をテストに使用できるようになりますが、Power Virtual Agents ボットは自動的に公開されません。 Power Virtual Agents の公開機能を使用して、ボットの変更をチャネルに公開します。
Power Virtual Agents トピックを開始する アクションを使用して Composer の Power Virtual Agents トピックを呼び出します。
メイン (別名: ルート) ダイアログ に任意の種類の新しい Composer トリガー を追加することができます。
これらの Composer トリガーからメッセージを送信したり、質問したりできます。
メイン (ルート) ダイアログ で正規表現の認識エンジンを使用することはできません。 メインダイアログ で正規表現認識機能を使用すると、Composer のコンテンツを Power Virtual Agents に公開できなくなります。 正規表現認識機能は、他の Composer ダイアログでも使用できます。
新しく作成されたダイアログに、任意の Composer イベントやトリガーを追加することができます。
ボットの応答ページでは、Commonセクションは空にする必要があります。 資産がある場合は、検証エラーが発生し、Composer のコンテンツを Power Virtual Agents に発行できなくなります。
各 Composer ダイアログには、独自のボット応答 (.lg) および言語理解 (.lu) リソースがあります。 たとえば、英語 (米国) を話し、
dialog1という名前のダイアログを持つボットには、1つのdialog1.en-us.lgファイルと1つのdialog1.en-us.luファイルがあります。Composer のメイン ダイアログは、Power Virtual Agents ボットに連動しているため、削除しないでください。 メイン (ルート) ダイアログは、ゼロまたはひとつ以上のトリガーを持つことができます。
Composer のダイアログやトリガーでテレメトリを取得し、Application Insights を使って 適応型ダイアログの Kusto クエリで分析することができます。 詳細については、Application Insights でテレメトリをキャプチャする を参照してください。
Composer のダイアログ、イベント、トリガー、Bot Framework で高度なボットコンテンツを作成する方法については、以下のリソースを参照してください:
参照
Composer における開発についての詳細は、次のリソースを参照してください:
- Bot Framework Composer ドキュメント
- Composer の概要
- チュートリアル : 新しいボットの作成
- チュートリアル : ボットにカードとボタンを追加する
- チュートリアル : ボットに言語生成を追加する
- GitHub の Bot Framework Composer