Testování a ladění
Lekce přepsána 3. listopadu 2026 na základě stránek Connect and test your plugin a Troubleshooting z dokumentace OpenAI Plugins. Bývalé „vývojové hřiště“ a jeho příkazy patřily k neexistujícímu SDK z první verze tohoto kurzu. Zdroje: Connect and test · Troubleshooting.
Testování po vrstvách
OpenAI doporučuje testovat každou schopnost před nasazením plně nainstalovaného pluginu: nejprve samostatný server MCP připojený k ChatGPT, poté zabalený plugin s jeho dovednostmi. Během vývoje si uchovávej své vyhodnocovací prompty a jejich výsledky, abys mohl porovnávat chování mezi jednotlivými verzemi.
Server MCP
Příprava koncového bodu
Než začneš testovat v ChatGPT, ověř, že je server dostupný prostřednictvím veřejného HTTPS – nebo přes Secure MCP Tunnel –, že komunikuje pomocí streamable HTTP (obvykle na /mcp), že jsou přítomny názvy nástrojů, popisy, schémata a anotace a že funguje zjišťování ověřování pro nástroje vyžadující účet. Vývojový tunel je pro zkoušky v pořádku, ale ne pro odeslání k publikaci.
Inspekce
MCP Inspector volá tvé nástroje přímo, bez modelu:
npx @modelcontextprotocol/inspector@latest
Prožeň každý nástroj všemi možnými situacemi: reprezentativní vstupy, hraniční případy, chybějící pověření a prázdné výsledky. Zkontroluj validaci schématu, chyby ověřování, anotace, chování při potvrzování a výstup čitelný pro model.
Vyhodnocení výběru nástrojů
Jakmile je server připojen jako osobní plugin (lekce 4), nainstaluj jej, otevři novou konverzaci, napiš @ a vyber jej. Sestav sadu pro vyhodnocení obsahující:
- Přímé požadavky, které by měly spustit konkrétní nástroj;
- Nepřímé požadavky, které vyjadřují stejný cíl odlišným způsobem;
- Následné požadavky, které znovu využívají identifikátory získané dříve;
- Operace zápisu vyžadující autorizaci nebo potvrzení;
- Požadavky mimo rozsah, které by neměly spustit žádný nástroj.
Pro každý z nich zaznamenej vybraný nástroj, jeho argumenty, výsledek, případné chyby a chování při potvrzování. Celou sadu znovu přehraj pokaždé, když změníš název, popis, schéma nebo anotaci. Pokud server vrací UI komponentu, otestuj jak samotnou komponentu, tak výsledek čitelný pro model.
Zobrazení surových výměn
Chceš-li číst úplné požadavky a odpovědi, API Playground přijímá server MCP: přejdi na Tools → Add → MCP Server, zadej adresu HTTPS, připoj se a poté spusť své testovací prompty.
Obnovení metadat
Po jakékoli změně názvu, popisu, schématu, anotace, metody ověřování nebo zdroje UI: znovu nasaď nebo restartuj server, otevři připojení na chatgpt.com/plugins, vyber Refresh, ověř, že se inzerovaná metadata změnila, a v nové konverzaci znovu přehraj příslušné testy. Toto obnovení platí pro přímo připojené servery; u publikovaného pluginu spadají aktualizace nástrojů pod průběžnou kontrolu (lekce 11).
Před zabalením ověř, že seznam nástrojů odpovídá inzerovaným schopnostem, že strukturované výsledky splňují výstupní schémata, že selhání ověřování vrací smysluplné chyby, že správné prompty spouštějí správné nástroje zatímco špatné nespustí žádné, a že se UI vykresluje bez chyb v konzoli a zároveň správně obnovuje svůj stav.
Celý plugin
Jakmile je server připraven – nebo okamžitě u pluginu sestávajícího pouze z dovedností – zabal plugin (lekce 10), přidej jej na lokální tržiště, nainstaluj jej z adresáře pluginů a poté znovu přehraj požadavky ze svého inventáře případů použití: přímé, nepřímé, následné, negativní a záměrně vyloučené hraniční případy. Ověř, že plugin dodržuje pokyny dovedností, používá správné zdroje, dokončí každý krok a vytvoří užitečný výsledek; že dovednosti volají správné nástroje; a že ověřování funguje po instalaci.
Diagnostika po vrstvách
Když se něco pokazí, začni izolací vadné vrstvy: server, komponenta nebo klient ChatGPT.
| Příznak | Stopa |
|---|---|
| Žádné nástroje nejsou uvedeny | Běží server? Končí adresa na /mcp? |
| Strukturovaná data, ale žádná komponenta | Obsahuje nástroj _meta.ui.resourceUri odkazující na registrovaný zdroj typu text/html;profile=mcp-app, který se načte bez chyb CSP? |
| Chyby schématu | Odpovídají tvé modely v Pythonu nebo TypeScriptu inzerovanému outputSchema? |
| Pomalá komponenta | Překračují volání nástrojů několik set milisekund? Profiluj a používej mezipaměť. |
| Komponenta se nenačte | Konzole prohlížeče: porušení CSP, neúplný balíček? |
| Ztráta stavu (drag-and-drop, úpravy) | Po každé aktualizaci volej window.openai.setWidgetState a při mountování obnovuj z window.openai.widgetState. |
| Rozbité rozložení na mobilu | Čti window.openai.displayMode a window.openai.maxHeight; vyhni se pevným výškám a akcím při najetí myší. |
| Nástroj nikdy není vybrán | Přepiš popis jako „Použij, když…“, zkontroluj úvodní prompty. |
| Vybrán špatný nástroj | Upřesni sousední nástroje, specifikuj vyloučené případy, rozděl příliš obecné nástroje. |
| Chyby 401 | Zahrň do odpovědi WWW-Authenticate; ověř vydavatele a cílovou skupinu. |
invalid_client u existujícího připojení | Existuje registrovaný klient OAuth stále? Obnov jej místo vytváření nového. |
| Tunel ngrok vypršel | Restartuj jej, ověř, že lokální server běží; v produkci použij stabilní hosting se sondami zdraví. |
| Streamování nefunguje za proxy | Zátěžová vyvažovačka nebo CDN musí propustit HTTP streamování bez bufferování. |
Pokud problém přetrvává, shromáždi logy serveru, konzoli komponenty, přepis volání nástrojů a snímky obrazovky. Poznamenej si použitý prompt a odešli vše svému kontaktovi v OpenAI.
Klíčové poznatky
- Testuj po vrstvách: nejprve samotný server (Inspector, poté ChatGPT), pak celý plugin
- Sestav sadu pro vyhodnocení: přímé, nepřímé, následné, zapisovací a požadavky mimo rozsah
- API Playground zobrazuje surové výměny MCP
- Po každé změně metadat proveď Refresh a poté zahaj novou konverzaci
- Při potížích nejprve izoluj vrstvu: server, komponenta nebo klient