Simulert verktøyserver

Agent 365 CLI omfatter en simulert verktøyserver til testing og utvikling. Denne serveren simulerer MCP-serversamhandlinger (Model Context Protocol), slik at du kan teste agentens verktøyfunksjoner lokalt uten behov for faktiske serverimplementeringer. Den dekker ingen andre Agent 365-funksjoner.

Fordeler med å bruke den simulerte serveren

Den simulerte serveren byr på følgende fordeler for lokal utvikling og testing:

Frakoblet utvikling: Test agenten uten Internett-tilkobling eller eksterne avhengigheter.
Konsekvent testing: Motta forutsigbare svar for testing av kanttilfeller.
Feilsøking: Vis alle forespørsler og svar i sanntid
Rask gjentakelse: Du trenger ikke å vente på eksterne API-oppkall eller konfigurere kompliserte testmiljøer.

Forutsetning

Før du bruker den simulerte verktøyserveren, må du sørge for at du har oppfylt følgende forutsetninger:

Agent 365 CLI installert – Bruk den simulerte verktøyserveren sammen med CLI. Se Agent 365 CLI hvis du vil ha installasjonsinstruksjoner.
- Du må ha minst versjon 1.1.25-preview for å kunne bruke den simulerte verktøyserveren.
Eksempelagentprosjekt - Et lokalt agentprosjekt som kan koble til MCP-servere. Se repositoriet Agent365-Samples for å få tilgjengelige utgangspunkter.

Start den simulerte verktøyserveren

Bruk kommandoen a365 develop start-mock-tooling-server til å starte den simulerte verktøyserveren.

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

# Short alias
a365 develop mts

Kommandoalternativer

Den simulerte verktøyserveren støtter følgende alternativer:

Alternativ	Beskrivelse	Standard
`-p, --port <port>`	Portnummer for den simulerte serveren	5309
`-v, --verbose`	Aktiver detaljert logging	usann
`-?, -h, --help`	Vis hjelp og bruksinformasjon	-
`-bg`	Kjør serveren i en ny terminal	-

Eksempler

Følgende eksempler viser vanlige måter å starte den simulerte verktøyserveren på:

Start med standardinnstillingene:

a365 develop start-mock-tooling-server

Start på en egendefinert port:

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

Start med detaljert logging:

a365 develop start-mock-tooling-server -v

Når du kjører kommandoen, gjør den følgende:

Starter den simulerte serveren på den spesifiserte porten (standard: localhost:5309).
Viser serverlogger og innkommende forespørsler i terminalen.

Bruk den simulerte serveren sammen med eksempelagentene

Slik kobler du eksempelagenten til den simulerte verktøyserveren:

Trinn 1: Start den simulerte serveren

a365 develop start-mock-tooling-server

Serveren starter og viser utdata tilsvarende følgende eksempel:

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

Trinn 2: Konfigurer agenten

Sett miljøvariabelen MCP_PLATFORM_ENDPOINT i eksempelagenten din slik at den peker mot den simulerte serveren:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Hvis du bruker en egendefinert port, bytter du 5309 med ditt valgte portnummer.

Trinn 3: Kjør agenten din

Start eksempelagenten som vanlig. Agenten kobler nå til den simulerte serveren i stedet for faktiske MCP-servere.

Trinn 4: Overvåk serveraktivitet

Følgende vises i terminalen for den simulerte serveren:

Innkommende forespørsler fra agenten din
Simulerte svar som sendes tilbake
Tilkoblingsstatus og -feil (hvis noen)

Eksempler på serverlogger:

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

Stopp av den simulerte serveren

Du kan stoppe den simulerte serveren ved å trykke på Ctrl+C i terminalen der serveren kjører, eller ved å lukke terminalvinduet.

Feilsøking

I denne delen finner du informasjon om hvordan du feilsøker vanlige problemer med den simulerte verktøyserveren.

Tips

Feilsøkingsveiledning for Agent 365 inneholder anbefalinger på høyt nivå for feilsøking, anbefalte fremgangsmåter og koblinger til feilsøkingsinnhold for hver fase i utviklingssyklusen i Agent 365.

Den simulerte serveren starter ikke

Symptom:Error: Address already in use

Årsak: En annen prosess bruker allerede standardporten (5309) eller den angitte porten.

Løsning:

Bruk en annen port.

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

Eller stopp prosessen som bruker porten, og prøv på nytt.

Agenten kan ikke koble til den simulerte serveren

Symptom: Agentlogger viser tilkoblingsfeil eller tidsavbrudd ved forsøk på å nå den simulerte serveren.

Årsak:

Den simulerte serveren kjører ikke.
Miljøvariabelen MCP_PLATFORM_ENDPOINT er feil.
Problemer med brannmur eller nettverkskonfigurasjon.