Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Testimine ja silumine

Õppetund 9 / 14 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Testimine kihtide kaupa
  2. MCP server
  3. Täielik plugin
  4. Diagnoosimine kihtide kaupa
  5. Peamised punktid

Õ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ümptomJuhis
Tööriistu ei loetletaKas server töötab? Kas aadress lõpeb /mcp-ga?
Struktureeritud andmed on olemas, kuid komponenti poleKas tööriist sisaldab _meta.ui.resourceUri, mis viib registreeritud ressursile tüübiga text/html;profile=mcp-app ja laadub ilma CSP vigadeta?
Skeemi veadKas sinu Pythoni või TypeScripti mudelid vastavad reklaamitud outputSchema-le?
Aeglane komponentKas tööriistakutsed ületavad mõnisada millisekundit? Profileeri ja vahemällu salvesta.
Komponent ei laaduBrauseri 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 katkiLoe window.openai.displayMode ja window.openai.maxHeight; väldi fikseeritud kõrgusi ja hõljumistegevusi.
Tööriista ei valita kunagiKirjuta kirjeldus ümber kujul „Kasuta, kui…“, vaata üle alguspromptid.
Valitakse vale tööriistSelgista naabertööriistu, täpsusta välistatud juhtumeid, jaga liiga laiad tööriistad osadeks.
401 veadLisa vastusesse WWW-Authenticate; kontrolli väljastajat ja sihtrühma.
invalid_client olemasoleval ühenduselKas registreeritud OAuth klient on endiselt olemas? Taasta see uue loomise asemel.
ngrok tunnel aegubTaaskäivita see, veendu, et kohalik server töötab; tootmiskeskkonnas kasuta stabiilset majutust tervisekontrollidega.
Voogedastus on proxy taga katkiKoormusjaotur 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