Microsoft 365 Agents Toolkit (以前は Teams Toolkit) は、アプリの起動サービスを自動化し、デバッグを開始し、Teams アプリをアップロードします。 デバッグ後、Teams Web クライアントで Teams アプリをプレビューできます。 また、ボット エンドポイントを使用するようにデバッグ設定をカスタマイズしたり、構成済みアプリを読み込むように環境変数をカスタマイズしたりできます。 Visual Studio では、タブ、ボット、およびメッセージ拡張機能をデバッグできます。
前提条件
| インストール | 使用するには... | |
|---|---|---|
| Visual Studio 2022 | Visual Studio のエンタープライズ エディションをインストールし、ASP.NET ワークロードと 開発 ツールMicrosoft Teamsインストールできます。 最新バージョンを使用する | |
| Microsoft 365 Agents Toolkit | アプリのプロジェクト スキャフォールディングを作成する Visual Studio 拡張機能。 最新バージョンを使用します。 | |
| Microsoft Teams | Microsoft Teams、チャット、会議、通話のすべてを 1 か所で行うアプリを通じて、作業するすべてのユーザーと共同作業を行うことができます。 | |
| Microsoft 365 テナントを準備する | アプリをインストールするための適切なアクセス許可を持つ Teams アカウントにアクセスします。 | |
| Microsoft 365 開発者アカウント | アプリをインストールするための適切なアクセス許可を持つ Teams アカウントにアクセスします。 | |
| Azure Tools と Microsoft Azure CLI | 保存されたデータにアクセスしたり、Azure で Teams アプリのクラウドベースのバックエンドをデプロイしたりするための Azure ツール。 |
エージェント ツールキットの主な機能
エージェント ツールキットは、次の主要な機能のローカル デバッグ プロセスを自動化します。
[Microsoft 365 アカウント: エージェント ツールキット] を選択すると、ローカル デバッグの依存関係が準備され、Teams アプリがテナント アカウントに登録されます。 Bot および Message Extension アプリの場合、エージェント ツールキットはボットを登録して構成します。
デバッグの開始: 1 回の操作でデバッグを実行し、 F5 キーを押してデバッグを開始できます。 エージェント ツールキットは、コードをビルドし、サービスを開始し、ブラウザーでアプリを起動します。
ブレークポイントの切り替え: タブ、ボット、メッセージ拡張機能、Azure Functionsのソース コードでブレークポイントを切り替えることができます。 ブレークポイントは、Web ブラウザーで Teams アプリを操作すると実行されます。
次の図は、ブレークポイントの切り替えを示しています。
ホット リロード: デバッグ中にソース コードを更新して保存するときに、[ホット リロード] を選択して Teams アプリに変更を適用します。
![[ホット リロードの選択] アイコンを示すスクリーンショット。](../../assets/images/toolkit-v2/toolkit-vs/vs-localdebug-hot-reload.png)
自動ホット リロードを有効にするには、ドロップダウンから [ファイルの保存] で [ホット リロード] を選択します。
ヒント
ホット リロード関数の詳細については、「.NET ホット リロード エクスペリエンス」を参照してください。
デバッグの停止: ローカル デバッグが完了したら、[ デバッグの停止 (Shift + F5)] を選択します。
![[デバッグの停止] アイコンを示すスクリーンショット。](../../assets/images/toolkit-v2/toolkit-vs/vs-localdebug-stopdebug.png)
環境変数の追加
launchSettings.json ファイルにenvironmentVariablesを追加できます。
Teams アプリを Web アプリとして起動する
Teams クライアントでアプリを実行する代わりに、Teams アプリを Web アプリとして起動できます。 Teams アプリを Web アプリとして起動するには、次の手順に従います。
ソリューション エクスプローラーの [プロジェクト] で、[プロパティ>launchSettings.json] を選択します。
[ソリューション] を右クリックし (このシナリオでは、プロジェクト名は M365Agents)、[プロパティ] の順に選択します。
[ソリューション プロパティ ページ] ダイアログ ボックスが表示されます。
ダイアログ ボックスで [ 構成プロパティ>構成 ] を選択します。
[ デプロイ ] チェック ボックスをオフにします。
[OK] を選択します。
Next
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Platform Docs