Tworzenie agentów JavaScript w programie Visual Studio Code przy użyciu zestawu narzędzi Microsoft 365 Agents Toolkit

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

Wymagania wstępne

• Zainstaluj rozszerzenie Agents Toolkit dla programu Visual Studio Code.

• Potrzebujesz modelu platformy Azure z portalu azure AI Foundry. Te dane dotyczące modelu są potrzebne:

  • Nazwa
  • Identyfikator URI obiektu docelowego
  • Klucz

  Dowiedz się, jak dodawać i konfigurować modele do modeli usługi Azure AI Foundry

Tworzenie nowego projektu

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.

Możesz utworzyć nowy projekt agenta, wybierając pozycję Utwórz nowego agenta/aplikację w zestawie narzędzi Microsoft 365 Agents Toolkit. Możesz zacząć od szablonu w pakiecie narzędziowym lub od przykładów w SDK agentów. W tym przewodniku opisano rozpoczęcie pracy z zestawem narzędzi Agents Toolkit.

Aby rozpocząć tworzenie agenta za pomocą SDK Agents, wybierz pozycję Agent silnika niestandardowego z pierwszego menu:

Tworzenie nowego agenta

W przypadku wybrania jako opcji agenta niestandardowego silnika, jesteś prowadzony przez serię instrukcji w celu dodania własnych usług sztucznej inteligencji.

1. Dostępne są dwa szablony: Podstawowy agent niestandardowego silnika lub Agent pogody. Podstawowy agent silnika niestandardowego to agent bez żadnych wstępnie utworzonych elementów. Musisz dodać orkiestrator sztucznej inteligencji, taki jak Semantic Kernel lub LangChain, oraz swoją wiedzę.

   

2. W tym przykładzie wybierz pozycję Weather Agent (Agent pogody ), aby utworzyć agenta korzystającego z biblioteki LangChain i Azure AI Foundry w zależności od wybranego języka.

3. Wybierz pozycję Azure OpenAI dla modelu.

   

   Zostanie wyświetlony monit o podanie klucza, docelowego identyfikatora URI i nazwy modelu platformy Azure z portalu usługi Azure AI Foundry. Te informacje można znaleźć w obszarze Moje zasoby i modele i punkty końcowe w portalu Foundry.

4. Wprowadź szczegóły, zaczynając od klucza:

   

5. Wybierz pozycję JavaScript lub TypeScript, wybierz folder Domyślny, a następnie wprowadź nazwę aplikacji do przechowywania folderu głównego projektu w domyślnej lokalizacji.

   Twój nowy projekt otwiera się.

   

6. Upewnij się, że logujesz się przy użyciu rozszerzenia, wybierając logo platformy Microsoft 365 na pasku narzędzi w programie Visual Studio Code. Upewnij się, że jesteś zalogowany do konta, z którym chcesz nawiązać połączenie.

   

Debugowanie i testowanie agenta na placu zabaw agentów

Możesz debugować i testować swój kod przy użyciu nowego placu zabaw dla agentów platformy Microsoft 365 dostępnego w zestawie narzędzi. Plac zabaw ułatwia łatwe debugowanie kodu, bez konieczności przechodzenia przez pełny cykl wdrażania.

1. Wybierz Debug w Microsoft 365 Agents Playground.

   Po wybraniu środowiska testowego zaczekaj chwilę, aż przygotuje ono twój lokalny komputer z wymaganymi komponentami. Przygotowanie trwa kilka minut.

   

2. Podczas oczekiwania na wdrożenie sprawdź folder kodu i przejrzyj go, aby zapoznać się z nim.

   

3. Po zakończeniu ładowania środowiska do debugowania i testowania, otworzy się przeglądarka i będziesz gotowy do interakcji z agentem, korzystając z interaktywnego środowiska. Jeśli wykonano czynności opisane w przewodniku i użyto wstępnie utworzonego szablonu za pomocą biblioteki LangChain i rozwiązania Azure AI Foundry, możesz zapytać "Jaka jest pogoda w {twojej lokalizacji} jutro?" Agent odpowiada kartą adaptacyjną z pogodą przy użyciu wybranej usługi sztucznej inteligencji.

   

   

Debugowanie i testowanie agenta w rozwiązaniu Microsoft 365 Copilot

Po zakończeniu testowania lokalnego w środowisku testowym agentów można wdrożyć w usłudze Azure Bot Service i skonfigurować dla kanału Microsoft 365 Copilot. Upewnij się, że logujesz się do dzierżawy, która ma dostęp do rozwiązania Microsoft 365 Copilot.

1. Zmień element docelowy debugowania na Copilot, aby można było debugować przy użyciu rozwiązania Microsoft 365 Copilot. Wybierz pozycję F5 lub Debuguj , aby przetestować. Przygotowanie agenta do platformy Microsoft 365 może potrwać kilka minut. W tle zestaw narzędzi tworzy rekord rejestracji aplikacji i usługi Bot Service w usłudze Azure Bot Service i wdraża projekt w dzierżawie wraz z manifestem.

   

2. Gdy to zrobisz, zobaczysz obciążenie platformy Microsoft 365 Copilot i możesz zadawać pytania, dodawać punkty przerwania i debugować, zgodnie z potrzebami, bezpośrednio w rozwiązaniu Microsoft 365 Copilot:

   

Podsumowanie

Udało Ci się teraz:

• Rozpoczęto nowy projekt Microsoft 365 Agents oraz agenta przy użyciu narzędzia Agents Toolkit
• Przetestowano agenta lokalnie przy użyciu placu zabaw dla agentów platformy Microsoft 365
• Wdrożono agenta do debugowania bezpośrednio w kanale platformy Microsoft 365