Server pro simulované nástroje

Agent 365 CLI obsahuje simulační server nástrojů určený pro testování a vývoj. Tento server simuluje interakce MCP (Model Context Protocol) serveru, takže můžete lokálně testovat nástrojové schopnosti svého agenta bez potřeby reálných serverových implementací. Nepokrývá žádné další funkce Agent 365.

Výhody používání simulovaného serveru

Simulovaný server nabízí následující výhody pro lokální vývoj a testování:

Offline vývoj: Otestujte svého agenta bez připojení k internetu nebo externích závislostí.
Konzistentní testování: Získáte předvídatelné odpovědi při testování hraničních případů.
Ladění: Zobrazování všech požadavků a odpovědí v reálném čase
Rychlá iterace: nemusíte čekat na volání na externí API ani nastavovat složitá testovací prostředí.

Předpoklady

Před použitím serveru pro simulované nástroje se ujistěte, že máte následující předpoklady:

Nainstalované Agent 365 CLI – Použijte server simulovaných nástrojů spolu s CLI. Viz Agent 365 CLI pro pokyny k instalaci.
- Je třeba mít alespoň verzi 1.1.25-preview, abyste mohli používat server pro simulované nástroje.
Ukázkový projekt agenta – lokální projekt agenta, který se může připojit k MCP serverům. Podívejte se na náš repozitář Agent365-Samples pro dostupné výchozí projekty.

Spuštění simulovaného serveru nástrojů

Použijte příkaz a365 develop start-mock-tooling-server ke spuštění simulovaného serveru nástrojů.

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

# Short alias
a365 develop mts

Možnosti příkazů

Simulovaný server nástrojů podporuje následující možnosti:

Možnost	Popis	Výchozí
`-p, --port <port>`	Číslo portu pro testovací server	5309
`-v, --verbose`	Povolení podrobného protokolování	nepravda
`-?, -h, --help`	Zobrazit nápovědu a informace o používání	-
`-bg`	Spustit server v novém terminálu	-

Příklady

Následující příklady ukazují běžné způsoby, jak spustit testovací nástrojový server:

Začněte s výchozími nastaveními:

a365 develop start-mock-tooling-server

Spusťte na vlastním portu:

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

Začněte s podrobným zaznamenáváním:

a365 develop start-mock-tooling-server -v

Když spustíte příkaz, tak:

Spustí simulovaný server na určeném portu (výchozí: localhost:5309).
Zobrazuje serverové logy a příchozí požadavky v terminálu.

Použití simulovaného serveru s ukázkovými agenty

Pro připojení vašeho vzorkového agenta k serveru simulovaných nástrojů:

Krok 1: Spuštění simulovaného serveru

a365 develop start-mock-tooling-server

Server se spustí a zobrazí výstup podobný následujícímu příkladu:

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: Konfigurace agenta

Nastavte proměnnou prostředí MCP_PLATFORM_ENDPOINT ve vašem ukázkovém agentovi tak, aby směřovala na testovací server:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Pokud používáte vlastní port, nahraďte 5309 číslem portu, který jste si zvolili.

Krok 3: Spuštění agenta

Začněte s ukázkovým agentem jako obvykle. Agent se nyní připojuje k simulovanému serveru místo skutečných MCP serverů.

Krok 4: Sledování aktivity serveru

Terminál simulovaného serveru zobrazuje:

Příchozí požadavky od vašeho agenta
Simulované odpovědi posílané zpět
Stav připojení a případné chyby

Příklady protokolů serveru:

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

Zastavení simulovaného serveru

Pro zastavení simulovaného serveru použijte Ctrl+C v terminálu, kde server běží, nebo zavřete okno terminálu.

Řešení problému

Tato sekce obsahuje informace o tom, jak řešit běžné problémy se serverem simulovaných nástrojů.

Zpropitné

Průvodce odstraňováním problémů Agent 365 obsahuje doporučení k odstraňování problémů na vysoké úrovni, osvědčené postupy a odkazy na obsah o řešení problémů pro každou část životního cyklu vývoje Agent 365.

Simulovaný server se nespustí

Symptom:Error: Address already in use

Příčina: Jiný proces už používá výchozí port (5309) nebo vámi zadaný port.

Řešení:

Použijte jiný port.

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

Nebo ukončete proces, který používá port, a zkuste to znovu.

Agent se nemůže připojit k simulovanému serveru

Symptom: Logy agenta obsahují chyby připojení nebo časové limity při pokusu o připojení k simulovanému serveru.

Příčina:

Simulovaný server není spuštěný.
Nesprávná proměnná prostředí MCP_PLATFORM_ENDPOINT.
Problémy s konfigurací firewallu nebo sítě.