Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Testaus ja vianetsintä

Oppitunti 9 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Testaa kerroksittain
  2. MCP-palvelin
  3. Koko lisäosa
  4. Vianetsintä kerroksittain
  5. Keskeiset asiat

Oppitunti kirjoitettu uudelleen 3. marraskuuta 2026 perustuen OpenAI:n lisäosadokumentaation sivuihin Connect and test your plugin ja Troubleshooting. Kurssin ensimmäisen version kuvitteelliseen SDK:hun kuulunut entinen “kehityshiekkalaatikko” ja sen komennot on poistettu. Lähteet: Connect and test · Troubleshooting.

Testaa kerroksittain

OpenAI suosittelee jokaisen toiminnon testaamista ennen koko asennetun lisäosan käyttöönottoa: ensin erillisen MCP-palvelimen yhdistäminen ChatGPT:hen, sitten pakatun lisäosan ja sen taitojen testaaminen. Säilytä arviointikehotteesi ja niiden tulokset koko kehitysprosessin ajan, jotta voit verrata käyttäytymistä eri versioiden välillä.

MCP-palvelin

Valmistele päätepiste

Ennen testaamista ChatGPT:ssä varmista, että palvelin on tavoitettavissa julkisen HTTPS:n kautta – tai Secure MCP Tunnel -yhteyden välityksellä – että se puhuu streamable HTTP:tä (tyypillisesti polussa /mcp), että työkalujen nimet, kuvaukset, skeemat ja annotaatiot ovat paikallaan, ja että tunnistautumisen havaitseminen toimii tilejä vaativille työkaluille. Kehitystunneli käy kokeiluihin, mutta ei julkaisua varten.

Tarkista

MCP Inspector kutsuu työkalujasi suoraan ilman mallia:

npx @modelcontextprotocol/inspector@latest

Käy jokainen työkalu läpi perusteellisesti: edustavat syötteet, reunatapaukset, puuttuvat tunnistetiedot ja tyhjät tulokset. Tarkista skeeman validointi, tunnistautumisvirheet, annotaatiot, vahvistuskäyttäytyminen ja mallin luettava tuloste.

Arvioi työkalujen valintaa

Kun palvelin on yhdistetty henkilökohtaisena lisäosana (oppitunti 4), asenna se, avaa uusi keskustelu, kirjoita @ ja valitse se. Rakenna arviointisarja, joka sisältää:

  • Suoria pyyntöjä, joiden pitäisi käynnistää tietty työkalu;
  • Epäsuoria pyyntöjä, jotka ilmaisevat saman tavoitteen eri tavoin;
  • Seurantapyyntöjä, jotka käyttävät uudelleen aiemmin saatuja tunnisteita;
  • Kirjoitustoimintoja, jotka vaativat valtuutusta tai vahvistusta;
  • Toimialan ulkopuolisia pyyntöjä, joiden ei pitäisi käynnistää yhtään työkalua.

Kirjaa jokaiselle tapaukselle valittu työkalu, sen argumentit, tulos, mahdolliset virheet ja vahvistuskäyttäytyminen. Toista koko sarja aina, kun muutat nimeä, kuvausta, skeemaa tai annotaatiota. Jos palvelin palauttaa UI-komponentin, testaa sekä itse komponenttia että mallin luettavaa tulosta.

Tarkastele raakavaihtoa

Lukeaksesi täydelliset pyynnöt ja vastaukset API Playground hyväksyy MCP-palvelimen: siirry kohtaan Tools → Add → MCP Server, syötä HTTPS-osoite, yhdistä ja suorita testikehotteesi.

Päivitä metadata

Jokaisen nimen, kuvauksen, skeeman, annotaation, tunnistautumismenetelmän tai UI-resurssin muutoksen jälkeen: ota palvelin uudelleen käyttöön tai käynnistä se uudelleen, avaa yhteys osoitteessa chatgpt.com/plugins, valitse Refresh, varmista, että ilmoitettu metadata on muuttunut, ja toista asiaankuuluvat testit uudessa keskustelussa. Tämä päivitys koskee suoraan yhdistettyjä palvelimia; julkaistun lisäosan työkalupäivitykset kuuluvat jatkuvan tarkastelun piiriin (oppitunti 11).

Ennen pakkaamista varmista, että työkalulista vastaa ilmoitettuja ominaisuuksia, että jäsennellyt tulokset noudattavat tulosteskeemoja, että tunnistautumisvirheet palauttavat hyödyllisiä virheilmoituksia, että oikeat kehotteet käynnistävät oikeat työkalut väärien käynnistämättä mitään, ja että käyttöliittymä renderöityy ilman konsolivirheitä palauttaen tilansa oikein.

Koko lisäosa

Kun palvelin on valmis – tai välittömästi, jos lisäosa koostuu vain taidoista – pakkaa lisäosa (oppitunti 10), lisää se paikalliselle markkinapaikalle, asenna se lisäosahakemistosta ja toista sitten käyttötapausluettelosi pyynnöt: suorat, epäsuorat, seurantapyynnöt, negatiiviset testit ja tarkoituksellisesti pois rajatut reunatapaukset. Varmista, että lisäosa noudattaa taitojen ohjeita, käyttää oikeita resursseja, suorittaa jokaisen vaiheen ja tuottaa hyödyllisen tuloksen; että taidot kutsuvat oikeita työkaluja; ja että tunnistautuminen toimii asennuksen jälkeen.

Vianetsintä kerroksittain

Kun jotain menee pieleen, aloita eristämällä viallinen kerros: palvelin, komponentti tai ChatGPT-asiakas.

OireJohtolanka
Työkaluja ei listataOnko palvelin käynnissä? Pättyykö osoite merkkeihin /mcp?
Jäsennelty data, mutta ei komponenttiaSisältääkö työkalu kohdan _meta.ui.resourceUri, joka viittaa rekisteröityyn resurssiin tyyppiä text/html;profile=mcp-app ja latautuu ilman CSP-virheitä?
SkeemavirheetVastaavatko Python- tai TypeScript-mallisi ilmoitettua outputSchema:a?
Hidas komponenttiYlittävätkö työkalukutsut muutaman sadan millisekunnin rajan? Profiloi ja käytä välimuistia.
Komponentti ei latauduSelaimen konsoli: CSP-rikkomus, keskeneräinen bundle?
Tila katoaa (vetäminen ja pudottaminen, muokkaus)Kutsu window.openai.setWidgetState jokaisen päivityksen jälkeen ja palauta tila arvosta window.openai.widgetState mount-vaiheessa.
Asettelu rikki mobiilissaLue window.openai.displayMode ja window.openai.maxHeight; vältä kiinteitä korkeuksia ja hover-toimintoja.
Työkalua ei valita koskaanKirjoita kuvaus uudelleen muotoon “Käytä, kun…”, tarkista aloituskehotteet.
Väärä työkalu valittuSelkeytä viereisiä työkaluja, määritä pois suljetut tapaukset, pilko liian laajoja työkaluja.
401-virheetSisällytä WWW-Authenticate vastaukseen; tarkista myöntäjä ja kohdeyleisö.
invalid_client olemassa olevassa yhteydessäOnko rekisteröity OAuth-asiakas vielä olemassa? Palauta se äläkä luo uutta.
ngrok-tunneli vanhentuuKäynnistä se uudelleen, varmista paikallisen palvelimen olevan käynnissä; tuotannossa käytä vakaita hosting-palveluita health probe -tarkistuksilla.
Streamaus rikki välityspalvelimen takanaKuormantasaimen tai CDN:n on läpäistävä HTTP-streamaus puskuroimatta.

Jos ongelma jatkuu, kerää palvelinlokit, komponentin konsolilokit, työkalukutsujen transkriptio ja kuvakaappaukset. Merkitse muistiin käytetty kehote ja lähetä kaikki OpenAI-yhteyshenkilöllesi.

Keskeiset asiat

  • Testaa kerroksittain: ensin palvelin yksinään (Inspector, sitten ChatGPT), sitten koko lisäosa
  • Rakenna arviointisarja: suorat, epäsuorat, seurantapyynnöt, kirjoitus- ja toimialan ulkopuoliset pyynnöt
  • API Playground näyttää raakatason MCP-vaihdot
  • Refresh jokaisen metadatamuutoksen jälkeen, aloita sitten uusi keskustelu
  • Ongelmien ilmetessä eristä ensin kerros: palvelin, komponentti tai asiakas