Tesztelés és hibakeresés
Ezen az oldalon
A leckét 2026. november 3-án írtuk át az OpenAI Bővítmények dokumentációjának Connect and test your plugin és Troubleshooting oldalai alapján. Az eredeti kurzus első verziójában szereplő, nem létező SDK-hoz tartozó „fejlesztői játszótér“ és annak parancsai már elavultak. Források: Connect and test · Troubleshooting.
Réteges tesztelés
Az OpenAI azt javasolja, hogy a teljes bővítmény telepítése előtt minden egyes képességet külön-külön tesztelj le: először az önálló MCP szervert, amelyet közvetlenül a ChatGPT-hez csatlakoztatsz, majd a csomagolt bővítményt a hozzá tartozó készségekkel. A fejlesztés során őrizd meg az értékelési promptjaidat és azok eredményeit, hogy össze tudd hasonlítani a viselkedést a különböző verziók között.
Az MCP szerver
A végpont előkészítése
Mielőtt a ChatGPT-ben tesztelnéd, győződj meg arról, hogy a szerver elérhető nyilvános HTTPS-en keresztül – vagy egy Secure MCP Tunnel segítségével –, hogy támogatja a streamable HTTP protokollt (jellemzően az /mcp útvonalon), hogy jelen vannak az eszköznevek, leírások, sémák és annotációk, valamint hogy a hitelesítés felderítése működik azoknál az eszközöknél, amelyek fiókot igényelnek. Fejlesztési alagút kísérletezésre megfelel, de beküldéshez nem.
Ellenőrzés
Az MCP Inspector közvetlenül hívja meg az eszközeidet, modell nélkül:
npx @modelcontextprotocol/inspector@latest
Vizsgáld meg alaposan az összes eszközt: használj reprezentatív bemeneteket, szélsőséges eseteket, hiányzó hitelesítő adatokat és üres eredményeket. Ellenőrizd a sémaérvényesítést, a hitelesítési hibákat, az annotációkat, a megerősítési viselkedést és a modell által olvasható kimenetet.
Az eszközkiválasztás értékelése
Miután a szervert személyes bővítményként csatlakoztattad (4. lecke), telepítsd, nyiss egy új beszélgetést, írd be az @ jelet, és válaszd ki azt. Készíts egy értékelési készletet, amely tartalmazza:
- Olyan közvetlen kéréseket, amelyeknek egy konkrét eszközt kellene aktiválniuk;
- Olyan közvetett kéréseket, amelyek ugyanazt a célt másképpen fogalmazzák meg;
- Olyan követő kéréseket, amelyek korábban kapott azonosítókat használnak fel;
- Olyan írási műveleteket, amelyek engedélyt vagy megerősítést igényelnek;
- Olyan hatókörön kívüli kéréseket, amelyeknek egyetlen eszközt sem szabadna aktiválniuk.
Minden egyes esetben jegyezd fel a kiválasztott eszközt, annak argumentumait, az eredményt, esetleges hibákat és a megerősítési viselkedést. Ismételd meg a teljes készletet valahányszor megváltoztatsz egy nevet, leírást, sémát vagy annotációt. Ha a szerver UI-komponenst ad vissza, teszteld le magát a komponenst és a modell által olvasható eredményt is.
A nyers adatcsere megtekintése
A teljes kérések és válaszok olvasásához az API Playground elfogad egy MCP szervert: menj a Tools → Add → MCP Server menüpontra, add meg a HTTPS címet, csatlakozz, majd futtasd le a tesztpromptjaidat.
Metaadatok frissítése
Bármilyen név, leírás, séma, annotáció, hitelesítési módszer vagy UI-erőforrás módosítása után: telepítsd újra vagy indítsd újra a szervert, nyisd meg a kapcsolatot a chatgpt.com/plugins oldalon, válaszd a Refresh lehetőséget, ellenőrizd, hogy a hirdetett metaadatok megváltoztak-e, majd egy új beszélgetésben ismételd meg a vonatkozó teszteket. Ez a frissítés a közvetlenül csatlakoztatott szerverekre vonatkozik; egy közzétett bővítmény esetén az eszközfrissítések a folyamatos felülvizsgálat alá esnek (11. lecke).
Csomagolás előtt ellenőrizd, hogy az eszközlista megfelel-e a hirdetett képességeknek, hogy a strukturált eredmények megfelelnek-e a kimeneti sémáknak, hogy a hitelesítési hibák hasznos hibaüzeneteket adnak-e vissza, hogy a megfelelő promptok a megfelelő eszközöket aktiválják, a helytelenek pedig egyet sem, valamint hogy a UI konzolhibák nélkül jelenik meg, és helyesen állítja vissza az állapotát.
A teljes bővítmény
Amint a szerver készen áll – vagy kizárólag készségekből álló bővítmény esetén azonnal –, csomagold be a bővítményt (10. lecke), add hozzá egy helyi piactérhez, telepítsd a bővítménykönyvtárból, majd ismételd meg a használati esetek listájából származó kéréseket: közvetlen, közvetett, követő, negatív és szándékosan kizárt szélsőséges eseteket. Ellenőrizd, hogy a bővítmény követi-e a készségek utasításait, a megfelelő erőforrásokat használja-e, végrehajtja-e az egyes lépéseket, és hasznos eredményt produkál-e; hogy a készségek a megfelelő eszközöket hívják-e meg; és hogy a hitelesítés a telepítés után működik-e.
Hibakeresés rétegenként
Ha valami hiba történik, kezdd a hibás réteg izolálásával: szerver, komponens vagy ChatGPT kliens.
| Tünet | Nyomozási irány |
|---|---|
| Nincsenek felsorolva eszközök | Fut a szerver? A cím /mcp-re végződik? |
| Strukturált adat van, de nincs komponens | Tartalmazza az eszköz a _meta.ui.resourceUri mezőt, amely egy regisztrált, text/html;profile=mcp-app típusú erőforrásra mutat, és betöltődik CSP-hibák nélkül? |
| Séma hibák | Megfelelnek a Python vagy TypeScript modelljeid a hirdetett outputSchema-nak? |
| Lassú komponens | Több száz milliszekundumot vesznek igénybe az eszköz hívások? Profilozz és használj gyorsítótárazást. |
| A komponens nem töltődik be | Böngésző konzol: CSP-sértés, hiányos csomag? |
| Elveszett állapot (húzd és ejtsd, szerkesztés) | Hívd meg a window.openai.setWidgetState függvényt minden frissítés után, és állítsd vissza az állapotot a window.openai.widgetState alapján a betöltéskor (mount). |
| A elrendezés mobilnézetben sérül | Olvasd be a window.openai.displayMode és window.openai.maxHeight értékeket; kerüld a rögzített magasságokat és a rámutatós (hover) műveleteket. |
| Az eszközt sosem választja ki | Írd át a leírást „Akkor használd, ha…“ formátumra, és tekintsd át a kezdő promptokat. |
| Rossz eszköz kerül kiválasztásra | Tisztázd a szomszédos eszközöket, specifikáld a kizárt eseteket, bontsd fel a túl általános eszközöket. |
| 401-es hibák | Foglald bele a WWW-Authenticate fejlécet a válaszba; ellenőrizd a kibocsátót (issuer) és a célközönséget (audience). |
invalid_client hiba egy meglévő kapcsolaton | Létezik még a regisztrált OAuth kliens? Állítsd vissza inkább, mintsem hozz létre egy újat. |
| Az ngrok alagút lejárt | Indítsd újra, ellenőrizd, hogy a helyi szerver fut-e; éles környezetben használj stabil hosztingot állapotfigyelő próbákkal (health probes). |
| A streaming megszakad egy proxy mögött | A terheléselosztónak vagy CDN-nek pufferelés nélkül kell továbbítania a HTTP streaminget. |
Ha a probléma továbbra is fennáll, gyűjtsd össze a szervernaplókat, a komponens konzolját, az eszköz hívások átiratát és a képernyőmentéseket. Jegyezd fel a használt promptot, és küldd el az egészet az OpenAI-nál lévő kapcsolattartódnak.
Főbb megállapítások
- Tesztelj rétegesen: először a szervert önmagában (Inspector, majd ChatGPT), aztán a teljes bővítményt
- Készíts értékelési készletet: közvetlen, közvetett, követő, írási és hatókörön kívüli kérésekből
- Az API Playground megmutatja a nyers MCP adatcseréket
- Frissíts minden metaadat-változtatás után, majd indíts egy új beszélgetést
- Hiba esetén először izoláld a réteget: szerver, komponens vagy kliens