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

Z tego artykułu dowiesz się, jak utworzyć nowy projekt sdk agentów platformy .NET w programie Visual Studio przy użyciu zestawu narzędzi Microsoft 365 Agents Toolkit.

Wymagania wstępne

Utwórz nowy projekt

Zestaw narzędzi Agents Toolkit udostępnia szablon projektu, który ułatwia rozpoczęcie tworzenia agenta. Możesz zacząć od szablonu w pakiecie narzędziowym lub od przykładów w SDK agentów. Ten dokument koncentruje się na szablonach dostępnych w zestawie narzędzi Agents Toolkit. Dostępne są różne szablony i opcje do tworzenia projektów SDK agentów za pomocą zestawu narzędzi. Ten przewodnik koncentruje się na tworzeniu agenta pogody przy użyciu Semantic Kernel i Azure AI Foundry.

Note

Procedura, która obecnie działa, jest przeznaczona tylko dla platformy .NET.

  1. Otwórz Visual Studio i wybierz Utwórz nowy projekt.

  2. Wyszukaj "agent", aby znaleźć nowe szablony wykorzystujące zestaw narzędzi Microsoft 365 Agent Toolkit i Agents SDK.

  3. Wybierz Microsoft 365 Agents, a następnie wybierz Następny.

    Tworzenie nowego projektu

    Zostanie wyświetlone okno dialogowe, w którym można nazwać agenta. Możesz również zmienić lokalizację i nazwę rozwiązania, jeśli chcesz.

  4. Po zakończeniu wybierz pozycję Utwórz

    Konfigurowanie nowego projektu

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

  5. W tym przewodniku wybierz przykład Agent pogody>Dalej, aby użyć zestawu SDK agentów usługi Microsoft 365. Ten wstępnie zbudowany przykład implementuje Semantic Kernel do orkiestracji z modelami Azure AI Foundry lub Azure OpenAI. Możesz również użyć przykładu "Empty agent", jeśli chcesz rozpocząć bez modelu lub orkiestratora.

    Wybierz typ aplikacji do utworzenia

    Okno dialogowe prosi cię o wybór usługi LLM, której chcesz użyć.

    Wybierz typ llm do użycia dla modelu

  6. W tym przewodniku wybierz pozycję Azure OpenAI.

    Te informacje można znaleźć w artykule Azure AI Foundry w obszarze Modele i punkty końcowe.

    Konfigurowanie ustawień w celu nawiązania połączenia z wybraną usługą LLM

  7. Wypełnij wymagane dane wejściowe: klucz usługi Azure OpenAI, punkt końcowy usługi Azure OpenAI i nazwę wdrożenia Azure OpenAI.

  8. Wybierz Utwórz. Zestaw narzędzi tworzy projekt na podstawie szablonu dla Ciebie.

  9. W krótkim czasie powinieneś mieć nowy projekt utworzony z pomocą SDK agentów.

    Kod aplikacji w edytorze

Testowanie agenta na placu zabaw dla agentów platformy Microsoft 365

Aby rozpocząć pracę, możesz testować lokalnie przy użyciu narzędzia Microsoft 365 Agents Playground w zestawie narzędzi.

Aby rozpocząć testowanie, ustaw element docelowy debugowania w projekcie na Microsoft 365 Agent 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ć komunikaty do agenta, aby przetestować jego zachowanie.

Debuguj i testuj swojego agenta w Microsoft Teams lub Microsoft Copilot

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

  1. Wybierz jedną z opcji debugowania jako element docelowy debugowania z listy obiektów docelowych.

    Wybierz Microsoft Teams w przeglądarce

    Przełączenie się na Microsoft Teams zajmuje kilka chwil. Zostanie wyświetlony monit o dodanie agenta do otwieranego klienta usługi Teams.

    Polecenie Teams dotyczące dodania agenta

  2. Wybierz pozycję Dodaj. Zostanie wyświetlone okienko powiadomień wskazujące, że agent został dodany pomyślnie.

    Agent został pomyślnie dodany do usługi Teams, monit o otwarcie

  3. Wybierz pozycję Otwórz dla nowego agenta, aby otworzyć go w aplikacji Teams. Pytania dotyczące agenta można zadawać bezpośrednio w usłudze Teams. Można ustawić punkty przerwania, aby ułatwić debugowanie środowiska, gdy będzie to potrzebne.

    Agent działający w Microsoft Copilot

Podsumowanie

Udało Ci się teraz:

  • Rozpoczęto nowy projekt i nowego agenta platformy Microsoft 365 przy użyciu zestawu narzędzi Agents Toolkit.
  • Przetestowano agenta lokalnie przy użyciu placu zabaw dla agentów platformy Microsoft 365
  • Wdrożono agenta na potrzeby debugowania bezpośrednio w kanale usługi Teams lub platformy Microsoft 365