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 ログインとユーザーサインアウト | これらのタイプのアクションは、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ドキュメント
- 作曲家ツアー
- チュートリアル: 新しい ボット を作成する
- チュートリアル: カード とボタンを ボット に追加する
- チュートリアル: ボット に言語生成を追加する
- Bot Framework GitHubのComposer