Tworzenie agentów platformy .NET w programie Visual Studio przy użyciu zestawu narzędzi agentów usługi Microsoft 365

W tym artykule dowiesz się, jak utworzyć nowy projekt Agents SDK .NET w Visual Studio, korzystając z Microsoft 365 Agents Toolkit.

Wymagania wstępne

• Zainstaluj rozszerzenie Agents Toolkit dla Visual Studio dla Visual Studio.

• Model Azure OpenAI z portalu Azure AI Foundry. Potrzebujesz następujących danych o modelu:

  • Nazwa
  • Docelowy adres URI
  • Klucz

Tworzenie nowego projektu

Zestaw narzędzi agentów udostępnia szablon projektu, który pomaga rozpocząć tworzenie agenta. Możesz zacząć od szablonu w zestawie narzędzi lub z przykładów w pakiecie SDK agentów. Niniejszy dokument koncentruje się na szablonach dostępnych w Agents Toolkit. Istnieją różne szablony i opcje dostępne do tworzenia projektów Agents SDK za pomocą zestawu narzędzi. Ten przewodnik pokazuje, jak utworzyć agent pogodowy z użyciem Semantic Kernel i Azure AI Foundry.

1. Otwórz program Visual Studio i wybierz pozycję Utwórz nowy projekt. W polu wyszukiwania wpisz "agent", aby znaleźć nowe szablony dostępne dzięki Microsoft 365 Agent Toolkit i Agents SDK. Wybierz Microsoft 365 Agents>Dalej.

   

   Pojawia się okno dialogowe, aby można było nazwać agenta. Możesz też zmienić lokalizację i nazwę rozwiązania, jeśli chcesz.

2. Po zakończeniu wybierz Utwórz

   

   Możesz wybrać kilka różnych opcji dostępnych w zestawie narzędzi do tworzenia agentów.

3. W tym przewodniku wybierz przykład Agent pogody>Dalej, aby użyć zestawu SDK agentów usługi Microsoft 365. Ten gotowy przykład wykorzystuje Semantic Kernel do orkiestracji z modelami Azure AI Foundry lub Azure OpenAI. Możesz także użyć przykładu „Empty agent”, jeśli chcesz rozpocząć pracę bez modelu lub orchestratora.

   

   

   Pojawi się monit z prośbą o wybór usługi LLM.

4. Na potrzeby tego przewodnika wybierz opcję Azure OpenAI.

   Informacje te można znaleźć w Azure AI Foundry w sekcji Modele i punkty końcowe.

   

5. Wprowadź wymagane dane: klucz usługi Azure OpenAI, punkt końcowy Azure OpenAI oraz nazwa wdrożenia Azure OpenAI.

6. Wybierz pozycję Utwórz. Zestaw narzędzi tworzy projekt na podstawie szablonu.

7. Po chwili będziesz mieć nowy projekt utworzony przy użyciu Agents SDK.

   

Testowanie agenta lokalnie w środowisku testowym agentów usługi Microsoft 365

Aby zacząć, możesz przetestować lokalnie za pomocą Microsoft 365 Agents Playground w zestawie narzędzi Toolkit.

Aby rozpocząć testowanie, wybierz jako cel debugowania w swoim projekcie Microsoft 365 Agents Playground”.

Środowisko testowe do testowania otworzy się w nowym oknie przeglądarki z hostem lokalnym. Będzie to środowisko testowe gotowe do przetestowania. Zacznij wysyłać wiadomości do swojego agenta, aby przetestować jego zachowanie.

Debuguj i testuj swojego agenta w Microsoft Teams lub Microsoft 365 Copilot

Możesz też ustawić cel debugowania bezpośrednio w Microsoft Teams lub Microsoft 365 Copilot.

1. Wybierz jedną z opcji debugowania z listy, która będzie celem debugowania.

   

   Przełączenie do Microsoft Teams zajmuje kilka chwil. Wyświetli się monit o dodanie agenta w otwartym kliencie Teams.

   

2. Wybierz „Dodaj”. Pojawia się panel powiadomień, informujący o pomyślnym dodaniu agenta.

   

3. Wybierz Otwórz przy swoim nowym agencie, aby otworzyć go w aplikacji Teams. Możesz zadawać swojemu agentowi pytania bezpośrednio w Teams. Można ustawić punkty przerwania, aby ułatwić debugowanie środowiska, gdy będzie to potrzebne.

   

Sumaryczny

Pomyślnie wykonano następujące czynności:

• Rozpoczęto nowy projekt Microsoft 365 Agents oraz agenta przy użyciu narzędzia Agents Toolkit
• Lokalne testowanie agenta przy użyciu środowiska testowego agentów Microsoft 365
• Wdrożono agenta do debugowania bezpośrednio w kanale Teams lub kanale Microsoft 365