Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Testování a ladění

Lekce 9 z 14 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Testování po vrstvách
  2. Server MCP
  3. Celý plugin
  4. Diagnostika po vrstvách
  5. Klíčové poznatky

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říznakStopa
Žádné nástroje nejsou uvedenyBěží server? Končí adresa na /mcp?
Strukturovaná data, ale žádná komponentaObsahuje 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ématuOdpovídají tvé modely v Pythonu nebo TypeScriptu inzerovanému outputSchema?
Pomalá komponentaPřekračují volání nástrojů několik set milisekund? Profiluj a používej mezipaměť.
Komponenta se nenačteKonzole 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ánPřepiš popis jako „Použij, když…“, zkontroluj úvodní prompty.
Vybrán špatný nástrojUpřesni sousední nástroje, specifikuj vyloučené případy, rozděl příliš obecné nástroje.
Chyby 401Zahrň 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šelRestartuj jej, ověř, že lokální server běží; v produkci použij stabilní hosting se sondami zdraví.
Streamování nefunguje za proxyZá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