Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Testēšana un atkļūdošana

Nodarbība 9 no 14 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Testēšana pa slāņiem
  2. MCP serveris
  3. Pilns spraudnis
  4. Diagnosticē pa slāņiem
  5. Galvenās atziņas

Nodarbība pārrakstīta 2026. gada 3. novembrī, pamatojoties uz OpenAI spraudņu dokumentācijas lapām Connect and test your plugin un Troubleshooting. Iepriekšējā “izstrādes rotaļu laukuma” un tā komandas piederēja šī kursa pirmās versijas neeksistējošajam SDK. Avoti: Connect and test · Troubleshooting.

Testēšana pa slāņiem

OpenAI iesaka pārbaudīt katru iespēju pirms pilna instalētā spraudņa izvietošanas: vispirms savrupu MCP serveri, kas pieslēgts ChatGPT, un pēc tam iepakoto spraudni ar tā prasmēm. Izstrādes laikā saglabā savus novērtēšanas uzvedumus un to rezultātus, lai vari salīdzināt uzvedību dažādās versijās.

MCP serveris

Sagatavo galapunktu

Pirms testēšanas ChatGPT vidē pārliecinies, ka serveris ir sasniedzams, izmantojot publisku HTTPS vai arī Secure MCP Tunnel; ka tas atbalsta streamable HTTP (parasti adresē /mcp); ka ir norādīti rīku nosaukumi, apraksti, shēmas un anotācijas; un ka autentifikācijas noteikšana darbojas rīkiem, kuriem nepieciešams konts. Izstrādes tunelis ir piemērots izmēģinājumiem, bet ne iesniegšanai.

Inspekcija

MCP Inspector izsauc tavus rīkus tieši, bez modeļa:

npx @modelcontextprotocol/inspector@latest

Iztestē katru rīku vispusīgi: izmanto reprezentatīvas ievades, robežgadījumus, trūkstošus akreditācijas datus un tukšus rezultātus. Pārbaudi shēmas validāciju, autentifikācijas kļūdas, anotācijas, apstiprināšanas uzvedību un modelim lasāmu izvadi.

Novērtē rīku atlasi

Kad serveris ir pieslēgts kā personīgais spraudnis (4. nodarbība), instalē to, atver jaunu sarunu, ieraksti @ un atlasī to. Izveido novērtēšanas kopu, kas satur:

  • Tiešus pieprasījumus, kuriem vajadzētu aktivizēt konkrētu rīku;
  • Netiešus pieprasījumus, kas izsaka to pašu mērķi citādāk;
  • Turpinājuma pieprasījumus, kas atkārtoti izmanto iepriekš iegūtus identifikatorus;
  • Rakstīšanas operācijas, kurām nepieciešama autorizācija vai apstiprinājums;
  • Pieprasījumus ārpus darbības jomas, kuriem nevajadzētu aktivizēt nevienu rīku.

Katram no tiem reģistrē izvēlēto rīku, tā argumentus, rezultātu, visas kļūdas un apstiprināšanas uzvedību. Atkārto visu kopu ikreiz, kad maini nosaukumu, aprakstu, shēmu vai anotāciju. Ja serveris atgriež UI komponenti, testē gan pašu komponenti, gan modelim lasāmo rezultātu.

Apskati neapstrādātās apmaiņas

Lai lasītu pilnus pieprasījumus un atbildes, API Playground pieņem MCP serveri: dodies uz Tools → Add → MCP Server, ievadi HTTPS adresi, izveido savienojumu un pēc tam palaid savus testēšanas uzvedumus.

Atsvaidzini metadatus

Pēc jebkādām izmaiņām nosaukumā, aprakstā, shēmā, anotācijā, autentifikācijas metodē vai UI resursā: atkārtoti izvieto vai restartē serveri, atver savienojumu vietnē chatgpt.com/plugins, atlasī Refresh, pārbaudi, vai reklamētie metadati ir mainījušies, un atkārto attiecīgos testus jaunā sarunā. Šī atsvaidzināšana attiecas uz tieši pieslēgtiem serveriem; publicētam spraudnim rīku atjauninājumi ietilpst nepārtrauktā pārskatīšanā (11. nodarbība).

Pirms iepakošanas pārbaudi, vai rīku saraksts atbilst reklamētajām iespējām, vai strukturēti rezultāti atbilst izejas shēmām, vai autentifikācijas kļūmes atgriež noderīgas kļūdas, vai pareizie uzvedumi aktivizē pareizos rīkus, bet nepareizie neaktivizē nevienu, un vai UI tiek attēlots bez konsolas kļūdām, vienlaikus pareizi atjaunojot tā stāvokli.

Pilns spraudnis

Kad serveris ir gatavs — vai arī uzreiz spraudnim, kas sastāv tikai no prasmēm — iepako spraudni (10. nodarbība), pievieno to lokālajam tirgum, instalē to no spraudņu direktorija un pēc tam atkārto pieprasījumus no savu lietojumu gadījumu inventāra: tiešus, netiešus, turpinājuma, negatīvus un tīši izslēgtus robežgadījumus. Pārbaudi, vai spraudnis ievēro prasmju instrukcijas, izmanto pareizos resursus, pabeidz katru soli un rada noderīgu rezultātu; vai prasmes izsauc pareizos rīkus; un vai autentifikācija darbojas pēc instalēšanas.

Diagnosticē pa slāņiem

Kad kaut kas noiet greizi, sāc ar kļūdainā slāņa izolēšanu: serveris, komponente vai ChatGPT klients.

SimptomsVirziens
Nav uzskaitītu rīkuVai serveris darbojas? Vai adrese beidzas ar /mcp?
Strukturēti dati, bet nav komponentesVai rīks ietver _meta.ui.resourceUri, kas norāda uz reģistrētu resursu ar tipu text/html;profile=mcp-app, kas ielādējas bez CSP kļūdām?
Shēmas kļūdasVai tavi Python vai TypeScript modeļi atbilst reklamētajai outputSchema?
Lēna komponenteVai rīku izsaukumi pārsniedz dažus simtus milisekunžu? Veic profilēšanu un kešatmiņu.
Komponente neielādējasPārlūka konsole: CSP pārkāpums, nepilnīga pakotne?
Zudis stāvoklis (velc un nomet, rediģēšana)Pēc katras atjaunināšanas izsauc window.openai.setWidgetState un atjauno no window.openai.widgetState pie montāžas.
Izklājums bojāts mobilajās ierīcēsNolasī window.openai.displayMode un window.openai.maxHeight; izvairies no fiksētiem augstumiem un darbībām, reaģējot uz peles kursora novietošanu.
Rīks nekad netiek atlasītsPārraksti aprakstu formātā “Izmanto, kad…”, pārskati sākuma uzvedumus.
Atlasīts nepareizs rīksPrecizē blakus esošos rīkus, norādi izslēgtos gadījumus, sadali pārāk plašus rīkus.
401 kļūdasAtbildē iekļauj WWW-Authenticate; pārbaudi izdevēju un auditoriju.
invalid_client esošam savienojumamVai reģistrētais OAuth klients joprojām eksistē? Atjauno to, nevis izveido jaunu.
ngrok tunelis beidzasRestartē to, pārbaudi, vai lokālais serveris darbojas; ražošanas vidē izmanto stabilu mitināšanu ar veselības zondēm.
Straumēšana pārtraukta aiz starpniekserveraSlodzes līdzsvarotājam vai CDN ir jālaiž HTTP straumēšana cauri bez buferizācijas.

Ja problēma saglabājas, savāc servera žurnālus, komponentes konsoli, rīku izsaukumu transkriptu un ekrānuzņēmumus. Pieraksti izmantoto uzvedumu un nosūti visu savam kontaktam pie OpenAI.

Galvenās atziņas

  • Testē pa slāņiem: vispirms serveri atsevišķi (Inspector, pēc tam ChatGPT), tad pilnu spraudni
  • Izveido novērtēšanas kopu: tiešus, netiešus, turpinājuma, rakstīšanas un ārpus darbības jomas esošus pieprasījumus
  • API Playground parāda neapstrādātu MCP apmaiņu
  • Pēc katrām metadatu izmaiņām veic Refresh un pēc tam sāc jaunu sarunu
  • Ja rodas problēmas, vispirms izolē slāni: serveri, komponenti vai klientu