Microsoft 365 エージェント ツールキットの環境

Microsoft 365 Agents Toolkit (旧称 Teams Toolkit) を使用してエージェントまたはアプリをビルドすることは、多くの場合、ローカル、開発、遊び場などの異なるターゲットで同じプロジェクトを実行することです。 環境は、同じプロジェクト構造とライフサイクル コマンドを再利用しながら、各ターゲットを個別に保持します。 エージェント ツールキットは、環境固有の設定 in .env.<environment-name> ファイルを格納します。 各ファイルは、そのターゲットの変数と出力をキャプチャするため、毎回リソースを再構成することなく、プロビジョニング、デプロイ、発行を行うことができます。

この記事では、これらの環境ファイルのしくみ、ローカル環境とリモート環境の違い、エージェントまたはアプリ プロジェクトに新しい環境を追加する方法、およびワークフローの特定の環境をターゲットにする方法について説明します。

エージェント ツールキットでの環境ファイルの使用

Agents Toolkit は、 .env.{environment-name}などの環境ファイルの標準の名前付けパターンに従います。 プロビジョニング、デプロイ、発行などのライフサイクル コマンドを実行する場合は、環境名を指定する必要があります。 この名前は、対応する環境ファイルで使用される {environment-name} と一致する必要があります。

環境ファイルの場所

既定では、Agents Toolkit は環境変数を読み込むのでアクションを実行するだけで、出力を ./env/.env.devに保存します。 environmentFolderPathを指定しない場合、.env ファイルから変数が読み取られず、環境が dev に設定され、出力が ./env/.env.dev に向けられると想定されます。

ローカル環境

Microsoft Teams エージェントまたはアプリのビルドには、クラウドリソースとローカル リソースの両方が含まれます。 クラウド リソースにはアプリの登録と Teams クライアントが含まれますが、エージェントまたはアプリ ロジックはローカルで実行して開発とテストを高速化できます。 すべての Agents Toolkit テンプレートには、./env/.env.localファイルと./env/.env.local.user ファイルを含む構成済みのlocal環境が含まれています。 このセットアップを使用すると、ローカル Web サーバーでエージェントまたはアプリを実行し、Visual Studio Code (JavaScript、TypeScript、または Python エージェントまたはアプリの場合) または Visual Studio (CSharp エージェントまたはアプリの場合) でブレークポイントを使用してデバッグできます。

ローカル環境とその他のすべての環境を区別するために、m365agents.ymlと同じディレクトリに m365agents.local.yml という名前の別のプロジェクト ファイルを作成できます。

Visual Studio Code で新しい環境を手動で作成する

各プロジェクトには、1 つのローカル環境と複数のリモート環境を含めることができます。 プロジェクトを作成すると、Agents Toolkit によって次の既定の環境が構成されます。

• ローカル コンピューター環境の構成を表すローカル環境。
• リモート またはクラウド環境の構成を表す開発環境。

新しい環境を作成するには:

1. Visual Studio Code で Teams エージェントまたはアプリ プロジェクト ワークスペースを開きます。

2. Visual Studio Code アクティビティ バーから Microsoft 365 Agents Toolkit アイコンを選択します。

3. [環境] セクションで+ アイコンを選択します。

   

4. 環境の名前を入力し、[Enter] を選択 します。

   

リモート ビルドの環境をターゲットとする

複数の環境を使用する場合は、ターゲット環境を選択して、Microsoft Teamsでエージェントまたはアプリをビルド、デバッグ、プレビューする必要があります。 ターゲット環境は、ビルド設定から直接選択できます。

環境を選択する

開発またはその他のカスタム環境をターゲットにするには:

1. エージェント ツールキットの [ライフサイクル ] セクションで、エージェントまたはアプリの [プロビジョニング ] を選択します。

   

2. プロンプトが表示されたら、使用可能な環境 ( dev やカスタム環境など) のいずれかを選択します。

   

エージェント ツールキットは、選択した環境用にエージェントまたはアプリをプロビジョニングします。 選択した環境でエージェントまたはアプリをビルドできるようになりました。

選択した環境でビルドする

環境が選択されると、エージェント ツールキットによって、その環境のエージェントまたはアプリがプロビジョニングされます。 選択した環境でエージェントまたはアプリをビルド、デバッグ、実行できるようになりました。

1. Visual Studio Code サイドバーから [ Run and Debug ] アイコンを選択します。

2. デバッグするオプションを選択し、Microsoft Teamsでリモート エージェントまたはアプリをプレビューします。

   

エージェント ツールキットは、プロビジョニングした環境にエージェントまたはアプリをビルドします。 エージェントまたはアプリは、Teams での表示とテストに使用できます。

関連項目

• Microsoft 365 Agents Toolkit の概要
• Teams のアプリ マニフェストのスキーマ
• クラウド リソースをさらに追加する
• Teams プロジェクトで他の開発者と協力する
• 異なる環境でアプリの動作をテストする