Microsoft 365 エージェントツールキットを使用して Visual Studio で .NET エージェントを作成する

この記事では、Microsoft 365 Agents Toolkit を使用して、Visual Studio で新しい Agents SDK .NET プロジェクトを作成する方法について説明します。

必要条件

Visual Studio 用の Agents Toolkit 拡張機能をインストールします。
Azure AI Foundry ポータルから取得した Azure OpenAI モデル。モデルに関する以下のデータが必要です。
- 名前
- ターゲット URI
- キー

新しいプロジェクトの作成

エージェントツールキットは、エージェント構築の開始に役立つプロジェクトテンプレートを提供します。ツールキットのテンプレートから開始することも、Agents SDK のサンプルから開始することもできます。このドキュメントでは、Agents Toolkit で利用可能なテンプレートについて解説します。このツールキットを使用して Agents SDK プロジェクトを作成する際には、さまざまなテンプレートやオプションが用意されています。このチュートリアルでは、Semantic Kernel と Azure AI Foundry を使用してウェザーエージェントを作成する方法に焦点を当てています。

注意

現時点では .NET のみ対応しています。

Visual Studio を開き、 [新しいプロジェクトの作成] を選択します。「エージェント」と検索して、Microsoft 365 Agent Toolkit および Agents SDK を使用した新しいテンプレートを探します。Microsoft 365 エージェント>次へを選択します。

エージェントに名前を付けるためのダイアログが表示されます。必要に応じて、場所やソリューション名を変更することもできます。
完了したら、作成を選択します

ツールキットが提供するエージェント作成用のさまざまなオプションを選択できます。
この手順では、ウェザーエージェント>次へのサンプルを選択して Microsoft 365 エージェント SDK を使用します。この事前構築済みのサンプルは、Azure AI Foundry または Azure OpenAI モデルとのオーケストレーションのために Semantic Kernel を実装したものです。モデルやオーケストレーターを使わずに始めたい場合は、「Empty エージェント」のサンプルを使用することもできます。

ダイアログが表示され、選択する LLM サービスの入力を求められます。
このチュートリアルでは、Azure OpenAI を選択します。

この情報は、Azure AI Foundry のモデルとエンドポイント セクションで確認できます。
必要な入力項目、Azure OpenAI サービスキー、Azure OpenAI エンドポイント、Azure OpenAI 展開名 を入力してください。
作成を選択します。ツールキットはテンプレートを使って自動的にプロジェクトを作成します。
間もなく、Agents SDK を使用して新しいプロジェクトが作成されるはずです。

Microsoft 365 Agents プレイグラウンドでエージェントをテストする

まずは、ツールキット内の Microsoft 365 Agents プレイグラウンドを使用して、ローカル環境でテストを行うことができます。

テストを開始するには、プロジェクトのデバッグ対象を Microsoft 365 Agents プレイグラウンドに設定してください。

プレイグラウンドが開き、新しいブラウザーウィンドウでローカルホストを使用してテストできるようになり、テスト準備が整った状態のプレイグラウンドが表示されます。エージェントへのメッセージ送信を開始し、その動作をテストしてください。

Microsoft Teams または Microsoft 365 Copilot でエージェントのデバッグとテストを行う

また、デバッグ対象を Microsoft Teams または Microsoft 365 Copilot 内に直接設定することもできます。

ターゲットの一覧から、デバッグ対象としてデバッグオプションを 1 つ選択します。

Microsoft Teams に切り替えるには、少し時間がかかります。開いた Teams クライアントで、エージェントを追加するよう求められます。
追加を選択します。エージェントが正常に追加されたことを示す通知パネルが表示されます。
新しいエージェントで開くを選択して、Teams で開きます。 Teams で直接エージェントに質問できます。必要に応じて、ブレークポイントを設定し、エクスペリエンスのデバッグを行うことができます。