Testavimas ir derinimas
Šiame puslapyje
Pamoka perrašyta 2026 m. lapkričio 3 d. remiantis Connect and test your plugin ir Troubleshooting puslapiais iš OpenAI papildinių dokumentacijos. Buvusi „kūrimo aikštelė“ ir jos komandos priklausė neegzistuojančiam SDK iš pirmosios šio kurso versijos. Šaltiniai: Connect and test · Troubleshooting.
Testuok sluoksniais
OpenAI rekomenduoja prieš diegiant visą įdiegtą papildinį ištestuoti kiekvieną funkciją atskirai: pirmiausia savarankišką MCP serverį, prijungtą prie ChatGPT, o tada supakuotą papildinį su jo įgūdžiais. Vystymo metu saugok savo vertinimo užklausas ir jų rezultatus, kad galėtum lyginti elgseną skirtingose versijose.
MCP serveris
Paruošk galutinį tašką
Prieš testuodamas ChatGPT, įsitikink, kad serveris pasiekiamas per viešą HTTPS – arba per Secure MCP Tunnel – kad jis naudoja streamable HTTP (paprastai adresu /mcp), kad yra pateikti įrankių pavadinimai, aprašymai, schemos ir anotacijos, ir kad autentifikavimo aptikimas veikia įrankiams, kuriems reikia paskyros. Kūrimo tunelis tinka bandymams, bet ne pateikimui.
Inspektuok
MCP Inspector kviečia tavo įrankius tiesiogiai, be modelio:
npx @modelcontextprotocol/inspector@latest
Išbandyk kiekvieną įrankį visomis sąlygomis: tipinės įvestys, kraštiniai atvejai, trūkstami prisijungimo duomenys ir tušti rezultatai. Patikrink schemos validavimą, autentifikavimo klaidas, anotacijas, patvirtinimo elgseną ir modeliui suprantamą išvestį.
Įvertink įrankių pasirinkimą
Kai serveris prijungtas kaip asmeninis papildinys (4 pamoka), įdiek jį, atverk naują pokalbį, įvesk @ ir pasirink jį. Sudaryk vertinimų rinkinį, kuriame būtų:
- Tiesioginės užklausos, kurios turėtų suaktyvinti konkretų įrankį;
- Netiesioginės užklausos, reiškiančios tą patį tikslą kitaip;
- Tolesnės užklausos, kurios pakartotinai naudoja anksčiau gautus identifikatorius;
- Rašymo operacijos, kurioms reikia autorizacijos arba patvirtinimo;
- Už užduoties ribų esančios užklausos, kurios neturėtų suaktyvinti jokio įrankio.
Kiekvienam atvejui užrašyk pasirinktą įrankį, jo argumentus, rezultatą, visas klaidas ir patvirtinimo elgseną. Kartok visą rinkinį kiekvieną kartą pakeitęs pavadinimą, aprašymą, schemą ar anotaciją. Jei serveris grąžina UI komponentą, testuok tiek patį komponentą, tiek modeliui suprantamą rezultatą.
Peržiūrėk žaliuosius mainus
Norėdamas perskaityti pilnas užklausas ir atsakymus, naudok API Playground, kuris priima MCP serverį: eik į Tools → Add → MCP Server, įvesk HTTPS adresą, prisijunk ir tada vykdyk savo testines užklausas.
Atnaujink metaduomenis
Po bet kokio pavadinimo, aprašymo, schemos, anotacijos, autentifikavimo metodo ar UI išteklio pakeitimo: perdiek arba paleisk serverį iš naujo, atverk ryšį adresu chatgpt.com/plugins, pasirink Refresh, patikrink, ar reklamuojami metaduomenys pasikeitė, ir pakartok atitinkamus testus naujame pokalbyje. Šis atnaujinimas taikomas tiesiogiai prijungtiems serveriams; paskelbtam papildiniui įrankių atnaujinimai patenka į nuolatinę peržiūrą (11 pamoka).
Prieš pakuodamas įsitikink, kad įrankių sąrašas atitinka reklamuojamas galimybes, kad struktūrizuoti rezultatai atitinka išvesties schemas, kad autentifikavimo nesėkmės grąžina naudingas klaidas, kad teisingos užklausos suaktyvina teisingus įrankius, o neteisingos – nė vieno, ir kad UI atsivaizduoja be konsolės klaidų, tinkamai atkurdamas savo būseną.
Visas papildinys
Kai serveris paruoštas – arba iškart papildiniui, sudarytam tik iš įgūdžių – supakuok papildinį (10 pamoka), pridėk jį į vietinę rinkvietę, įdiek iš papildinių katalogo, tada pakartok užklausas iš savo naudojimo atvejų inventorizacijos: tiesiogines, netiesiogines, tolesnes, neigiamas ir tyčia atmestus kraštinius atvejus. Patikrink, ar papildinys laikosi įgūdžių instrukcijų, naudoja teisingus išteklius, užbaigia kiekvieną žingsnį ir sukuria naudingą rezultatą; ar įgūdžiai kviečia teisingus įrankius; ir ar autentifikavimas veikia po įdiegimo.
Diagnozuok pagal sluoksnį
Kai kas nors neveikia, pradėk nuo gedimo sluoksnio izoliavimo: serverio, komponento ar ChatGPT kliento.
| Simptomas | Galima priežastis |
|---|---|
| Nėra įrankių sąraše | Ar serveris veikia? Ar adresas baigiasi /mcp? |
| Struktūrizuoti duomenys yra, bet komponento nėra | Ar įrankis turi _meta.ui.resourceUri, nukreipiantį į registruotą išteklių tipu text/html;profile=mcp-app, kuris užsikrauna be CSP klaidų? |
| Schemos klaidos | Ar tavo Python arba TypeScript modeliai atitinka reklamuojamą outputSchema? |
| Lėtas komponentas | Ar įrankių kvietimai viršija kelias šimtus milisekundžių? Profiliuok ir talpink į podėlį (cache). |
| Komponentas neužsikrauna | Naršyklės konsolė: CSP pažeidimas, nebaigtas ryšulys (bundle)? |
| Prarasta būsena (tempimas ir paleidimas, redagavimas) | Po kiekvieno atnaujinimo kviesk window.openai.setWidgetState ir atkurk iš window.openai.widgetState užsikrovimo metu. |
| Išdėstymas sugadintas mobiliuosiuose | Nuskaitk window.openai.displayMode ir window.openai.maxHeight; venk fiksuoto aukščio ir veiksmų užvedus pelę. |
| Įrankis niekada nepasirenkamas | Perrašyk aprašymą kaip „Naudok kai…“, peržiūrėk pradines užklausas. |
| Pasirenkamas neteisingas įrankis | Patikslink gretimų įrankių aprašymus, nurodyk atmestus atvejus, suskaidyk per daug plačius įrankius. |
| 401 klaidos | Įtrauk WWW-Authenticate į atsakymą; patikrink leidėją ir auditoriją. |
invalid_client esamame ryšyje | Ar registruotas OAuth klientas vis dar egzistuoja? Atkurk jį, o ne kurk naują. |
| ngrok tunelis baigėsi | Paleisk jį iš naujo, patikrink, ar vietinis serveris veikia; gamyboje naudok stabilų hostingą su būsenos zondais (health probes). |
| Srautinis perdavimas sutrinka už proxy | Apkrovos balansuoklis arba CDN turi perduoti HTTP srautą be buferizavimo. |
Jei problema išlieka, surink serverio žurnalus, komponento konsolę, įrankių kvietimų stenogramą ir ekrano kopijas. Užrašyk naudotą užklausą ir siųsk viską savo kontaktiniam asmeniui OpenAI.
Svarbiausi punktai
- Testuok sluoksniais: pirmiausia serverį atskirai (Inspector, tada ChatGPT), paskui visą papildinį
- Sudaryk vertinimų rinkinį: tiesioginės, netiesioginės, tolesnės, rašymo ir už užduoties ribų esančios užklausos
- API Playground rodo žaliuosius MCP mainus
- Refresh po kiekvieno metaduomenų pakeitimo, tada pradėk naują pokalbį
- Kilus problemoms, pirmiausia izoliuok sluoksnį: serverį, komponentą ar klientą