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