Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Testiranje in odpravljanje napak

Lekcija 9 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Testiranje po plasteh
  2. Strežnik MCP
  3. Celoten vtičnik
  4. Diagnosticiranje po plasteh
  5. Ključne ugotovitve

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.

SimptomVodilo
Nobeno orodje ni navedenoAli strežnik teče? Ali se naslov konča z /mcp?
Strukturirani podatki, a brez komponenteAli 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 shemeAli se tvoji modeli Python ali TypeScript ujemajo z oglaševano outputSchema?
Počasna komponentaAli klici orodij presegajo nekaj sto milisekund? Profiliraj in predpomni.
Komponenta se ne naložiKonzola 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 napravahPreberi window.openai.displayMode in window.openai.maxHeight; izogibaj se fiksnim višinam in dejanjem ob lebdenju.
Orodje nikoli ni izbranoPrepiši opis kot “Uporabi, ko…”, preglej začetne pozive.
Izbrano napačno orodjePojasni sosednja orodja, določi izključene primere, razdeli preširoka orodja.
Napake 401V odgovor vključi WWW-Authenticate; preveri izdajatelja in občinstvo.
invalid_client pri obstoječi povezaviAli registrirani odjemalec OAuth še obstaja? Obnovi ga, namesto da ustvariš novega.
Tunel ngrok potečePonovno 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žnikomUravnotež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