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

Arkitettura: Għodod, Riżorsi, u Interfaċċa

Lezzjoni 2 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ħarsa Ġenerali
  2. X’Jesponi Server MCP
  3. Il-Fluss tat-Talba
  4. Trasport u Awtorizzazzjoni
  5. L-Interfaċċa: Saff Opzjonali
  6. Skills: Is-Saff tal-Fluss tax-Xogħol
  7. X’inhu dwar il-Kummerċ?
  8. Punti Ewlenin

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:

  1. Il-klijent jiskopri l-għodod esposti mis-server MCP.
  2. Il-mudell jagħżel għodda u jipprovdi argumenti li jikkonformaw mal-iskema ta’ input tagħha.
  3. Is-server jivvalida t-talba, iwettaq l-operazzjoni u jirritorna riżultat.
  4. 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