Testaus ja vianetsintä
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.
| Oire | Johtolanka |
|---|---|
| Työkaluja ei listata | Onko palvelin käynnissä? Pättyykö osoite merkkeihin /mcp? |
| Jäsennelty data, mutta ei komponenttia | Sisältääkö työkalu kohdan _meta.ui.resourceUri, joka viittaa rekisteröityyn resurssiin tyyppiä text/html;profile=mcp-app ja latautuu ilman CSP-virheitä? |
| Skeemavirheet | Vastaavatko Python- tai TypeScript-mallisi ilmoitettua outputSchema:a? |
| Hidas komponentti | Ylittävätkö työkalukutsut muutaman sadan millisekunnin rajan? Profiloi ja käytä välimuistia. |
| Komponentti ei lataudu | Selaimen 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 mobiilissa | Lue window.openai.displayMode ja window.openai.maxHeight; vältä kiinteitä korkeuksia ja hover-toimintoja. |
| Työkalua ei valita koskaan | Kirjoita kuvaus uudelleen muotoon “Käytä, kun…”, tarkista aloituskehotteet. |
| Väärä työkalu valittu | Selkeytä viereisiä työkaluja, määritä pois suljetut tapaukset, pilko liian laajoja työkaluja. |
| 401-virheet | Sisä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 vanhentuu | Käynnistä se uudelleen, varmista paikallisen palvelimen olevan käynnissä; tuotannossa käytä vakaita hosting-palveluita health probe -tarkistuksilla. |
| Streamaus rikki välityspalvelimen takana | Kuormantasaimen 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