Bot Framework Composer の概要

  • [アーティクル]

重要

Power Virtual Agents 機能は、生成 AI への多大な投資と Microsoft Copilot 全体の統合の強化により、現在 Microsoft Copilot Studio の一部となっています。

ドキュメントやトレーニング コンテンツが更新される間、一部の記事やスクリーンショットで Power Virtual Agents が参照される場合があります。

注意

Microsoft Copilot Studio では、Composer なしで これらの機能に対応できるようになりました。

Bot Framework Composer でカスタム トピックを開発し、Microsoft Copilot Studio コパイロットに追加することで、ボットを強化できます。

Composer は Microsoft Copilot Studio に統合されており、開発者とビジネス ユーザーが一緒にボットを構築できるようになっています。 Composer では、次のような Bot Framework の機能でボットを拡張することができます :

  • アダプティブ ダイアログ
  • 言語の生成 (LG)
  • 正規表現 (RegEx)
  • アダプティブ カード

Microsoft Copilot Studio を使用した Composer では、Microsoft Copilot Studio で定義された変数を含む会話メモリとコンテキストにアクセスできます。 このメモリとコンテキストを使用すると、中断、キャンセル、コンテキストの切り替えを処理するトピックを作成できます。 また、アダプティブ カードを追加して、画像やビデオ、フォームなどのインタラクティブな要素をボットに表示することもできます。

Composer には様々な関数や式があらかじめ用意されており、ボットが実行時にランダムに選択する複数のフレーズのバリエーションを定義することも可能です。

Composerで追加されたトピックは、Microsoft Copilot Studio コパイロットの他のコンテンツと一緒にデプロイ、ホスティング、実行され、その他の Azure ホスティングは必要ありません。

重要

Composer の統合は、Teams Microsoft Copilot Studio ライセンス のみを持っているユーザーはご利用いただけません。 試用版、もしくは Microsoft Copilot Studio ライセンスの完全版が必要です。

前提条件

主な Compose r用語を理解する

Composer では、Microsoft Copilot Studio で使用されている同様の概念を説明するために、別の一連の用語を使用しています。 理解すべき重要な用語をいくつか以下に示します。

  • ダイアログ: ダイアログは、Composer の基本的な構成要素であり、トリガーのコンテナーとして機能します。 各ダイアログは、ボットの機能の一部を表しており、ボットの動作やユーザー入力にどのように反応するかについての指示が含まれています。 ダイアログの詳細については、Composer の会話のビルディング ブロックとしてのダイアログ を参照してください。

  • メイン ダイアログ: ボットのメイン ダイアログは、ボット エクスプローラーに表示される最初のダイアログで、 Microsoft Copilot Studio コパイロットをComposerにインポートするときに作成されます。 メイン (ルート) ダイアログは、Microsoft Copilot Studio コパイロットに連動しているため、削除しないでください。

  • トリガー: トリガーは、ダイアログの主要コンポーネントであり、イベントをキャッチして応答できるようにします。 各トリガーには、条件と、条件が満たされたときに実行するアクションのコレクションがあります。 トリガーは、Microsoft Copilot Studio の トピックに相当すると見なすことができます。 トリガーの詳細については、トリガー を参照してください。

  • action: アクションは、応答の送信、プロパティへの値の作成と割り当て、会話フローの操作、ダイアログの管理、およびその他の多くのアクティビティを可能にするトリガーの主要コンポーネントです。 アクションは、Microsoft Copilot Studio の ノードに相当すると見なすことができます。

Microsoft Copilot Studio でサポートされていない Composer の機能

次の Composer の機能は、Microsoft Copilot Studio ではサポートされていません :

サポートされていない機能 追加情報
LUIS (言語理解) 認識エンジン Composer の既定の認識エンジンは Microsoft Copilot Studio Natural Language Understanding (NLU) に設定されています。
Bot Framework オーケストレーター Bot Framework オーケストレーターは、Microsoft Copilot Studio の Composer ではサポートされていません。
ユーザー定義の認識エンジン Microsoft Copilot Studio の Composerでは、ユーザー定義の認識エンジンはサポートされていません。
ボットのスキル Microsoft Copilot Studio の Composer のコンテンツではボットのスキルを呼び出すことができません。
QnA Maker この機能は、Microsoft Copilot Studio の Composer では利用できません。
OAuth ログインとユーザー サインアウト これらのタイプのアクションは、Microsoft Copilot Studio の Composer ではサポートされていません。
ダイアログの入力と出力 ダイアログの入力と出力は、Microsoft Copilot Studio の Composer ではサポートされていません。
Composer のトリガーフレーズにおけるエンティティの検出 Composer では # getUserName my name is {username=userName} は使用できません。
Bot Framework エミュレータでのテスト すべての Composer コンテンツを公開してから、Microsoft Copilot Studio でテストする必要があります。

Composer で Microsoft Copilot Studio のコンテンツを作成するためのガイドライン

Composer を使用して Microsoft Copilot Studio 用のコンテンツを作成する際には、いくつかの重要なガイドラインがあります:

  • Microsoft Copilot Studio ボットからのトピックがダイアログとして Composer に表示されます。 これらの トピックを Composer で編集することはできませんが、選択すると関連するトピックが Microsoft Copilot Studio で起動し、編集することができます。

    Microsoft Copilot Studio コパイロットからインポートされた Composer のトピックのリストのスクリーンショット。

  • Microsoft Copilot Studio Composerでは、virtualagent スコープを使用してグローバル変数にアクセスします。 このスコープは Composer のプロパティ参照メニューには表示されませんが、式を直接入力することでアクセスできます。

  • Composer で公開するコンテンツは、変更をテストに使用できるようになりますが、Microsoft Copilot Studio コパイロットは自動的に公開されません。 コパイロットの変更をチャンネルに公開するには、Microsoft Copilot Studio の公開 機能を使用します。

  • Microsoft Copilot Studio トピックを開始する アクションを使用して Composer の Microsoft Copilot Studio トピックを呼び出します。

    Composer のアクション追加メニューのスクリーンショット。

  • メイン (別名: ルート) ダイアログ に任意の種類の新しい Composer トリガー を追加することができます。

  • これらの Composer トリガーからメッセージを送信したり、質問したりできます。

  • メイン (ルート) ダイアログ で正規表現の認識エンジンを使用することはできません。 メイン ダイアログで正規表現認識機能を使用すると、Composer のコンテンツを Microsoft Copilot Studio に公開できなくなります。 正規表現認識機能は、他の Composer ダイアログでも使用できます。

  • 新しく作成されたダイアログに、任意の Composer イベントやトリガーを追加することができます。

  • ボットの応答ページでは、Commonセクションは空にする必要があります。 資産を使用すると、検証エラーが発生し、Composer のコンテンツを Microsoft Copilot Studio に公開できなくなります。

    空の一般的なボット応答セクションのスクリーンショット。

  • 各 Composer ダイアログには、独自のボット応答 (.lg) および言語理解 (.lu) リソースがあります。 たとえば、英語 (米国) を話し、dialog1 という名前のダイアログを持つボットには、1 つの dialog1.en-us.lg ファイルと 1 つの dialog1.en-us.lu ファイルがあります。

  • Composer のメイン (ルート) ダイアログは、Microsoft Copilot Studio コパイロットに連動しているため、削除しないでください。 メイン (ルート) ダイアログは、ゼロまたはひとつ以上のトリガーを持つことができます。

  • Composer のダイアログやトリガーでテレメトリを取得し、Application Insights を使って 適応型ダイアログの Kusto クエリで分析することができます。 詳細については、Application Insights でテレメトリをキャプチャする を参照してください。

Composer のダイアログ、イベント、トリガー、Bot Framework で高度なボットコンテンツを作成する方法については、以下のリソースを参照してください:

参照

Composer における開発についての詳細は、次のリソースを参照してください: