Salt la conținutul principal
Română— Alege o limbă
Meniu

Testare și depanare

Lecția 9 din 14 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Testare pe straturi
  2. Serverul MCP
  3. Plugin-ul complet
  4. Diagnosticare pe straturi
  5. Puncte cheie

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.

SimptomPistă
Niciun instrument listatRulează 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 mobilCitiți window.openai.displayMode și window.openai.maxHeight; evitați înălțimile fixe și acțiunile la hover.
Instrumentul nu este niciodată selectatRescrieți descrierea ca „Utilizați când…“, revizuiți prompturile de start.
Este selectat instrumentul greșitClarificați instrumentele învecinate, specificați cazurile excluse, divizați instrumentele prea largi.
Erori 401Includeț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 proxyLoad 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