Serwer symulujący oprzyrządowanie

CLI Agenta 365 zawiera serwer narzędzi mock do testowania i rozwoju. Ten serwer symuluje interakcje z serwerem MCP (Protokół kontekstu modelu), dzięki czemu możesz testować możliwości narzędzi agenta lokalnie bez konieczności faktycznych implementacji serwera. Nie obejmuje żadnych innych funkcji Agenta 365.

Zalety korzystania z serwera mockowego

Serwer mockowy oferuje następujące korzyści dla lokalnego rozwoju i testowania:

Rozwój offline: Przetestuj swojego agenta bez połączenia z internetem i bez zewnętrznych zależności.
Spójne testowanie: Otrzymuj przewidywalne odpowiedzi do testowania przypadków brzegowych.
Debugowanie: Przeglądaj wszystkie żądania i odpowiedzi w czasie rzeczywistym
Szybka iteracja: Brak konieczności oczekiwania na zewnętrzne wywołania API czy tworzenia skomplikowanych środowisk testowych.

Wymagania wstępne

Przed użyciem mock tooling servera upewnij się, że spełniasz następujące warunki wstępne:

Zainstalowano Agent 365 CLI — Należy korzystać z serwera testowego narzędzi wraz z interfejsem CLI. Zobacz Agent 365 CLI w celu zapoznania się z instrukcjami instalacji.
- Aby korzystać z serwera mock tooling, powinieneś mieć zainstalowaną co najmniej wersję 1.1.25-preview (wersja zapoznawcza).
Przykładowy projekt agenta – lokalny projekt agenta, który może łączyć się z serwerami MCP. Zobacz nasze repozytorium Agent365-Samples jako dostępne punkty startowe.

Uruchom serwer mock tooling

Użyj polecenia a365 develop start-mock-tooling-server, aby uruchomić serwer mock tooling.

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

Opcje poleceń

Serwer mock tooling obsługuje następujące opcje:

Opcja	Podpis	Wartość domyślna
`-p, --port <port>`	Numer portu dla serwera mock	5309
`-v, --verbose`	Włączenie pełnego rejestrowania	fałsz
`-?, -h, --help`	Wyświetl pomoc i informacje o użyciu	-
`-bg`	Uruchom serwer w nowym terminalu	-

Przykłady

Poniższe przykłady pokazują typowe sposoby uruchamiania serwera narzędziowego mock:

Uruchom z ustawieniami domyślnymi:

a365 develop start-mock-tooling-server

Uruchom na niestandardowym porcie.

a365 develop start-mock-tooling-server -p 8080

Uruchom z logowaniem szczegółowym:

a365 develop start-mock-tooling-server -v

Po uruchomieniu polecenia:

Uruchamia serwer typu mock na określonym porcie (domyślnie: localhost:5309).
Wyświetla logi serwera i przychodzące żądania w terminalu.

Użyj serwera mock z agentami próbkami

Aby połączyć swojego agenta próbnego z serwerem narzędzi mock:

Krok 1: Uruchom serwer testowy

a365 develop start-mock-tooling-server

Serwer się uruchamia i wyświetla dane wyjściowe podobne do poniższego przykładu:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

Krok 2. Konfigurowanie agenta

Ustaw zmienną środowiskową MCP_PLATFORM_ENDPOINT w swoim agencie przykładowym, aby wskazywała na serwer mockowy:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Jeśli używasz niestandardowego portu, zamień 5309 na wybrany numer portu.

Krok 3: Uruchom swojego agenta

Uruchom swojego agenta przykładowego jak zwykle. Agent łączy się teraz z serwerem testowym zamiast z rzeczywistymi serwerami MCP.

Krok 4: monitoruj aktywność serwera

Terminal serwera testowego wyświetla:

Nadchodzące żądania od Twojego agenta
Odesłane symulowane odpowiedzi
Status połączenia i błędy (jeśli występują)

Przykładowe logi serwera:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

Zatrzymanie serwera typu mock

Aby zatrzymać serwer typu mock, użyj Ctrl+C w terminalu, w którym uruchomiono serwer, lub zamknij okno terminala.

Rozwiązywanie problemów

Ta sekcja zawiera informacje o tym, jak rozwiązywać typowe problemy z serwerem mock tooling.

Wskazówka

Przewodnik po rozwiązywaniu problemów Agent 365 zawiera wysokopoziomowe zalecenia dotyczące rozwiązywania problemów, najlepsze praktyki oraz odnośniki do treści dotyczących rozwiązywania problemów dla każdego etapu cyklu rozwoju Agent 365.

Serwer typu mock nie uruchamia się

Objaw:Error: Address already in use

Przyczyna: Inny proces już korzysta z domyślnego portu (5309) lub określonego portu.

Rozwiązanie:

Użyj innego portu.

a365 develop start-mock-tooling-server -p 8080

Lub zakończ proces, który korzysta z portu i spróbuj ponownie.

Agent nie może połączyć się z serwerem mock

Objaw: Logi agenta pokazują błędy połączenia lub przekroczenia czasu podczas próby połączenia z serwerem mock.

Przyczyna:

Serwer mock nie jest uruchomiony.
Nieprawidłowa zmienna środowiskowa MCP_PLATFORM_ENDPOINT.
Problemy z konfiguracją zapory sieciowej lub sieci.