Testare și depanare
Pe această pagină
Lecție rescrisă la 3 noiembrie 2026 pe baza paginilor Connect and test your plugin și Troubleshooting din documentația OpenAI Plugins. Fostul „development playground“ și comenzile sale aparțineau unui SDK inexistent din prima versiune a acestui curs. Surse: Connect and test · Troubleshooting.
Testare pe straturi
OpenAI recomandă testarea fiecărei funcționalități înainte de a implementa plugin-ul complet instalat: mai întâi serverul MCP autonom conectat la ChatGPT, apoi plugin-ul împachetat cu abilitățile sale. Păstrați prompturile de evaluare și rezultatele acestora pe tot parcursul dezvoltării pentru a putea compara comportamentul între versiuni.
Serverul MCP
Pregătirea endpoint-ului
Înainte de a testa în ChatGPT, verificați dacă serverul este accesibil prin HTTPS public—sau printr-un Secure MCP Tunnel—, dacă utilizează streamable HTTP (de obicei pe /mcp), dacă numele instrumentelor, descrierile, schemele și adnotările sunt prezente și dacă descoperirea autentificării funcționează pentru instrumentele care necesită un cont. Un tunel de dezvoltare este acceptabil pentru teste, dar nu pentru submitere.
Inspecție
MCP Inspector apelează instrumentele dumneavoastră direct, fără un model:
npx @modelcontextprotocol/inspector@latest
Supuneți fiecare instrument unor teste riguroase: intrări reprezentative, cazuri limită, credențiale lipsă și rezultate goale. Verificați validarea schemei, erorile de autentificare, adnotările, comportamentul de confirmare și ieșirea lizibilă de către model.
Evaluarea selecției instrumentelor
Odată ce serverul este conectat ca plugin personal (Lecția 4), instalați-l, deschideți o conversație nouă, tastați @ și selectați-l. Construiți un set de evaluare care conține:
- Cereri directe care ar trebui să declanșeze un instrument specific;
- Cereri indirecte care exprimă același obiectiv diferit;
- Cereri de follow-up care reutilizează identificatori obținuți anterior;
- Operațiuni de scriere care necesită autorizare sau confirmare;
- Cereri în afara domeniului de aplicare care nu ar trebui să declanșeze niciun instrument.
Pentru fiecare, înregistrați instrumentul selectat, argumentele sale, rezultatul, eventualele erori și comportamentul de confirmare. Repetați întregul set de fiecare dată când modificați un nume, o descriere, o schemă sau o adnotare. Dacă serverul returnează o componentă UI, testați atât componenta în sine, cât și rezultatul lizibil de către model.
Vizualizarea schimburilor brute
Pentru a citi cererile și răspunsurile complete, API Playground acceptă un server MCP: mergeți la Tools → Add → MCP Server, introduceți adresa HTTPS, conectați-vă, apoi rulați prompturile de test.
Reîmprospătarea metadatelor
După orice modificare a unui nume, descrieri, scheme, adnotări, metode de autentificare sau resurse UI: reimplantați sau reporniți serverul, deschideți conexiunea la chatgpt.com/plugins, selectați Refresh, verificați dacă metadatele publicitate s-au modificat și reluați testele relevante într-o conversație nouă. Această reîmprospătare se aplică serverelor conectate direct; pentru un plugin publicat, actualizările instrumentelor fac obiectul unei revizuiri continue (Lecția 11).
Înainte de împachetare, verificați dacă lista de instrumente corespunde funcționalităților publicitate, dacă rezultatele structurate respectă schemele de ieșire, dacă eșecurile de autentificare returnează erori utile, dacă prompturile corecte declanșează instrumentele potrivite în timp ce cele greșite nu declanșează niciunul și dacă UI se randează fără erori în consolă, restabilind corect starea sa.
Plugin-ul complet
Odată ce serverul este pregătit—sau imediat pentru un plugin compus doar din abilități—împachetați plugin-ul (Lecția 10), adăugați-l într-o piață locală, instalați-l din directorul de plugin-uri, apoi repetați cererile din inventarul cazurilor de utilizare: directe, indirecte, de follow-up, negative și cazuri limită excluse intenționat. Verificați dacă plugin-ul urmează instrucțiunile abilităților, utilizează resursele corecte, completează fiecare pas și produce un rezultat util; dacă abilitățile apelează instrumentele corecte; și dacă autentificarea funcționează după instalare.
Diagnosticare pe straturi
Când ceva nu funcționează, începeți prin izolarea stratului defectuos: server, componentă sau client ChatGPT.
| Simptom | Pistă |
|---|---|
| Niciun instrument listat | Rulează serverul? Se termină adresa în /mcp? |
| Date structurate, dar nicio componentă | Include instrumentul _meta.ui.resourceUri care indică spre o resursă înregistrată de tip text/html;profile=mcp-app ce se încarcă fără erori CSP? |
| Erori de schemă | Modelele dumneavoastră Python sau TypeScript corespund cu outputSchema publicitat? |
| Componentă lentă | Depășesc apelurile de instrumente câteva sute de milisecunde? Realizați profilarea și implementați cache-ul. |
| Componenta nu se încarcă | Consola browserului: încălcare CSP, bundle incomplet? |
| Stare pierdută (drag-and-drop, editare) | Apelați window.openai.setWidgetState după fiecare actualizare și restaurați din window.openai.widgetState la montare. |
| Aspect stricat pe mobil | Citiți window.openai.displayMode și window.openai.maxHeight; evitați înălțimile fixe și acțiunile la hover. |
| Instrumentul nu este niciodată selectat | Rescrieți descrierea ca „Utilizați când…“, revizuiți prompturile de start. |
| Este selectat instrumentul greșit | Clarificați instrumentele învecinate, specificați cazurile excluse, divizați instrumentele prea largi. |
| Erori 401 | Includeți WWW-Authenticate în răspuns; verificați emitentul și audiența. |
invalid_client la o conexiune existentă | Mai există clientul OAuth înregistrat? Restaurați-l în loc să creați unul nou. |
| Tunelul ngrok expiră | Reporniți-l, verificați dacă serverul local rulează; în producție, utilizați găzduire stabilă cu sonde de sănătate. |
| Streaming întrerupt în spatele unui proxy | Load balancer-ul sau CDN-ul trebuie să permită trecerea fluxului HTTP fără buffering. |
Dacă problema persistă, colectați jurnalele serverului, consola componentei, o transcriere a apelurilor de instrumente și capturi de ecran. Notați promptul utilizat și trimiteți totul contactului dumneavoastră de la OpenAI.
Puncte cheie
- Testați pe straturi: serverul singur (Inspector, apoi ChatGPT), apoi plugin-ul complet
- Construiți un set de evaluare: cereri directe, indirecte, de follow-up, de scriere și în afara domeniului
- API Playground afișează schimburile MCP brute
- Refresh după fiecare modificare de metadate, apoi începeți o conversație nouă
- Când apar probleme, izolați mai întâi stratul: server, componentă sau client