この記事では、Microsoft 365 Agents Toolkit を使用して、Visual Studio で新しい Agents SDK JavaScript プロジェクトを作成する方法について説明します。
[前提条件]
Visual Studio Code 用 Agents Toolkit 拡張機能をインストールします。
Azure AI Foundry ポータルから Azure モデルが必要です。 モデルに関するこのデータが必要です。
- 名前
- ターゲット URI
- 鍵
新しいプロジェクトを作成する
Agents Toolkit には、エージェントの構築を開始するのに役立つプロジェクト テンプレートが用意されています。 ツールキットのテンプレートから、または Agents SDK のサンプルから開始できます。
注
以下の手順は、現在、JavaScript と TypeScript でのみ機能します。 Python のサポートが計画されています。
Microsoft 365 Agents Toolkit で [ 新しいエージェント/アプリの作成 ] を選択して、新しいエージェント プロジェクトをビルドできます。 ツールキットのテンプレートから、または Agents SDK のサンプルから開始できます。 このガイドでは、Agents Toolkit の使用を開始する方法について説明します。
エージェント SDK を使用したエージェントの構築を開始するには、最初のメニューから カスタム エンジン エージェント を選択します。
新しいエージェントを作成する
カスタム エンジン エージェントをオプションとして選択すると、独自の AI サービスに追加するための一連のプロンプトが表示されます。
選択できるテンプレートは、 Basic Custom Engine Agent または Weather Agent の 2 つあります。 基本的なカスタム エンジン エージェントは、何も事前構築されていないエージェントです。 セマンティック カーネルや LangChain などの AI オーケストレーターと知識を追加する必要があります。
この例では、 Weather Agent を選択して、選択した言語に応じて LangChain と Azure AI Foundry を使用するエージェントを作成します。
モデルの Azure OpenAI を選択します。
Azure AI Foundry ポータルから、 キー、 ターゲット URI、Azure モデルの 名前 の入力を求められます。 これらの情報は、Foundry ポータルの [ マイ アセット と モデルとエンドポイント ] にあります。
詳細を入力してください。まずキーから始めます。
JavaScript または TypeScript を選択し、既定のフォルダーを選択し、プロジェクトのルート フォルダーを既定の場所に格納するアプリケーション名を入力します。
新しいプロジェクトが開きます。
Visual Studio Code のツール バーで Microsoft 365 ロゴを選択して、拡張機能を使用してサインインしていることを確認します。 接続するテナントにサインインしていることを確認します。
Agents Playground でエージェントをデバッグしてテストする
ツールキットで使用できる新しい Microsoft 365 Agent Playground を使用して、コードをデバッグしてテストできます。 プレイグラウンドは、完全なデプロイ サイクルを経ることなく、コードを簡単にデバッグするのに役立ちます。
Microsoft 365 Agents Playground で [デバッグ] を選択します。
プレイグラウンドを選択したら、必要なコンポーネントを使用してローカル コンピューターが準備されるまで少し待ちます。 準備には数分かかります。
デプロイを待っている間に、フォルダーでコードを確認し、確認して理解を深めます。
デバッグとテスト用のプレイグラウンドの読み込みが完了すると、ブラウザーが開き、プレイグラウンドを使用してエージェントと対話する準備が整います。 ガイドに従い、LangChain と Azure AI Foundry で事前構築済みのテンプレートを使用した場合は、"明日の {your location} の天気は何ですか?エージェントは、選択した AI サービスを使用して、天気に応じたアダプティブ カードで応答します。
Microsoft 365 Copilot でエージェントをデバッグしてテストする
Agents Playground でローカルでテストが完了したら、Azure Bot Service にデプロイし、Microsoft 365 Copilot チャネル用に構成できます。 Microsoft 365 Copilot にアクセスできるテナントにログインしていることを確認します。
Microsoft 365 Copilot を使用してデバッグできるように、デバッグ ターゲットを Copilot に変更します。 F5 キーまたは [デバッグ] を選択してテストします。 エージェントを Microsoft 365 で使用できるようにするには、数分の準備が必要です。 このツールキットは、バックグラウンドで Azure Bot Service にアプリ登録と Bot Service レコードを作成し、マニフェストと共にプロジェクトをテナントにデプロイします。
これを行うと、Microsoft 365 Copilot の読み込みが表示され、必要に応じて、Microsoft 365 Copilot で直接、質問したり、ブレークポイントを追加したり、デバッグしたりできます。
概要
これで、次の操作が正常に完了しました。
- Agents Toolkit を使用して新しい Microsoft 365 エージェント プロジェクトとエージェントを開始しました
- Microsoft 365 Agents Playground を使用してエージェントをローカルでテストしました
- Microsoft 365 チャネルで直接デバッグするためのエージェントを展開しました