Microsoft Teams アプリに機能を追加する
Teams Toolkit を使用して機能を追加すると、既存の Microsoft Teams アプリの機能を拡張できます。 より多くの機能を追加する利点は、Teams Toolkit を使用して必要なコードとプロジェクト ファイルを自動的に追加することで、アプリに関数を追加できることです。 Teams アプリ用に作成したアプリ プロジェクトに基づいて、さまざまな機能を選択できます。 次の表に、Teams アプリの機能を示します。
| 機能 | 説明 | その他のサポートされている機能 |
|---|---|---|
| Basic Teams アプリ | ||
| Tab | 基本的なタブは、アプリ マニフェストで宣言されたドメインを参照する単純な HTML タグです。 個々のユーザーのチーム、グループ チャット、または個人用アプリ内のチャネルの一部としてタブを追加できます。 | [基本] タブ、通知ボット、コマンド ボット、基本ボット、および基本的なメッセージ拡張機能 |
| ボット | ボットは、テキスト、対話型カード、タスク モジュールを介して Web サービスと対話するのに役立ちます。 | 基本的なメッセージ拡張機能、SSO 対応タブ、および基本タブ |
| メッセージ拡張機能 | メッセージ拡張機能は、Microsoft Teams クライアントのボタンとフォームを使用して Web サービスと対話するのに役立ちます。 | 基本ボット、SSO 対応タブ、および基本タブ |
| シナリオ ベースの Teams アプリ | ||
| 通知ボット | 通知ボットは、Teams チャネルまたはグループ チャット、または個人用チャットでメッセージを事前に送信します。 通知ボットは、カードやテキストなどの HTTP 要求でトリガーできます。 | SSO 対応タブと基本タブ |
| コマンド ボット | コマンド ボットを使用すると、コマンド ボットを使用して反復的なタスクを自動化できます。 アダプティブ カードを使用してチャットで送信される簡単なコマンドに応答します。 | SSO 対応タブと基本タブ |
| ワークフロー ボット | ワークフロー ボットを使用すると、ユーザーはワークフロー ボット アプリのアダプティブ カード アクション ハンドラーによって有効になっているアダプティブ カードと対話できます。 | SSO 対応タブと基本タブ |
| [SPFx] タブ | Microsoft 365 は SPFx タブ アプリをホストし、クライアント側のSharePoint Framework (SPFx) ソリューションの開発とホストをサポートします。 | None |
| [SSO 対応] タブ | シングル サインオン (SSO) を使用してユーザーがアプリにアクセスできるようにする SSO 対応タブ アプリを構築できます。 | SSO 対応タブ、通知ボット、コマンド ボット、基本ボット、および基本的なメッセージ拡張機能 |
注:
タブは最大 16 個のインスタンスに追加できます。 各インスタンスに一度に 1 つのボットと 1 つのメッセージ拡張機能を追加できます。
機能の追加
次の方法で機能を追加できます。
[Teams ツールキットの使用] ウィンドウ
Visual Studio Code でアプリ プロジェクトを開きます。
Visual Studio Code アクティビティ バーから [Teams Toolkit ] を選択します。
[開発] セクションで [機能の追加] を選択します。
表示されるドロップダウン リストから、アプリに追加する機能を選択します。
Teams Toolkit は、選択した機能をアプリに追加し、新しい機能のアプリ ディレクトリ構造を更新します。 Teams アプリに機能が正常に追加されたら、環境ごとにプロビジョニングする必要があります。
コマンド パレットを使用する
Visual Studio Code でアプリ プロジェクトを開きます。
[ コマンド パレットの表示>]を選択します 。または Ctrl + Shift + P キーを押します。
[ Teams: 機能の追加] を選択します。
表示されるドロップダウン リストから、アプリに追加する機能を選択します。
Teams Toolkit は、選択した機能をアプリに追加し、新しい機能のアプリ ディレクトリ構造を更新します。 Teams アプリに機能が正常に追加されたら、環境ごとにプロビジョニングする必要があります。
TeamsFx CLI を使用する
TeamsFx CLI は、Teams アプリ プロジェクトに機能を追加するための別の方法として使用できます。
このセクションでは、TeamsFx CLI コマンドを使用して Teams アプリに追加できる機能の一覧を示します。 アプリに機能を追加する前に、ディレクトリをプロジェクト ディレクトリに変更したことを確認してください。
次の表に、それらを追加するための機能と TeamsFx CLI コマンドの一覧を示します。
| 機能とシナリオ | command |
|---|---|
| 通知ボットを追加するには | teamsfx add notification |
| コマンド ボットを追加するには | teamsfx add command-and-response |
| SSO 対応タブを追加するには | teamsfx add sso-tab |
| タブを追加するには | teamsfx add tab |
| ボットを追加するには | teamsfx add bot |
| メッセージ拡張機能を追加するには | teamsfx add message extension |
機能を追加した後の変更
次の表は、機能を追加した後にアプリのファイルに表示できる変更を示しています。
| 機能の追加 | 説明 | 変更内容 |
|---|---|---|
| 基本的なボット、基本的なメッセージ拡張機能、および基本タブ | 基本的なボットまたは基本的なタブ アプリ テンプレートをプロジェクトに含めます。 | Teams Toolkit では、フロントエンド ボットまたはタブ テンプレート コードがそれぞれパス yourProjectFolder\bot または yourProjectFolder\tabのサブフォルダーに追加されます。 |
| 基本的なボット、メッセージ拡張機能、および基本タブ | Visual Studio Code に必要なスクリプトが含まれており、アプリをローカルでデバッグするときに実行されます。 | Teams Toolkit では、フォルダーの下にある launch.json ファイルと task.json ファイルが .vscode 更新されます。 |
| 基本的なボットと基本的なメッセージ拡張機能 | 基本ボットまたは基本タブ アプリのマニフェスト ファイルを更新します。 この情報は、Teams プラットフォーム内のアプリを表します。 | Teams Toolkit は、フォルダーの下templates\appPackageのファイルmanifest.template.jsonを更新します。 マニフェスト ファイルには、Teams プラットフォーム内のアプリを表すタブ関連の情報が含まれています。 変更は、ボットの ID、ボットのスコープ、ボットまたはタブ アプリが応答できるコマンドに表示されます。 |
| [基本] タブ | 基本的なボットまたは基本タブのマニフェスト ファイルに情報を含めます。この情報は、Teams プラットフォーム内のアプリを表します。 | フォルダーの下の templates\appPackage Teams Toolkit の更新。manifest.template.json マニフェスト ファイルには、Teams プラットフォーム内のアプリを表すタブ関連の情報が含まれています。 変更は、構成可能なタブとタブの静的なタブとスコープに表示されます。 |
| 基本的なボット、基本的なメッセージ拡張機能、および基本タブ | 基本的なボットまたはタブ アプリの TeamsFx の情報が含まれます。 また、Azure Functionsを統合するためのプロビジョニング ファイルも含まれています。 | の下の templates\azure\teamsfx ファイルが更新され、 templates\azure\provision\xxx.bicep ファイルが再生成されます。 |
| 基本的なボット、基本的なメッセージ拡張機能、および基本タブ | 新しく追加された機能に適した構成でプロジェクトを設定していることを確認します。 | Teams Toolkit では、 の下 .fx\configのファイルが再生成されます。 |
ステップ バイ ステップのガイド
Teams でコマンド ボットを構築するには 、ステップバイステップ ガイドに従います。
Teams で通知ボットを構築するには 、ステップバイステップ ガイドに従います。
詳細 な ガイドに従って、Teams でワークフロー ボットを構築します。