使用 Microsoft 365 代理程式工具組在 Visual Studio 中建立 .NET 代理程式

在本文中,您將瞭解如何使用 Microsoft 365 代理程式工具組,在 Visual Studio 中建立新的代理程式 SDK .NET 專案。

先決條件

建立新專案

代理程式工具組提供專案範本,可協助您開始建置代理程式。 您可以從工具組中的範本,或從 Agents SDK 中的範例開始。 本文檔重點介紹代理工具包中可用的範本。 有不同的範本和選項可用來使用工具包來建立 Agents SDK 專案。 本攻略重點在於使用 語意核心 和 Azure AI Foundry 來建立一個 Weather Agent。

Note

下列程式目前僅適用於 .NET。

  1. 打開Visual Studio並選擇 建立新專案。

  2. 搜尋「agent」即可找到使用 Microsoft 365 代理工具包與 Agents SDK 的新範本。

  3. 選擇 Microsoft 365 代理程式,然後選擇下一步。

    建立新專案

    會出現一個對話方塊,以便您可以命名代理程式。 如果需要,您也可以變更位置和解決方案名稱。

  4. 完成後,選擇 建立

    設定您的新專案

    您可以選取工具組提供的幾個不同選項,用於建立代理程式。

  5. 在此教程中,請選擇 Weather Agent>Next 範例以使用 Microsoft 365 Agents SDK。 此預建範例透過 Azure AI Foundry 或 Azure OpenAI 模型來實作協調流程的 語意核心。 如果你想在沒有模型或編排器的情況下開始,也可以使用 Empty agent 範例。

    選取要建立的應用程式類型

    一個對話框會提示你選擇你想使用的 LLM 服務。

    選取要用於模型的 llm 類型

  6. 在本操作指南中,請選擇 Azure OpenAI。

    您可以在 Azure AI Foundry 的 [模型和端點] 底下找到此資訊。

    設定設定以連線到所選的 LLM 服務

  7. 填寫所需輸入:Azure OpenAI 服務金鑰、Azure OpenAI 端點,以及 Azure OpenAI 部署名稱。

  8. 選取 ,創建。 工具包會根據範本幫你建立專案。

  9. 不久後,你應該就能用 Agents SDK 建立一個新專案。

    編輯器中的應用程式程式碼

在 Microsoft 365 Agents Playground 中測試您的代理程式

若要開始使用,您可以使用工具組中的 Microsoft 365 代理程式遊樂場在本機進行測試。

要開始測試,請將專案中的除錯目標設為Microsoft 365 Agents Playground」。

遊樂場會開啟,讓您使用本機主機在新的瀏覽器視窗中進行測試,並顯示已準備好進行測試的遊樂場。 開始向你的客服發送訊息測試其行為。

在 Microsoft Teams 或 Microsoft Copilot 中除錯並測試您的代理程式

你也可以設定除錯目標直接在 Microsoft Teams 或 Microsoft Copilot 中。

  1. 從目標清單中選取其中一個偵錯選項作為偵錯目標。

    選取 [Microsoft Teams] (瀏覽器)

    切換到 Microsoft Teams 需要幾分鐘。 系統會提示您在開啟的 Teams 用戶端中新增代理程式。

    Teams 提示新增客服專員

  2. 選取 新增。 通知窗格隨即出現,表示代理程式已成功新增。

    代理程式已成功新增至 Teams,提示開啟

  3. 在您的新代理上選取「開啟」以在 Teams 中開啟。 你可以直接在 Teams 裡問你的客服人員問題。 您可以設定中斷點,以便在需要時透過偵錯解決您的體驗問題。

    在 Microsoft Copilot 中執行的代理程式

Summary

您現在已成功:

  • 使用 Agents Toolkit 啟動新的 Microsoft 365 Agents 專案和代理程式
  • 使用 Microsoft 365 代理程式遊樂場在本機測試代理程式
  • 已直接在 Teams 或 Microsoft 365 通道中部署代理程式進行偵錯