Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ittestjar u Diżbuggjar

Lezzjoni 9 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ittestja f’saffi
  2. Is-server MCP
  3. Il-plugin sħiħ
  4. Dijanjostika skont is-saff
  5. Punti Ewlenin

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.

SintomuTraċċa
L-ebda għodda elenkataIs-server qed jaħdem? L-indirizz jispiċċa b’/mcp?
Dejta strutturata, iżda l-ebda komponentL-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-iskemaIl-mudelli Python jew TypeScript tiegħek jaqblu mal-outputSchema irreklamat?
Komponent bil-modIs-sejħiet tal-għodod jaqbżu ftit mijiet ta’ millisekondi? Agħmel profil u cache.
Il-komponent jonqos milli jitgħabbaConsole 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 mobbliAqra window.openai.displayMode u window.openai.maxHeight; evita għoli fiss u azzjonijiet tal-hover.
Għodda qatt magħżulaIkteb mill-ġdid id-deskrizzjoni bħala “Uża meta…”, irrevedi l-prompts tal-bidu.
Għodda ħażina magħżulaIċċara l-għodod tal-madwar, speċifika każijiet esklużi, qasam għodod wiesgħa wisq.
Żbalji 401Inkludi WWW-Authenticate fir-rispons; ivverifika l-emittent u l-udjenza.
invalid_client fuq konnessjoni eżistentiIl-klijent OAuth irreġistrat għadu jeżisti? Irrestawrah minflok ma toħloq wieħed ġdid.
Il-mina ngrok tiskadiErġa’ startaha, ivverifika li s-server lokali qed jaħdem; fil-produzzjoni, uża hosting stabbli b’sondi tas-saħħa.
Streaming miksur wara proxyIl-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