Bot Framework を使用してメッセージ拡張機能を構築する

メッセージ拡張検索コマンドを使用すると、ユーザーは外部システムを検索し、その検索結果をカードの形式でメッセージに挿入できます。 このドキュメントでは、検索コマンドの呼び出し場所を選択し、検索コマンドをアプリ マニフェストに追加する方法について説明します。

メッセージ拡張機能の検索コマンドを定義する方法については、次のビデオを参照してください。

メッセージ拡張機能の検索コマンドは、 composeExtensions.commands プロパティと、アプリ マニフェスト (以前は Teams アプリ マニフェストと呼ばれる) の query 型を使用して構成されます。 コマンドとパラメーターの説明は、メッセージ拡張の使いやすさと有効性を高めます。 適切なコマンドの説明は、アプリの機能の明確で簡潔な概要を提供します。

次のコードは、検索コマンドを定義する composeExtensions プロパティの例です。

{
 "composeExtensions": [
    {
      "botId": "eccdf132-0900-4d36-936b-dec5e6357f11",
      "commands": [
        {
          "id": "Dev",
          "type": "query",
          "title": "Jedi",
          "description": "May the force be with you",
          "initialRun": true,
          "fetchTask": false,
          "context": [
            "commandBox",
            "compose",
            "message"
          ],
          "parameters": [
            {
              "name": "Luke",
              "title": "Skywalker",
              "description": "Jedi master",
              "inputType": "text"
            }
          ]
        }
      ],
      "canUpdateConfiguration": true
    }
  ],

パラメーター

オブジェクトの composeExtensions.commands 配列に次のパラメーターを追加する必要があります。

Teams クライアントでユーザーに表示されるテキストを定義する次の検索パラメーターの詳細を追加する必要があります。

詳細については、「 アプリ マニフェスト スキーマ」を参照してください。

Teams 会議用 Copilot のプラグインとしてのメッセージ拡張機能

メッセージ拡張プラグインは、Teams 会議の Copilot でサポートされています。 ボットベースのメッセージ拡張プラグインを会議に拡張すると、Teams 会議の Copilot を強化できます。 Copilot は、タスク モジュール、アプリ共有など、会議中にさまざまなアプリ機能を利用して、ユーザーエンゲージメントと生産性を向上させることができます。 たとえば、Copilot for Teams 会議でプラグインを使用して、ディスカッションの要約、メモの生成、タスクの一覧表示を行うことができます。 また、外部データとカスタム機能とのリアルタイム対話を有効にすることで、従来のプラグインの利点も拡張します。

会議 Copilot は対話型で効率的であり、ディスカッションの要約、アクション項目の提案、リアルタイムでの迅速な支援の提供を支援できます。 ユーザーは、会議の副操縦に自然言語の質問をし、会議コンテキストに関連するプラグインから応答を取得できます。 ユーザーが Microsoft 365 用 Copilot と Teams 会議用の Copilot の両方で有効にするプラグインを使用できます。

次の手順

アクション コマンドを使用すると、Teams のタスク モジュールと呼ばれるモーダル ポップアップをユーザーに表示できます。 タスク モジュールは、情報を収集または表示し、対話を処理し、Teams に情報を送信します。 このドキュメントでは、操作コマンドを呼び出す場所の選択、タスク モジュールの作成、最終メッセージまたはカードの送信、App Studio を使用した操作コマンドの作成、手動での作成方法について説明します。

メッセージ拡張機能のアクション コマンドは、アプリ マニフェストの composeExtensions.commands プロパティと action 型を使用して構成されます。

次のコードは、アクション コマンドを定義する composeExtensions プロパティの例です。

"composeExtensions": [
        {
            "botId": "xxxxxx-xxx-bot-ID-xxxxxxxx}",
            "commands": [
                {
                    "id": "createCard",
                    "context": [
                        "compose",
                        "message",
                        "commandBox"
                    ],
                    "description": "Command to run action to create a Card from Compose Box",
                    "title": "Create Card",
                    "type": "action",
                    "parameters": [
                        {
                            "name": "title",
                            "title": "Card title",
                            "description": "Title for the card",
                            "inputType": "text"
                        },
                        {
                            "name": "subTitle",
                            "title": "Subtitle",
                            "description": "Subtitle for the card",
                            "inputType": "text"
                        },
                        {
                            "name": "text",
                            "title": "Text",
                            "description": "Text for the card",
                            "inputType": "textarea"
                        }
                    ]
                }
            ]
        }
    ]

パラメーター

オブジェクトの composeExtensions.commands 配列に次のパラメーターを追加する必要があります。

パラメーターの静的リストを使用している場合は、次のパラメーターも追加する必要があります。

埋め込み Web ビューを使用している場合は、必要に応じて taskInfo オブジェクトを追加して、ボットを直接呼び出さずに Web ビューをフェッチできます。 このオプションを選択した場合、動作はパラメーターの静的な一覧を使用する動作と類似します。 ボットとの最初の対話が タスク モジュール送信アクションに応答する場合。 taskInfo オブジェクトを使用している場合は、fetchTask パラメーターを false に設定する必要があります。

詳細については、「 アプリ マニフェスト スキーマ」を参照してください。

次の手順