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

Szczegółowe informacje na temat lokalnego testowania agenta zależą od tego, jak został utworzony agent.

Możesz stworzyć agenta, korzystając z SDK Microsoft 365 Agents, na trzy sposoby:

• Rozpocznij projekt z Microsoft 365 Agents Toolkit w C#, JavaScript lub Pythonie za pomocą Visual Studio lub Visual Studio Code
• Sklonuj przykładowy projekt i otwórz go w swoim IDE
• Używanie CLI

Rozpocznij projekt od zestawu narzędzi

Jeśli zaczniesz od tego zestawu narzędzi agentów, wszystko będzie gotowe do przeprowadzania testów w środowisku testowym agentów od razu. Możesz przetestować w środowisku testowym agentów lokalnie lub w Microsoft 365 Copilot bądź Microsoft Teams. Ten scenariusz został omówiony w:

• Rozszerzenie Visual Studio Code
• Rozszerzenie Visual Studio

Zacznij projekt od klonowania lub z pomocą CLI

Jeśli uruchomisz projekt przy użyciu interfejsu wiersza polecenia lub sklonujesz przykład i otworzysz przykład w środowisku IDE, możesz przetestować lokalne środowisko testowe agentów. Środowisko testowe agentów łączy się z lokalnym kodem.

Agentów środowiska testowego można zainstalować przy użyciu jednej z następujących metod:

Opcja 1: Zainstaluj samodzielny plik wykonywalny

winget install agentsplayground

curl -s https://raw.githubusercontent.com/OfficeDev/microsoft-365-agents-toolkit/dev/.github/scripts/install-agentsplayground-linux.sh | bash

Opcja 2: Instalacja przy użyciu npm

• Zainstaluj Node.js (jeśli nie został jeszcze zainstalowany): Pobierz i zainstaluj najnowszą wersję Node.js ze strony nodejs.org.

• Zainstaluj pakiet Agents Playground:

  Instalacja globalna (zalecane):

  npm install -g @microsoft/m365agentsplayground
  

  Instalacja lokalna dla projektu:

  npm install -D @microsoft/m365agentsplayground
  

Testowanie własnego agenta

1. Po utworzeniu agenta szybkiego startu lub sklonowaniu przykładu z repozytorium, możesz użyć go z symulatorem agentów.

2. Agents Playground obsługuje zarówno tryb anonimowy, jak i uwierzytelniony. W przypadku testów anonimowych nie jest wymagana żadna dodatkowa konfiguracja. Jeśli chcesz przeprowadzić testy z uwierzytelnianiem, musisz skonfigurować rejestracje aplikacji Microsoft Entra ID zarówno dla Agents Playground (opcje opisano poniżej), jak i dla swojej aplikacji. Aby uzyskać informacje, zobacz Inicjowanie usługi bota platformy Azure do użycia z zestawem SDK agentów.

3. Należy poprawnie skonfigurować porty w aplikacji. Wybierz dostępny port dla swojego agenta (domyślnie 3978, ale możesz użyć dowolnego dostępnego portu).

4. Uruchom kod.

5. Otwórz środowisko testowe agentów i zacznij od punktu końcowego agenta:

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator"
   

   Należy skonfigurować uwierzytelnianie, jeśli wymaga tego agent:

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator" --client-id "your-client-id" --client-secret "your-client-secret" --tenant-id "your-tenant-id"
   

   Kluczowe opcje:

   • -e, --app-endpoint: URL endpointu twojego agenta (na przykład, http://localhost:3978/api/messages)
   • -c, --channel-id: Typ kanału (na przykład emulator, webchat, msteams). Każdy kanał zapewnia inne środowisko użytkownika i właściwości aktywności.
   • --client-id: ID klienta do uwierzytelniania
   • --client-secret: Sekret klienta do uwierzytelniania
   • --tenant-id: ID dzierżawcy do uwierzytelniania

   Aby zobaczyć pełną listę dostępnych opcji, użyj agentsplayground --help.

   Alternatywnie możesz użyć zmiennych środowiskowych zamiast opcji CLI. Jeśli oba są określone, opcja CLI ma wyższy priorytet.

   export BOT_ENDPOINT="http://localhost:<your-agent-port>/api/messages"
   export DEFAULT_CHANNEL_ID="emulator"
   export AUTH_CLIENT_ID="your-client-id"
   export AUTH_CLIENT_SECRET="your-client-secret"
   export AUTH_TENANT_ID="your-tenant-id"
   

   Po uruchomieniu agenta powinien się otworzyć, jak pokazano na poniższej ilustracji. Możesz zadawać pytania i testować swojego agenta w środowisku Playground.

   

W miarę możliwości zalecamy rozpoczęcie pracy z zestawem narzędzi Microsoft 365 Agents. Rozpoczęcie, lokalne testowanie i wdrażanie są łatwiejsze i szybsze. Ułatwia ręczną konfigurację Azure Bot Service i rejestracji aplikacji platformy Azure, eliminując konieczność samodzielnego ich wykonywania. Jeśli rozpoczniesz ręcznie, musisz samodzielnie wykonać te czynności.

Sumaryczny

Przetestowano lokalnie Zestaw SDK agentów usługi Microsoft 365, korzystając ze środowiska testowego Microsoft 365 agentów, zaczynając od sklonowanego przykładu z repozytorium GitHub lub za pomocą interfejsu wiersza polecenia (CLI).