Arkitettura: Għodod, Riżorsi, u Interfaċċa
F'din il-paġna
Lezzjon miktub mill-ġdid fit-3 ta’ Novembru 2026 ibbażat fuq il-paġni MCP server, Plugin architecture, u Skills fid-dokumentazzjoni tal-OpenAI Plugins. L-arkitettura antika ta’ “actions, widgets, commerce” kienet tiddeskrivi SDK li ma jeżistix aktar. Sorsi: MCP server · Plugin architecture · Skills.
Ħarsa Ġenerali
Plugin jikkonsisti f’saffi indipendenti. Is-Skills jipprovdu l-pjan ta’ azzjoni, is-server MCP jipprovdi l-kapaċitajiet, u l-interfaċċa tipprovdi mod viżwali biex tinteraġixxi meta jkun meħtieġ.
Plugin
├── Skills
└── MCP Server (opzjonali)
├── Għodod u riżultati strutturati
└── Riżorsi tal-interfaċċa (opzjonali)
Kull saff għandu rwol distint. Id-dokumentazzjoni tissintetizza l-fruntiera hekk: is-server MCP jipprovdi d-data, l-awtentikazzjoni, l-awtorizzazzjoni u l-azzjonijiet; is-skill tipprovdi istruzzjonijiet riutilizzabbli, eżempji u mudelli ta’ dokumenti.
X’Jesponi Server MCP
Server MCP jista’ jesponi erba’ tipi ta’ entitajiet:
- Għodod (Tools): Funzjonijiet li l-mudell isejjaħ b’inputs strutturati.
- Riżorsi: Data jew kontenut li l-klijent jista’ jaqra.
- Prompts: Mudelli ta’ prompt riutilizzabbli.
- Istruzzjonijiet: Direttivi li japplikaw għas-server kollu.
Il-plugins jiddependu primarjament fuq l-għodod. Kull għodda għandha isem, deskrizzjoni, skema ta’ input u, opzjonalment, skema ta’ output. Dawn il-kampi jippermettu lill-mudell jiddeċiedi meta jsejjaħ l-għodda u kif juża r-riżultat tagħha.
Il-Fluss tat-Talba
Meta utent jagħmel talba li taqbel ma’ għodda, iseħħu erba’ passi f’sekwenza:
- Il-klijent jiskopri l-għodod esposti mis-server MCP.
- Il-mudell jagħżel għodda u jipprovdi argumenti li jikkonformaw mal-iskema ta’ input tagħha.
- Is-server jivvalida t-talba, iwettaq l-operazzjoni u jirritorna riżultat.
- Il-mudell juża dak ir-riżultat biex ikompli l-konversazzjoni.
Riżultat ta’ għodda jista’ jkollu tliet partijiet. structuredContent iġorr data konċiża li l-mudell jista’ jispezzjona u jerġa’ juża f’sejħiet sussegwenti. content iġorr test jew kontenut MCP ieħor li jgħin lill-mudell jifformula tweġiba. _meta iġorr data maħsuba għall-klijent u moħbija mill-mudell—moħbija, iżda mhux protetta. Dan il-qasam ma jissostitwixxix l-awtorizzazzjoni jew il-ħażna sigura.
Trasport u Awtorizzazzjoni
Fil-produzzjoni, iddispjega server MCP f’indirizz HTTPS stabbli billi tuża t-trasport streamable HTTP tal-protokoll, tipikament fuq path /mcp. Jekk l-għodod jaqraw data privata jaġixxu f’isem utent, ipproteġi s-server bil-fluss ta’ awtorizzazzjoni definit mill-ispeċifikazzjoni MCP—OAuth, li l-Lezzjoni 8 tiddettalja.
L-Interfaċċa: Saff Opzjonali
Għodda trid taħdem mingħajr interfaċċa: test konċiż u riżultat strutturat spiss ikunu biżżejjed biex il-mudell jirrispondi. Interfaċċa tagħmel sens meta l-utent jeħtieġ li jispezzjona, iqabbel, jimmodifika, jikkonferma jew jibbrawżja informazzjoni strutturata—paragun ta’ prodotti, skeda editjabbli, jew mappa. Verifika sempliċi tal-istatus ġeneralment ma teħtiġx waħda.
Meta tkun preżenti, l-interfaċċa hija riżorsa li s-server jiddikjara. ChatGPT juriha f’iframe meta l-għodda assoċjata tirritornaha. ChatGPT jimplimenta l-istandard miftuħ tal-MCP Apps: l-interfaċċa tikkomunika mal-host permezz ta’ JSON-RPC bl-użu ta’ postMessage. Estensjonijiet speċifiċi għal ChatGPT, aċċessibbli permezz ta’ window.openai, jissupplimentaw l-istandard meta dan ma jkoprix ħtieġa speċifika. Il-Lezzjoni 6 tkopri dan.
Skills: Is-Saff tal-Fluss tax-Xogħol
Skill hija folder li fiha fajl SKILL.md—isem, deskrizzjoni li tgħid lill-mudell meta għandu jikkunsidrah, istruzzjonijiet—u, jekk ikun meħtieġ, referenzi, scripts jew mudelli. Il-mudell inizjalment jara biss l-isem u d-deskrizzjoni; jitgħabbi l-istruzzjonijiet sħaħ meta t-talba taqbel mas-skill jew meta l-utent isejjaħha direttament. Għalhekk il-parir ta’ OpenAI: ikteb id-deskrizzjoni madwar l-għan tal-utent u l-kundizzjonijiet ta’ attivazzjoni, u żomm id-dettalji pass pass fil-korp.
X’inhu dwar il-Kummerċ?
Il-bejgħ permezz ta’ plugin mhuwiex saff separat. Huwa vjaġġ li l-interfaċċa opzjonali tista’ tappoġġja, billi tisfrutta l-Checkout API ddokumentat minn OpenAI. Il-Lezzjoni 7 tispjega kif taħdem u l-limitazzjonijiet tagħha.
Punti Ewlenin
- Server MCP jesponi għodod, riżorsi, prompts u istruzzjonijiet; il-plugins jiddependu primarjament fuq l-għodod
- Riżultat ta’ għodda jgħaqqad
structuredContent,content, u_meta(moħbi mill-mudell, iżda mhux sigur) - Produzzjoni: HTTPS stabbli, trasport streamable HTTP, awtorizzazzjoni skont l-ispeċifikazzjoni MCP
- L-interfaċċa hija riżorsa opzjonali murija minn ChatGPT skont l-istandard tal-MCP Apps
- Is-Skills jimmaniġġjaw il-fluss tax-xogħol; is-server jimmaniġġja d-data, l-awtorizzazzjoni u l-azzjonijiet