Testimine ja silumine
Sellel lehel
Õppetund kirjutati ümber 3. novembril 2026, tuginedes OpenAI pluginate dokumentatsiooni lehtedele Connect and test your plugin ja Troubleshooting. Eelmises kursuseversioonis mainitud „arendusliivakast“ ja selle käsud kuulusid olematule SDK-le. Allikad: Ühendamine ja testimine · Tõrkeotsing.
Testimine kihtide kaupa
OpenAI soovitab enne täieliku installitud plugina kasutuselevõttu testida iga võimalust eraldi: esmalt iseseisvat MCP serverit, mis on ühendatud ChatGPT-ga, seejärel pakendatud pluginat koos selle oskustega. Säilita arenduse käigus oma hindamispromptid ja nende tulemused, et saaksid käitumist erinevate versioonide lõikes võrrelda.
MCP server
Endpunkti ettevalmistamine
Enne ChatGPT-s testimist veendu, et server on avaliku HTTPS-i kaudu või Secure MCP Tunneli abil kättesaadav, et see kasutaks streamable HTTP-d (tavaliselt aadressil /mcp), et tööriistade nimed, kirjeldused, skeemid ja annotatsioonid on olemas ning et autentimise avastamine toimib tööriistade puhul, mis nõuavad kontot. Arendustunnel sobib katsetamiseks, kuid mitte esitamiseks.
Inspekteerimine
MCP Inspector kutsub sinu tööriistu otse, ilma mudelit kasutamata:
npx @modelcontextprotocol/inspector@latest
Pane iga tööriist proovile: kasuta tüüpilisi sisendeid, äärmuslikke juhtumeid, puuduvaid mandaate ja tühje tulemusi. Kontrolli skeemi valideerimist, autentimisvigu, annotatsioone, kinnituskäitumist ja mudelile loetavat väljundit.
Tööriistade valiku hindamine
Kui server on isikliku pluginana ühendatud (õppetund 4), installi see, ava uus vestlus, sisesta @ ja vali see. Koosta hindamiskomplekt, mis sisaldab:
- Otsesteid päringuid, mis peaksid käivitama konkreetse tööriista;
- Kaudseid päringuid, mis väljendavad sama eesmärki teistsugusel viisil;
- Järelpäringuid, mis kasutavad varem saadud identifikaatoreid;
- Kirjutamistoiminguid, mis nõuavad autoriseerimist või kinnitust;
- Teemavälistest päringuid, mis ei tohiks ühtegi tööriista käivitada.
Iga juhtumi puhul salvesta valitud tööriist, selle argumendid, tulemus, võimalikud vead ja kinnituskäitumine. Korda kogu komplekti iga kord, kui muudad nime, kirjeldust, skeemi või annotatsiooni. Kui server tagastab kasutajaliidese komponendi, testi nii komponenti ennast kui ka mudelile loetavat tulemust.
Toorvahetuste vaatamine
Täielike päringute ja vastuste lugemiseks aktsepteerib API Playground MCP serverit: mine menüüsse Tools → Add → MCP Server, sisesta HTTPS-aadress, ühenda ja käivita oma testipromptid.
Metaandmete värskendamine
Pärast mis tahes muudatust nimes, kirjelduses, skeemis, annotatsioonis, autentimismeetodis või kasutajaliidese ressursis: võta server uuesti kasutusele või taaskäivita see, ava ühendus aadressil chatgpt.com/plugins, vali Refresh, veendu, et reklaamitud metaandmed on muutunud, ja korda asjakohaseid teste uues vestluses. See värskendamine kehtib otse ühendatud serverite kohta; avaldatud plugina puhul kuuluvad tööriistade uuendused pideva läbivaatamise alla (õppetund 11).
Enne pakendamist veendu, et tööriistade loend vastab deklareeritud võimalustele, et struktureeritud tulemused järgivad väljundiskeeme, et autentimisvead tagastavad kasulikke veateateid, et õiged promptid käivitavad õigeid tööriistu ja valed mitte ühtegi, ning et kasutajaliides renderdub ilma konsoolivigadeta, taastades oma oleku korrektselt.
Täielik plugin
Kui server on valmis – või kohe, kui plugin koosneb ainult oskustest – pakenda plugin (õppetund 10), lisa see kohalikku turuplatsi, installi see pluginate kataloogist ja korda oma kasutusjuhtude nimekirja päringuid: otsesed, kaudsed, järelpäringud, negatiivsed ja tahtlikult välistatud äärmuslikud juhtumid. Veendu, et plugin järgib oskuste juhiseid, kasutab õigeid ressursse, viib iga sammu lõpule ja toodab kasuliku tulemuse; et oskused kutsuvad õigeid tööriistu; ja et autentimine toimib pärast installimist.
Diagnoosimine kihtide kaupa
Kui midagi läheb valesti, alusta veaallika kihi isoleerimisest: server, komponent või ChatGPT klient.
| Sümptom | Juhis |
|---|---|
| Tööriistu ei loetleta | Kas server töötab? Kas aadress lõpeb /mcp-ga? |
| Struktureeritud andmed on olemas, kuid komponenti pole | Kas tööriist sisaldab _meta.ui.resourceUri, mis viib registreeritud ressursile tüübiga text/html;profile=mcp-app ja laadub ilma CSP vigadeta? |
| Skeemi vead | Kas sinu Pythoni või TypeScripti mudelid vastavad reklaamitud outputSchema-le? |
| Aeglane komponent | Kas tööriistakutsed ületavad mõnisada millisekundit? Profileeri ja vahemällu salvesta. |
| Komponent ei laadu | Brauseri konsool: CSP rikkumine, poolik pakett? |
| Olek on kadunud (loomine ja redigeerimine) | Kutsu window.openai.setWidgetState pärast iga uuendust ja taasta olek window.openai.widgetState kaudu mountimisel. |
| Paigutus on mobiilis katki | Loe window.openai.displayMode ja window.openai.maxHeight; väldi fikseeritud kõrgusi ja hõljumistegevusi. |
| Tööriista ei valita kunagi | Kirjuta kirjeldus ümber kujul „Kasuta, kui…“, vaata üle alguspromptid. |
| Valitakse vale tööriist | Selgista naabertööriistu, täpsusta välistatud juhtumeid, jaga liiga laiad tööriistad osadeks. |
| 401 vead | Lisa vastusesse WWW-Authenticate; kontrolli väljastajat ja sihtrühma. |
invalid_client olemasoleval ühendusel | Kas registreeritud OAuth klient on endiselt olemas? Taasta see uue loomise asemel. |
| ngrok tunnel aegub | Taaskäivita see, veendu, et kohalik server töötab; tootmiskeskkonnas kasuta stabiilset majutust tervisekontrollidega. |
| Voogedastus on proxy taga katki | Koormusjaotur või CDN peab HTTP voogedastuse puhverdamata läbi laskma. |
Kui probleem püsib, kogu serveri logid, komponendi konsool, tööriistakutsete transkript ja ekraanitõmmised. Märki üles kasutatud prompt ja saada kõik oma kontaktisikule OpenAI-s.
Peamised punktid
- Testi kihtide kaupa: esmalt server üksi (Inspector, seejärel ChatGPT), seejärel täielik plugin
- Koosta hindamiskomplekt: otsesed, kaudsed, järelpäringud, kirjutamis- ja teemavälised päringud
- API Playground näitab tooreid MCP vahetusi
- Värskenda pärast iga metaandmete muudatust ja alusta seejärel uut vestlust
- Probleemide korral isoleeri esmalt kiht: server, komponent või klient