Simulerad verktygsserver

Agent 365 CLI har en simulerad verktygsserver för test- och utvecklingsändamål. Denna server simulerar MCP (Model Context Protocol)-serverinteraktioner, så att du kan testa din agents verktygsfunktionalitet lokalt utan krav på faktiska serverimplementeringar. Den omfattar inga andra Agent 365-funktioner.

Fördelar med att använda den simulerade servern

Den simulerade servern erbjuder följande fördelar för lokal utveckling och testning:

Offlineutveckling: Testa din agent utan internetanslutning eller externa beroenden.
Konsekvent testning: Få förutsägbara svar för att testa gränsfall.
Felsökning: Visa alla förfrågningar och svar i realtid
Snabb iteration: Du behöver inte vänta på externa API-anrop eller konfigurera komplexa testmiljöer.

Krav

Innan du använder den simulerade verktygsservern, säkerställ att följande krav är uppfyllda:

Agent 365 CLI installerad – Använd den simulerade verktygsservern tillsammans med CLI:n. Se Agent 365 CLI för installationsinstruktioner.
- Du bör ha minst förhandsversion 1.1.25 för att använda den simulerade verktygsservern.
Exempel på agentprojekt – Ett lokalt agentprojekt som kan ansluta till MCP-servrar. Se vår lagringsplats för Agent365-exempel för tillgängliga startpunkter.

Starta den simulerade verktygsservern

Använd kommandot a365 develop start-den simulerade tooling-server för att starta den simulerade verktygsservern.

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

# Short alias
a365 develop mts

Kommandoalternativ

Den simulerade verktygsservern stöder följande alternativ:

Alternativ	Beskrivning	Standard
`-p, --port <port>`	Portnummer för den simulerade servern	5309
`-v, --verbose`	Aktivera utförlig loggning	falskt
`-?, -h, --help`	Visa hjälp och användningsinformation	-
`-bg`	Kör servern på en ny terminal	-

Exempel

Följande exempel visar vanliga sätt att starta den simulerade verktygsservern:

Starta med standardinställningar:

a365 develop start-mock-tooling-server

Starta på en anpassad port:

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

Starta med utförlig loggning:

a365 develop start-mock-tooling-server -v

När du kör kommandot, så:

Startar den simulerade servern på den angivna porten (standard: localhost:5309).
Visar serverloggar och inkommande förfrågningar i terminalen.

Använd simulerad server med exempelagenter

För att ansluta din exempelagent till den simulerade verktygsservern:

Steg 1: Starta den virtuella servern

a365 develop start-mock-tooling-server

Servern startar och visar utdata liknande följande exempel:

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

Steg 2: Konfigurera din agent

Ställ in miljövariabeln MCP_PLATFORM_ENDPOINT i din exempelagent så att den pekar på den virtuella servern:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Om du använder en anpassad port, ersätt då 5309 med ditt valda portnummer.

Steg 3: Kör din agent

Starta din exempelagent som du brukar. Agenten ansluter nu till den virtuella servern istället för riktiga MCP-servrar.

Steg 4: Övervaka serveraktivitet

Den virtuella serverns terminal visar:

Inkommande förfrågningar från din agent
Simulerade svar som skickas tillbaka
Anslutningsstatus och eventuella fel

Exempel på serverloggar:

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

Stoppa den simulerade servern

För att avsluta den simulerade servern använder du Ctrl+C i den terminal där servern körs, eller stänger ner terminalfönstret.

Felsökning

Detta avsnitt innehåller information om hur du felsöker vanliga problem med den simulerade verktygsservern.

Dricks

Agent 365-felsökningsguide innehåller övergripande felsökningsrekommendationer, bästa praxis och länkar till felsökningsinnehåll för varje enskild del av Agent 365:s utvecklingslivscykel.

Den simulerade servern startar inte

Symtom:Error: Address already in use

Orsak: En annan process använder redan standardporten (5309) eller din angivna port.

Lösning:

Använd en annan port.

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

Eller stoppa processen med porten och försöka igen.

Agenten kan inte ansluta till den simulerade servern

Symtom: Agentloggar uppvisar anslutningsfel eller timeouts när agenten försöker nå den simulerade servern.

Orsak:

Den simulerade servern körs inte.
Felaktig MCP_PLATFORM_ENDPOINT-miljövariabel.
Brandväggs- eller nätverkskonfigurationsproblem.