在本文中，您將瞭解如何使用 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 SDK 建置代理程序開始，請從第一個功能表中選取 [自定義引擎代理程式 ]：
建立新的代理程式
選取自定義引擎代理程式作為選項時，系統會引導您進行一系列提示，以新增您自己的 AI 服務。
您有兩個範本可從中選取： 基本自訂引擎代理程式 或 天氣代理程式。 基本的自定義引擎代理程式是一個代理程式，沒有任何預先建置。 您需要新增 AI 協調器，例如 Semantic Kernel 或 LangChain，以及您的知識。
在此範例中，選取 [天氣代理程式 ] 以根據您選擇的語言，建立使用 LangChain 和 Azure AI Foundry 的代理程式。
為您的模型選取 [Azure OpenAI ]。
系統會從 Azure AI Foundry 入口網站提示您輸入 金鑰、 目標 URI 和 Azure 模型 的名稱 。 您可以在 Foundry 入口網站中的 [我的資產 ] 和 [模型] 和 [端點 ] 下找到這些資訊片段。
輸入詳細資料，從 金鑰開始：
選取 [JavaScript ] 或 [ TypeScript]，選取 [預設] 資料夾，然後輸入 [應用程式名稱 ] 以將專案根資料夾儲存在預設位置。
您的新專案隨即開啟。
選取 Visual Studio Code 工具列上的 Microsoft 365 標誌，確認您已使用延伸模組登入。 確保您已登入要連線的租戶。
在 Agents Playground 中除錯及測試你的代理
您可以使用工具組中可用的新 Microsoft 365 Agent 遊樂場來偵錯及測試程序代碼。 遊樂場可協助您輕鬆地對程式代碼進行偵錯，而不需要進行完整的部署週期。
選取在 Microsoft 365 Agents 遊樂場中偵測。
選取遊樂場時，等待一小段時間，讓它為您的本機電腦準備必要元件。 準備需要幾分鐘的時間。
當您等候部署時，請檢查資料夾是否有程序代碼，並檢閱它以熟悉自己。
偵錯和測試的遊樂場完成載入之後，瀏覽器就會開啟，且您已準備好使用遊樂場與代理程序互動。 如果您按照指南，使用 LangChain 和 Azure AI Foundry 的現成範本，您可以詢問「明天 {您的位置} 的天氣如何？」代理程式將使用您選擇的 AI 服務，透過調適型卡片回應天氣狀況。
在 Microsoft 365 Copilot 中偵錯及測試您的代理程式
當您在 Agents Playground 完成本機測試後，您可以部署至 Azure Bot 服務，並針對 Microsoft 365 Copilot 頻道進行設定。 確定您已登入可存取 Microsoft 365 Copilot 的租用戶。
將偵錯目標變更為 Copilot，讓您可以使用 Microsoft 365 Copilot 進行偵錯。 選取 F5 或 [ 偵錯 ] 進行測試。 需要幾分鐘的準備，讓代理程式可供Microsoft 365 使用。 在幕後，工具組會在 Azure Bot Service 中建立應用程式註冊和 Bot 服務記錄，並將您的專案連同指令清單一起部署到您的租使用者。
一旦您完成這個步驟，您應該會看到 Microsoft 365 Copilot 啟動，並能夠視需要直接在 Microsoft 365 Copilot 中詢問問題、新增斷點和進行偵錯。
總結
您現在已成功：
- 使用 Agents Toolkit 啟動新的 Microsoft 365 Agents 專案和代理程式
- 使用 Microsoft 365 代理程式遊樂場在本機測試代理程式
- 已部署代理程式以直接在 Microsoft 365 頻道中進行偵錯。