次の方法で共有


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

Microsoft 365 Agents Toolkit (以前は Teams Toolkit と呼ばれる) には、開発、ステージング、運用環境、またはコンピューター上のローカルでの展開のさまざまなターゲットでアプリを実行およびテストする方法が用意されています。 これを行うために、Agents Toolkit には、環境ファイル内の情報を使用して、これらの異なるターゲットの構成を調整するオプションの機能セットが含まれています。 環境ファイルは、デプロイ ターゲットのすべてのリソースのコレクションを表します。 Agents Toolkit プロジェクト テンプレートには、2 つの既定の環境グループが含まれています。1 つは、"local" という名前のコンピューターでアプリを実行するためのグループと、"dev" という名前の別の場所をホストするためのグループです。 "dev" 環境の名前を変更し、[環境] ウィンドウを使用して別の環境を追加するか、新しい .env.{environment-name} ファイルで手動で追加できます。 ローカル環境の名前を変更することはできません。

エージェント ツールキットは、さまざまな環境ファイルを追加することで、アプリを実行し、それらのリソースにコードをデプロイするために必要なリソースのプロビジョニングを自動化するのに役立ちます。 これらの機能を使用して、環境の数に対して 1 つのデプロイ 規則のセットを作成できます。

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

Agents Toolkit では、 .env.{environment-name} などの環境ファイルの名前付け規則が使用されます。 ツールキットのライフサイクル コマンド (プロビジョニング、デプロイ、または発行) を使用して、環境名を指定する必要があります。 環境の名前は、環境ファイルの作成時に {environment-name} に選択した値と同じである必要があります。

注:

現在のシェル環境で Agents Toolkit の環境変数を定義できます。これは、名前付けの競合中に .env ファイル内の値をオーバーライドします。

環境ファイルの場所

既定では、Agents Toolkit は env 変数を読み込むので、アクションの実行を続行し、出力を ./env/.env.devに書き込むだけです。 environmentFolderPathが定義されていない場合、Agents Toolkit は.env ファイルから環境変数を読み込まず、env が dev であると仮定してアクションを実行します。 出力は、 ./env/.env.devに書き込まれます。

ローカル環境

Microsoft Teams アプリを構築するには、アプリの登録や Teams クライアントなどの特定のリソースがクラウドでホストされます。 ただし、アプリケーション ロジックなどの他のリソースをローカルでホストして、アプリ開発中のテストの変更を簡略化できます。 すべての Agents Toolkit プロジェクト テンプレートとサンプルは、 local 環境で構成されます。 ローカル環境には ./env/.env.local./env/.env.local.user ファイルがあり、ローカルでホストされている Web サーバーでアプリを実行するのに役立ちます。 Visual Studio Code (VS Code) と Visual Studio (VS) を使用する場合、ブレークポイントでのデバッグをサポートするようにプロジェクト テンプレートとサンプルが設定されます。

ローカル環境とその他のすべての環境を区別するために、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] を選択 します

    環境名を入力する場所を示すスクリーンショット。

環境のターゲット設定

複数の環境があり、[運用]、[開発]、または [ローカル] メニュー項目を選択すると、エージェント ツールキットからターゲット環境の選択が求められます。

[運用環境] が選択されていることを示すスクリーンショット。

関連項目