Testiranje in odpravljanje napak
Na tej strani
Lekcija na novo napisana 3. novembra 2026 na podlagi strani Connect and test your plugin in Troubleshooting iz dokumentacije za vtičnike OpenAI. Nekdanji “razvojni poligon” in njegovi ukazi so pripadali neobstoječemu SDK-ju iz prve različice tega tečaja. Viri: Povezava in testiranje · Odpravljanje težav.
Testiranje po plasteh
OpenAI priporoča testiranje vsake zmožnosti pred namestitvijo celotnega vtičnika: najprej samostojni strežnik MCP, povezan s ChatGPT, nato pakirani vtičnik z njegovimi veščinami. Med razvojem hrani svoje evalvacijske pozive in njihove rezultate, da lahko primerjaš obnašanje med različicami.
Strežnik MCP
Priprava končne točke
Pred testiranjem v ChatGPT preveri, ali je strežnik dosegljiv prek javnega HTTPS ali prek varnega tunela MCP, ali govori prenosljivi HTTP (običajno na /mcp), ali so prisotna imena orodij, opisi, sheme in opombe ter ali odkrivanje avtentikacije deluje za orodja, ki zahtevajo račun. Razvojni tunel je primeren za poskuse, ne pa za oddajo.
Pregled
MCP Inspector kliče tvoja orodja neposredno, brez modela:
npx @modelcontextprotocol/inspector@latest
Vsako orodje temeljito preizkusi: reprezentativni vnosi, robni primeri, manjkajoča poverila in prazni rezultati. Preveri validacijo sheme, napake avtentikacije, opombe, obnašanje pri potrditvi in izhod, ki ga model lahko prebere.
Ocena izbire orodij
Ko je strežnik povezan kot osebni vtičnik (lekcija 4), ga namesti, odpri nov pogovor, vpiši @ in ga izberi. Sestavi evalvacijski nabor, ki vsebuje:
- Neposredne zahteve, ki naj sprožijo določeno orodje;
- Posredne zahteve, ki izražajo isti cilj na drugačen način;
- Nadaljnje zahteve, ki ponovno uporabijo identifikatorje, pridobljene prej;
- Operacije zapisovanja, ki zahtevajo avtorizacijo ali potrditev;
- Zahteve izven obsega, ki ne smejo sprožiti nobenega orodja.
Za vsako zabeleži izbrano orodje, njegove argumente, rezultat, morebitne napake in obnašanje pri potrditvi. Celoten nabor ponovi vsakič, ko spremeniš ime, opis, shemo ali opombo. Če strežnik vrne UI-komponento, testiraj tako samo komponento kot tudi rezultat, ki ga prebere model.
Ogled surovih izmenjav
Za branje celotnih zahtev in odgovorov API Playground sprejme strežnik MCP: pojdi na Tools → Add → MCP Server, vnesi naslov HTTPS, se poveži in nato zaženi svoje testne pozive.
Osvežitev metapodatkov
Po vsaki spremembi imena, opisa, sheme, opombe, metode avtentikacije ali UI-vira: znova uvedi ali ponovno zaženi strežnik, odpri povezavo na chatgpt.com/plugins, izberi Refresh, preveri, ali so se oglaševani metapodatki spremenili, in ponovi ustrezne teste v novem pogovoru. Ta osvežitev velja za neposredno povezane strežnike; za objavljeni vtičnik posodobitve orodij spadajo pod stalni pregled (lekcija 11).
Pred pakiranjem preveri, ali seznam orodij ustreza oglaševanim zmožnostim, ali strukturirani rezultati ustrezajo izhodnim shemam, ali napake avtentikacije vračajo uporabne napake, ali pravi pozivi sprožijo prava orodja, napačni pa nobenega, in ali se UI izriše brez napak v konzoli ter pravilno obnovi svoje stanje.
Celoten vtičnik
Ko je strežnik pripravljen – ali takoj za vtičnik, ki ga sestavljajo le veščine – zapakiraj vtičnik (lekcija 10), ga dodaj v lokalno tržnico, namesti iz imenika vtičnikov in nato ponovi zahteve iz svojega inventarja primerov uporabe: neposredne, posredne, nadaljnje, negativne in namerno izključene robne primere. Preveri, ali vtičnik sledi navodilom veščin, uporablja pravilne vire, zaključi vsak korak in proizvede uporaben rezultat; ali veščine kličejo prava orodja; in ali avtentikacija deluje po namestitvi.
Diagnosticiranje po plasteh
Ko gre kaj narobe, začni z izolacijo okvarjene plasti: strežnik, komponenta ali odjemalec ChatGPT.
| Simptom | Vodilo |
|---|---|
| Nobeno orodje ni navedeno | Ali strežnik teče? Ali se naslov konča z /mcp? |
| Strukturirani podatki, a brez komponente | Ali orodje vključuje _meta.ui.resourceUri, ki kaže na registriran vir tipa text/html;profile=mcp-app, ki se naloži brez napak CSP? |
| Napake sheme | Ali se tvoji modeli Python ali TypeScript ujemajo z oglaševano outputSchema? |
| Počasna komponenta | Ali klici orodij presegajo nekaj sto milisekund? Profiliraj in predpomni. |
| Komponenta se ne naloži | Konzola brskalnika: kršitev CSP, nepopoln snop? |
| Izgubljeno stanje (povleci-in-spusti, urejanje) | Pokliči window.openai.setWidgetState po vsaki posodobitvi in obnovi iz window.openai.widgetState ob namestitvi. |
| Postavitev pokvarjena na mobilnih napravah | Preberi window.openai.displayMode in window.openai.maxHeight; izogibaj se fiksnim višinam in dejanjem ob lebdenju. |
| Orodje nikoli ni izbrano | Prepiši opis kot “Uporabi, ko…”, preglej začetne pozive. |
| Izbrano napačno orodje | Pojasni sosednja orodja, določi izključene primere, razdeli preširoka orodja. |
| Napake 401 | V odgovor vključi WWW-Authenticate; preveri izdajatelja in občinstvo. |
invalid_client pri obstoječi povezavi | Ali registrirani odjemalec OAuth še obstaja? Obnovi ga, namesto da ustvariš novega. |
| Tunel ngrok poteče | Ponovno ga zaženi, preveri, ali lokalni strežnik teče; v proizvodnji uporabi stabilno gostovanje s sondami za zdravje. |
| Pretok prekinjen za posredniškim strežnikom | Uravnotežilnik obremenitve ali CDN mora prenesti HTTP pretok brez medpomnjenja. |
Če težava vztraja, zberi dnevnike strežnika, konzolo komponente, prepis klicev orodij in posnetke zaslona. Zabeleži uporabljeni poziv in vse skupaj pošlji svojemu kontaktu pri OpenAI.
Ključne ugotovitve
- Testiraj po plasteh: najprej sam strežnik (Inspector, nato ChatGPT), nato celoten vtičnik
- Sestavi evalvacijski nabor: neposredne, posredne, nadaljnje zahteve, zahteve za zapis in zahteve izven obsega
- API Playground prikazuje surove izmenjave MCP
- Po vsaki spremembi metapodatkov izvedi Refresh, nato začni nov pogovor
- Ko nastanejo težave, najprej izoliraj plast: strežnik, komponenta ali odjemalec