Mock tooling-server

De Agent 365 CLI bevat een mock toolingserver voor test- en ontwikkelingsdoeleinden. Deze server simuleert MCP (Model Context Protocol) serverinteracties, zodat u de toolingmogelijkheden van uw agent lokaal kunt testen, zonder dat u daadwerkelijk serverimplementaties nodig hebt. Het omvat geen andere Agent 365-functionaliteiten.

Voordelen van het gebruik van de mockserver

De mockserver biedt de volgende voordelen voor lokale ontwikkeling en testen:

Offline ontwikkeling: test uw agent zonder internetverbinding of externe afhankelijkheden.
Consistent testen: ontvang voorspelbare respons voor het testen van randgevallen.
Foutopsporing: bekijk alle verzoeken en respons in realtime
Snelle iteratie: geen wachten op externe API-aanroepen of het opzetten van complexe testomgevingen.

Vereisten

Voordat de mock toolingserver wordt gebruikt, dient aan de volgende vereisten te worden voldaan:

Agent 365 CLI geïnstalleerd - Gebruik de mock toolingserver naast de CLI. Zie Agent 365 CLI voor installatie-instructies.
- Voor het gebruik van de mock toolingserver is minimaal versie 1.1.25-preview vereist.
Voorbeeld agentproject - Een lokaal agentproject dat verbinding kan maken met MCP-servers. Zie onze Agent365-samples-opslagplaats voor mogelijke startpunten.

Mock toolingserver starten

Gebruik de opdracht a365 develop start-mock-tooling-server om de mock toolingserver te starten.

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

# Short alias
a365 develop mts

Opdrachtopties

Mock toolingserver ondersteunt de volgende opties:

Optie	Beschrijving	Standaard
`-p, --port <port>`	Poortnummer van de mock toolingserver	5309
`-v, --verbose`	Uitgebreide logboekregistratie inschakelen	onwaar
`-?, -h, --help`	Toon hulp en gebruiksinformatie	-
`-bg`	Start de server in een nieuwe terminal	-

Voorbeelden

De volgende voorbeelden tonen veelvoorkomende manieren om de mock toolingserver te starten:

Start met de standaardinstellingen:

a365 develop start-mock-tooling-server

Start op een aangepaste poort:

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

Start met uitgebreide logboekregistratie:

a365 develop start-mock-tooling-server -v

Wanneer u de opdracht uitvoert, gebeurt het volgende:

Start de mock toolingserver op de opgegeven poort (standaard: localhost:5309).
Toont serverlogboeken en inkomende verzoeken in de terminal.

Gebruik een mockserver met voorbeeldagenten

Om uw voorbeeldagent met de mock toolingserver te verbinden:

Stap 1: Start de mockserver

a365 develop start-mock-tooling-server

De server wordt gestart en toont uitvoer vergelijkbaar met het volgende voorbeeld:

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

Stap 2: Uw agent configureren

Stel de omgevingsvariabele MCP_PLATFORM_ENDPOINT in uw voorbeeldagent in, zodat deze naar de mockserver verwijst:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Als u een aangepaste poort gebruikt, vervangt u 5309 door het gekozen poortnummer.

Stap 3: Start uw agent

Start uw voorbeeldagent zoals u gewoonlijk doet. De agent maakt nu verbinding met de mockserver in plaats van met de echte MCP-servers.

Stap 4: Monitor serveractiviteit

De mockserverterminal toont het volgende:

Binnenkomende verzoeken van uw agent
Gesimuleerde responsen die teruggestuurd worden
Verbindingsstatus en fouten (indien aanwezig)

Voorbeeld van serverlogboeken:

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

De mockserver stoppen

Om de mockserver te stoppen, druk op Ctrl+C in de terminal waar de server draait, of sluit het terminalvenster.

Probleemoplossing

Deze sectie bevat informatie over het oplossen van veelvoorkomende problemen met de mock toolingserver.

Fooi

De Gids voor probleemoplossing in Agent 365 bevat aanbevelingen voor probleemoplossing op hoog niveau, best practices en links naar relevante probleemoplossingsinformatie voor elk onderdeel van de Agent 365-ontwikkelingscyclus.

Mockserver kan niet worden gestart

Symptoom:Error: Address already in use

Oorzaak: een ander proces gebruikt de standaardpoort (5309) al of de door u opgegeven poort.

Oplossing:

Gebruik een andere poort.

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

Of beëindig het proces dat op de poort draait en probeer het opnieuw.

Agent kan geen verbinding maken met de mockserver

Symptoom: agentlogboeken tonen verbindingsfouten of time-outs wanneer ze proberen de mockserver te bereiken.

Oorzaak:

De mockserver draait niet.
Onjuiste MCP_PLATFORM_ENDPOINT-omgevingsvariabele.
Firewall of netwerkconfiguratieproblemen.