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 Azure OpenAI z portalu Microsoft Foundry. Potrzebne są następujące dane dotyczące modelu:

  • Nazwa
  • Identyfikator URI obiektu docelowego
  • Klucz

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

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.

1. W Visual Studio Code otwórz panel boczny rozszerzenia Microsoft 365 Agents Toolkit, wybierając ikonę Microsoft 365 Agenci na pasku bocznym.

2. Aby utworzyć nowy projekt agenta, wybierz pozycję Utwórz nowego agenta/aplikację. 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.

1. Aby rozpocząć tworzenie agenta za pomocą zestawu SDK agentów, wybierz pozycję Agent z niestandardowym aparatem:

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.

Dostępne są dwa szablony do wyboru:

• Podstawowy agent z niestandardowym aparatem
• Agent pogody.

Podstawowy agent silnika niestandardowego to agent bez żadnych wstępnie utworzonych elementów. Aby agent był przydatny, musisz dodać orkiestrator sztucznej inteligencji, taki jak Semantic Kernel lub LangChain, oraz swoją wiedzę.

1. W tym przykładzie wybierz pozycję Agent Pogodowy, aby utworzyć agenta używającego pakietu LangChain i Azure AI Foundry w zależności od wybranego języka.

Zostanie wyświetlony monit o wybranie usługi LLM.

1. Wybierz pozycję Azure OpenAI dla modelu.

   

   Zostaniesz poproszony o podanie Key, Target URI i Name swojego modelu Azure OpenAI z portalu Microsoft Foundry. Te informacje można znaleźć w obszarze Moje zasoby i modele i punkty końcowe w portalu Foundry.

2. Wprowadź szczegóły modelu, zaczynając od klucza usługi Azure OpenAI.

   

3. 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ę.

   

4. 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 postępujesz zgodnie z przewodnikiem i użyjesz wstępnie utworzonego szablonu z LangChain i Azure AI Foundry, możesz zapytać, "Jaka będzie pogoda w {twojej lokalizacji} jutro?" Agent odpowie, przekazując kartę adaptacyjną z prognozą pogody, korzystając z wybranej przez Ciebie usługi sztucznej inteligencji.

   

   

Debuguj i testuj swojego agenta w Microsoft Copilot

Po zakończeniu testów lokalnie w Agents Playground możesz wdrożyć Azure Bot Service i skonfigurować kanał Microsoft Copilot. Upewnij się, że logujesz się do dzierżawy, która ma dostęp do rozwiązania Microsoft Copilot.

1. Zmień cel debugowania na Copilot, żeby móc debugować za pomocą Microsoft Copilot. Wybierz klawisz F5 na klawiaturze lub Debuguj , aby przetestować. Przygotowanie agenta do platformy Microsoft 365 może potrwać kilka minut. W tle zestaw narzędzi tworzy rejestrację aplikacji i rekord Azure Bot Service w usłudze Azure Bot Service oraz wdraża projekt w dzierżawcy wraz z manifestem.

   

2. Po wdrożeniu projektu powinieneś zobaczyć, że Microsoft Copilot się ładuje, móc zadawać pytania, dodawać punkty przerwania i debugować, w razie potrzeby, bezpośrednio 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 do debugowania bezpośrednio w kanale platformy Microsoft 365