Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Testiranje i otklanjanje grešaka

Lekcija 9 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Testiranje po slojevima
  2. MCP poslužitelj
  3. Cijeli dodatak
  4. Dijagnostika po slojevima
  5. Ključne točke

Lekcija je ponovno napisana 3. studenog 2026. na temelju stranica Connect and test your plugin i Troubleshooting iz dokumentacije o OpenAI dodacima. Bivši “razvojni poligon” i njegove naredbe pripadali su nepostojećem SDK-u iz prve verzije ovog tečaja. Izvori: Povezivanje i testiranje · Otklanjanje grešaka.

Testiranje po slojevima

OpenAI preporučuje testiranje svake mogućnosti prije implementacije cijelog instaliranog dodatka: prvo samostalni MCP poslužitelj povezan s ChatGPT-om, zatim upakirani dodatak sa svojim vještinama. Tijekom razvoja čuvaj svoje evaluacijske upite i njihove rezultate kako bi mogao usporediti ponašanje između različitih verzija.

MCP poslužitelj

Priprema krajnje točke

Prije testiranja u ChatGPT-u, provjeri je li poslužitelj dostupan putem javnog HTTPS-a—ili kroz Secure MCP Tunnel—da koristi streamable HTTP (obično na /mcp), da su nazivi alata, opisi, sheme i bilješke prisutni te da otkrivanje autentifikacije funkcionira za alate koji zahtijevaju račun. Razvojni tunel prikladan je za probna razdoblja, ali ne i za slanje u proizvodnju.

Inspekcija

MCP Inspector izravno poziva tvoje alate, bez modela:

npx @modelcontextprotocol/inspector@latest

Stavi svaki alat na kušnju: reprezentativni unosi, rubni slučajevi, nedostajuće vjerodajnice i prazni rezultati. Provjeri validaciju sheme, pogreške autentifikacije, bilješke, ponašanje potvrde i izlaz čitljiv modelu.

Evaluacija odabira alata

Nakon što je poslužitelj povezan kao osobni dodatak (Lekcija 4), instaliraj ga, otvori novi razgovor, upiši @ i odaberi ga. Izgradi skup za evaluaciju koji sadrži:

  • Izravne zahtjeve koji bi trebali pokrenuti određeni alat;
  • Neizravne zahtjeve koji izražavaju isti cilj na drugačiji način;
  • Naknadne zahtjeve koji ponovno koriste identifikatore dobivene ranije;
  • Operacije pisanja koje zahtijevaju autorizaciju ili potvrdu;
  • Zahtjeve izvan opsega koji ne bi smjeli pokrenuti nijedan alat.

Za svaki od njih zabilježi odabrani alat, njegove argumente, rezultat, eventualne pogreške i ponašanje potvrde. Ponovno pokreni cijeli skup svaki put kada promijeniš naziv, opis, shemu ili bilješku. Ako poslužitelj vraća UI komponentu, testiraj i samu komponentu i rezultat čitljiv modelu.

Pregled sirove razmjene

Da bi pročitao pune zahtjeve i odgovore, API Playground prihvaća MCP poslužitelj: idi na Tools → Add → MCP Server, unesi HTTPS adresu, poveži se, a zatim pokreni svoje testne upite.

Osvježavanje metapodataka

Nakon bilo kakve promjene naziva, opisa, sheme, bilješke, metode autentifikacije ili UI resursa: ponovno implementiraj ili ponovno pokreni poslužitelj, otvori vezu na chatgpt.com/plugins, odaberi Refresh, provjeri jesu li se oglašavani metapodaci promijenili i ponovno pokreni relevantne testove u novom razgovoru. Ovo osvježavanje odnosi se na izravno povezane poslužitelje; za objavljene dodatke, ažuriranja alata podliježu kontinuiranom pregledu (Lekcija 11).

Prije pakiranja provjeri odgovara li popis alata oglašenim mogućnostima, da strukturirani rezultati zadovoljavaju izlazne sheme, da neuspjesi autentifikacije vraćaju korisne pogreške, da ispravni upiti pokreću ispravne alate dok pogrešni ne pokreću nijedan, te da se UI prikazuje bez pogrešaka u konzoli uz ispravno vraćanje stanja.

Cijeli dodatak

Kada je poslužitelj spreman—ili odmah za dodatak koji se sastoji samo od vještina—upakiraj dodatak (Lekcija 10), dodaj ga na lokalno tržište, instaliraj ga iz direktorija dodataka, a zatim ponovno pokreni zahtjeve iz svog popisa slučajeva uporabe: izravne, neizravne, naknadne, negativne i namjerno isključene rubne slučajeve. Provjeri slijedi li dodatak upute vještina, koristi li ispravne resurse, dovršava li svaki korak i proizvodi li koristan rezultat; da vještine pozivaju ispravne alate; i da autentifikacija funkcionira nakon instalacije.

Dijagnostika po slojevima

Kada nešto pođe po zlu, započni izolacijom neispravnog sloja: poslužitelj, komponenta ili ChatGPT klijent.

SimptomSmjernica
Nema navedenih alataRadi li poslužitelj? Završava li adresa s /mcp?
Strukturirani podaci, ali nema komponenteSadrži li alat _meta.ui.resourceUri koji pokazuje na registrirani resurs tipa text/html;profile=mcp-app koji se učitava bez CSP pogrešaka?
Pogreške shemeOdgovaraju li tvoji Python ili TypeScript modeli oglašenoj outputSchema?
Spora komponentaPrelaze li pozivi alata nekoliko stotina milisekundi? Profiliraj i keširaj.
Komponenta se ne učitavaKonzola preglednika: kršenje CSP-a, nepotpun paket?
Izgubljeno stanje (povuci-i-ispusti, uređivanje)Pozovi window.openai.setWidgetState nakon svakog ažuriranja i vrati stanje iz window.openai.widgetState prilikom montaže.
Raspored slomljen na mobiteluPročitaj window.openai.displayMode i window.openai.maxHeight; izbjegavaj fiksne visine i radnje na lebdenje.
Alat nikada nije odabranPrepiši opis kao “Koristi kada…”, pregledaj početne upite.
Odabran pogrešan alatPojasni susjedne alate, specificiraj isključene slučajeve, razdvoj preširoke alate.
401 pogreškeUključi WWW-Authenticate u odgovor; provjeri izdavatelja i publiku.
invalid_client na postojećoj veziPostoji li još uvijek registrirani OAuth klijent? Obnovi ga umjesto stvaranja novog.
ngrok tunel istječePonovno ga pokreni, provjeri radi li lokalni poslužitelj; u proizvodnji koristi stabilno hostanje s health probama.
Streamanje prekinuto iza proxyjaLoad balancer ili CDN mora propustiti HTTP streamanje bez međuspremanja.

Ako problem i dalje postoji, prikupi zapisnike poslužitelja, konzolu komponente, transkript poziva alata i snimke zaslona. Zabilježi korišteni upit i pošalji sve svom kontaktu u OpenAI-u.

Ključne točke

  • Testiraj po slojevima: prvo sam poslužitelj (Inspector, zatim ChatGPT), potom cijeli dodatak
  • Izgradi skup za evaluaciju: izravni, neizravni, naknadni, upisi i zahtjevi izvan opsega
  • API Playground prikazuje sirove MCP razmjene
  • Refresh nakon svake promjene metapodataka, zatim pokreni novi razgovor
  • Kada se pojave problemi, prvo izoliraj sloj: poslužitelj, komponenta ili klijent