Ittestjar u Diżbuggjar
Lezzjon miktub mill-ġdid fit-3 ta’ Novembru 2026 ibbażat fuq il-paġni Connect and test your plugin u Troubleshooting mid-dokumentazzjoni tal-Plugins ta’ OpenAI. Il-”development playground” ta’ qabel u l-kumandi tiegħu kienu jappartjenu għall-SDK inesistenti mill-ewwel verżjoni ta’ dan il-kors. Sorsi: Connect and test · Troubleshooting.
Ittestja f’saffi
OpenAI tirrakkomanda li tittestja kull kapaċità qabel ma tiddispjega l-plugin installat kollu: l-ewwel is-server MCP awtonomu konness ma’ ChatGPT, imbagħad il-plugin ippakkjat bil-ħiliet tiegħu. Żomm il-prompts ta’ evalwazzjoni tiegħek u r-riżultati tagħhom matul l-iżvilupp biex tkun tista’ tqabbel l-imġiba bejn il-verżjonijiet.
Is-server MCP
Ipprepara l-endpoint
Qabel ma tittestja f’ChatGPT, ivverifika li s-server huwa aċċessibbli permezz ta’ HTTPS pubbliku—jew permezz ta’ Secure MCP Tunnel—li jikkomunika b’streamable HTTP (tipikament fuq /mcp), li l-ismijiet tal-għodod, id-deskrizzjonijiet, l-iskemi u l-annotazzjonijiet huma preżenti, u li s-sejbien tal-awtentikazzjoni jaħdem għall-għodod li jeħtieġu kont. Mina ta’ żvilupp hija tajba għal provi, iżda mhux għas-sottomissjoni.
Spezzjona
L-MCP Inspector isejjaħ l-għodod tiegħek direttament, mingħajr mudell:
npx @modelcontextprotocol/inspector@latest
Għaddi kull għodda mill-provi kollha: inputs rappreżentattivi, każijiet limitu, kredenzjali nieqsa, u riżultati vojta. Iċċekkja l-validazzjoni tal-iskema, l-iżbalji tal-awtentikazzjoni, l-annotazzjonijiet, l-imġiba tal-konferma, u l-output li jista’ jinqara mill-mudell.
Evalwa l-għażla tal-għodda
Ladarba s-server ikun konness bħala plugin personali (Lezzjoni 4), installah, iftaħ konversazzjoni ġdida, ikteb @, u agħżlu. Ibni sett ta’ evalwazzjoni li fih:
- Talbiet diretti li għandhom jattivaw għodda speċifika;
- Talbiet indiretti li jesprimu l-istess għan b’mod differenti;
- Talbiet ta’ segwitu li jerġgħu jużaw identifikaturi miksuba qabel;
- Operazzjonijiet ta’ kitba li jeħtieġu awtorizzazzjoni jew konferma;
- Talbiet barra mill-ambitu li m’għandhomx jattivaw l-ebda għodda.
Għal kull wieħed, irrekordja l-għodda magħżula, l-argumenti tagħha, ir-riżultat, kwalunkwe żball, u l-imġiba tal-konferma. Erġa’ ġib is-sett kollu kull darba li tbiddel isem, deskrizzjoni, skema jew annotazzjoni. Jekk is-server jirritorna komponent UI, ittestja kemm il-komponent innifsu kif ukoll ir-riżultat li jista’ jinqara mill-mudell.
Ara l-iskambji raw
Biex taqra t-talbiet u r-risposti sħaħ, il-API Playground jaċċetta server MCP: mur fuq Tools → Add → MCP Server, daħħal l-indirizz HTTPS, konnettja, imbagħad ġġib il-prompts tat-test tiegħek.
Aġġorna l-metadejta
Wara kwalunkwe bidla f’isem, deskrizzjoni, skema, annotazzjoni, metodu ta’ awtentikazzjoni, jew riżorsa UI: erġa’ ddispjega jew erġa’ starta s-server, iftaħ il-konnessjoni fuq chatgpt.com/plugins, agħżel Refresh, ivverifika li l-metadejta rreklamata nbidlet, u erġa’ ġib it-testijiet rilevanti f’konversazzjoni ġdida. Dan l-aġġornament japplika għas-servers konnessi direttament; għal plugin ippubblikat, l-aġġornamenti tal-għodod jaqgħu taħt reviżjoni kontinwa (Lezzjoni 11).
Qabel l-ippakkjar, ivverifika li l-lista tal-għodod taqbel mal-kapaċitajiet irreklamati, li r-riżultati strutturati jikkonformaw mal-iskemi tal-output, li l-fallimenti tal-awtentikazzjoni jirritornaw żbalji utli, li l-prompts it-tajba jattivaw l-għodod it-tajba filwaqt li dawk ħżiena ma jattivaw l-ebda waħda, u li l-UI tirrendi mingħajr żbalji fil-console filwaqt li tirrestawra b’mod korrett l-istat tagħha.
Il-plugin sħiħ
Ladarba s-server ikun lest—jew immedjatament għal plugin li jikkonsisti biss minn ħiliet—ippakkja l-plugin (Lezzjoni 10), żiduh f’suq lokali, installah mid-direttorju tal-plugins, imbagħad erġa’ ġib it-talbiet mill-inventarju tal-każijiet ta’ użu tiegħek: diretti, indiretti, ta’ segwitu, negattivi, u każijiet limitu esklużi intenzjonalment. Iverifika li l-plugin isegwi l-istruzzjonijiet tal-ħiliet, juża r-riżorsi korretti, jikkompleta kull pass, u jipproduċi riżultat utli; li l-ħiliet isejħu l-għodod korretti; u li l-awtentikazzjoni taħdem wara l-installazzjoni.
Dijanjostika skont is-saff
Meta xi ħaġa tmur ħażin, ibda billi tiżola s-saff difettuż: server, komponent, jew klijent ChatGPT.
| Sintomu | Traċċa |
|---|---|
| L-ebda għodda elenkata | Is-server qed jaħdem? L-indirizz jispiċċa b’/mcp? |
| Dejta strutturata, iżda l-ebda komponent | L-għodda tinkludi _meta.ui.resourceUri li jipponta għal riżorsa rreġistrata tat-tip text/html;profile=mcp-app li titgħabba mingħajr żbalji CSP? |
| Żbalji fl-iskema | Il-mudelli Python jew TypeScript tiegħek jaqblu mal-outputSchema irreklamat? |
| Komponent bil-mod | Is-sejħiet tal-għodod jaqbżu ftit mijiet ta’ millisekondi? Agħmel profil u cache. |
| Il-komponent jonqos milli jitgħabba | Console tal-browser: ksur ta’ CSP, bundle mhux komplut? |
| Stat mitluf (drag-and-drop, editing) | Sejjaħ window.openai.setWidgetState wara kull aġġornament u rrestawra minn window.openai.widgetState waqt il-mount. |
| Layout miksur fuq mobbli | Aqra window.openai.displayMode u window.openai.maxHeight; evita għoli fiss u azzjonijiet tal-hover. |
| Għodda qatt magħżula | Ikteb mill-ġdid id-deskrizzjoni bħala “Uża meta…”, irrevedi l-prompts tal-bidu. |
| Għodda ħażina magħżula | Iċċara l-għodod tal-madwar, speċifika każijiet esklużi, qasam għodod wiesgħa wisq. |
| Żbalji 401 | Inkludi WWW-Authenticate fir-rispons; ivverifika l-emittent u l-udjenza. |
invalid_client fuq konnessjoni eżistenti | Il-klijent OAuth irreġistrat għadu jeżisti? Irrestawrah minflok ma toħloq wieħed ġdid. |
| Il-mina ngrok tiskadi | Erġa’ startaha, ivverifika li s-server lokali qed jaħdem; fil-produzzjoni, uża hosting stabbli b’sondi tas-saħħa. |
| Streaming miksur wara proxy | Il-load balancer jew il-CDN iridu jgħaddu l-HTTP streaming mingħajr buffering. |
Jekk il-problema tkompli, iġbor il-logs tas-server, il-console tal-komponent, transkrizzjoni tas-sejħiet tal-għodod, u screenshots. Innota l-prompt użat u ibgħat kollox lill-kuntatt tiegħek f’OpenAI.
Punti Ewlenin
- Ittestja f’saffi: is-server waħdu (Inspector, imbagħad ChatGPT), imbagħad il-plugin sħiħ
- Ibni sett ta’ evalwazzjoni: talbiet diretti, indiretti, ta’ segwitu, ta’ kitba, u barra mill-ambitu
- L-API Playground juri skambji MCP raw
- Refresh wara kull bidla fil-metadejta, imbagħad ibda konversazzjoni ġdida
- Meta jinqalgħu problemi, iżola s-saff l-ewwel: server, komponent, jew klijent