Valetyökalupalvelin

Agent 365 CLI sisältää valetyökalupalvelimen testaus- ja kehitystarkoituksiin. Tämä palvelin simuloi MCP (Mallin kontekstin protokolla) -palvelinvuorovaikutuksia, joten voit testata agenttisi työkalukykyjä paikallisesti ilman varsinaisia palvelintoteutuksia. Se ei kata muita Agent 365 -toimintoja.

Valepalvelimen käytön hyödyt

Valepalvelin tarjoaa seuraavat edut paikalliseen kehitykseen ja testaukseen:

Offline-kehitys: agentin testaaminen onnistuu ilman internet-yhteyttä tai ulkoisia riippuvuuksia.
Johdonmukainen testaus: Saat ennustettavia vastauksia reunatapausten testaamiseen.
Virheenkorjaus: Tarkastele kaikkia pyyntöjä ja vastauksia reaaliajassa
Nopea iterointi: Ei tarvitse odottaa ulkoisia API-kutsuja tai luoda monimutkaisia testiympäristöjä.

Edellytykset

Ennen valetyökalupalvelimen käyttöä varmista, että seuraavat vaatimukset täyttyvät:

Agent 365 CLI asennettu – Käytä valetyökalupalvelinta yhdessä komentokeskuksen kanssa. Katso asennusohjeet kohdasta Agent 365 CLI.
- Sinulla tulee olla vähintään versio 1.1.25-preview (esiversio), jotta voit käyttää valetyökalupalvelinta.
Esimerkkiagenttiprojekti - Paikallinen agenttiprojekti, joka voi olla yhteydessä MCP-palvelimiin. Katso kohdasta Agent365-Samples-repo saatavilla olevia aloituspisteitä.

Käynnistä valetyökalupalvelin

Käytä a365 develop start-mock-tooling-server -komentoa käynnistääksesi valetyökalupalvelimen.

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

# Short alias
a365 develop mts

Komentoasetukset

Valetyökalupalvelin tukee seuraavia optioita:

Vaihtoehto	Description	Oletus
`-p, --port <port>`	Valepalvelimen porttinumero	5309
`-v, --verbose`	Ota käyttöön yksityiskohtainen lokiin kirjaaminen	false
`-?, -h, --help`	Näytä ohjeet ja käyttöohjeet	-
`-bg`	Käynnistä palvelin uudessa terminaalissa	-

Esimerkkejä

Seuraavat esimerkit osoittavat yleisiä tapoja käynnistää valetyökalupalvelin:

Käynnistä oletusasetuksilla:

a365 develop start-mock-tooling-server

Käynnistä määritetyllä portilla:

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

Käynnistä laajalla lokituksella:

a365 develop start-mock-tooling-server -v

Kun suoritat komennon, se:

Käynnistää valepalvelimen määritetyllä portilla (oletus: localhost:5309).
Näyttää palvelimen lokit ja saapuvat pyynnöt terminaalissa.

Valepalvelimen käyttö esimerkkiagenttien kanssa

Liittääksesi esimerkkiagenttisi valepalvelimeen:

Vaihe 1: Käynnistä valepalvelin

a365 develop start-mock-tooling-server

Palvelin käynnistyy ja näyttää tulosteen, joka muistuttaa seuraavaa esimerkkiä:

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

Vaihe 2: Määritä agenttisi

Aseta malliagentin MCP_PLATFORM_ENDPOINT-ympäristömuuttuja osoittamaan valepalvelimeen:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Jos käytät mukautettua porttia, korvaa 5309 valitsemallasi porttinumerolla.

Vaihe 3: Käynnistä agenttisi

Käynnistä esimerkkiagentti kuten tavallisesti. Agentti yhdistää nyt valepalvelimeen oikeiden MCP-palvelimien sijaan.

Vaihe 4: Seuraa palvelimen toimintaa

Valepalvelimen päätteessä näkyy:

Agenttisi lähettämät saapuvat pyynnöt
Mallinnetut vastaukset lähetetään takaisin
Yhteyden tila ja mahdolliset virheet:

Esimerkki palvelinlokeista:

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

Valepalvelimen pysäyttäminen

Pysäyttääksesi valepalvelimen, käytä komentoa Ctrl+C siinä terminaalissa, jossa palvelin on käynnissä, tai sulje terminaali-ikkuna.

Vianmääritys

Tässä osiossa on ohjeita yleisten ongelmien vianmääritykseen valetyökalupalvelimella.

Vinkki

Agent 365:n vianmääritysopas sisältää yleisluontoisia vianmääritykseen liittyviä suosituksia, parhaita käytäntöjä sekä linkkejä vianmääritykseen liittyvään sisältöön Agent 365:n kehityksen elinkaaren kaikissa vaiheissa.

Valepalvelin ei käynnisty

Oire:Error: Address already in use

Syy: Toinen prosessi käyttää jo oletusporttia (5309) tai määritettyä porttia.

Ratkaisu:

Käytä eri porttia.

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

Tai pysäytä prosessi, joka käyttää porttia, ja yritä uudelleen.

Agentti ei saa yhteyttä valepalvelimeen

Oire: agentin lokit näyttävät yhteysvirheitä tai aikakatkaisuja, kun agentti yrittää yhdistää valepalvelimeen.

Syy:

Valepalvelin ei ole käynnissä.
Väärä MCP_PLATFORM_ENDPOINT ympäristömuuttuja.
Palomuuri- tai verkkokonfiguraatio-ongelmia.