Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Testavimas ir derinimas

Paskaita 9 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Testuok sluoksniais
  2. MCP serveris
  3. Visas papildinys
  4. Diagnozuok pagal sluoksnį
  5. Svarbiausi punktai

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.

SimptomasGalima priežastis
Nėra įrankių sąrašeAr serveris veikia? Ar adresas baigiasi /mcp?
Struktūrizuoti duomenys yra, bet komponento nėraAr įrankis turi _meta.ui.resourceUri, nukreipiantį į registruotą išteklių tipu text/html;profile=mcp-app, kuris užsikrauna be CSP klaidų?
Schemos klaidosAr tavo Python arba TypeScript modeliai atitinka reklamuojamą outputSchema?
Lėtas komponentasAr įrankių kvietimai viršija kelias šimtus milisekundžių? Profiliuok ir talpink į podėlį (cache).
Komponentas neužsikraunaNarš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 mobiliuosiuoseNuskaitk window.openai.displayMode ir window.openai.maxHeight; venk fiksuoto aukščio ir veiksmų užvedus pelę.
Įrankis niekada nepasirenkamasPerrašyk aprašymą kaip „Naudok kai…“, peržiūrėk pradines užklausas.
Pasirenkamas neteisingas įrankisPatikslink 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šyjeAr registruotas OAuth klientas vis dar egzistuoja? Atkurk jį, o ne kurk naują.
ngrok tunelis baigėsiPaleisk jį iš naujo, patikrink, ar vietinis serveris veikia; gamyboje naudok stabilų hostingą su būsenos zondais (health probes).
Srautinis perdavimas sutrinka už proxyApkrovos 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ą