Arhitektuur: tööriistad, ressursid ja liides
Sellel lehel
Õppetund kirjutati 3. novembril 2026 ümber, tuginedes OpenAI pistikprogrammide dokumentatsiooni lehtedele MCP server, Plugin architecture ja Skills. Kirjeldatud aegunud „tegevuste, vidinate ja kaubanduse“ arhitektuur põhines SDK-l, mida enam ei eksisteeri. Allikad: MCP server · Plugin architecture · Skills.
Ülevaade
Pistikprogramm koosneb sõltumatutest kihtidest. Oskused (Skills) pakuvad tegevuskava, MCP server võimaldab funktsionaalsust ja liides pakub vajadusel visuaalset suhtlusviisi.
Plugin
├── Skills
└── MCP Server (valikuline)
├── Tööriistad ja struktureeritud tulemused
└── Liidese ressursid (valikuline)
Igal kihil on oma kindel roll. Dokumentatsioon võtab piiritluse kokku nii: MCP server pakub andmeid, autentimist, autoriseerimist ja tegevusi; oskus pakub taasrakendatavaid juhiseid, näiteid ja dokumendimalle.
Mida MCP server avalikustab
MCP server võib avalikustada nelja tüüpi üksusi:
- Tööriistad: Funktsioonid, mida mudel kutsub struktureeritud sisenditega.
- Ressursid: Andmed või sisu, mida klient saab lugeda.
- Sisendid (Prompts): Taaskasutatavad sisendimallid.
- Juhised: Direktiivid, mis kehtivad kogu serveri kohta.
Pistikprogrammid tuginevad peamiselt tööriistadele. Igal tööriistal on nimi, kirjeldus, sisendskeem ja vajadusel väljundskeem. Need väljad võimaldavad mudelil otsustada, millal tööriista kutsuda ja kuidas selle tulemust kasutada.
Päringu voog
Kui kasutaja teeb päringu, mis vastab mõnele tööriistale, toimub järjestikku neli sammu:
- Klient avastab MCP serveri poolt avalikustatud tööriistad.
- Mudel valib tööriista ja esitab argumendid, mis vastavad selle sisendskeemile.
- Server valideerib päringu, teostab toimingu ja tagastab tulemuse.
- Mudel kasutab seda tulemust vestluse jätkamiseks.
Tööriista tulemus võib koosneda kolmest osast. structuredContent kannab kokkuvõtlikke andmeid, mida mudel saab kontrollida ja hilisemates kutsetes uuesti kasutada. content kannab teksti või muud MCP-sisu, mis aitab mudelil vastust formuleerida. _meta kannab andmeid, mis on mõeldud kliendile ja peidetud mudeli eest – peidetud, kuid mitte kaitstud. See väli ei asenda autoriseerimist ega turvalist salvestust.
Transport ja autoriseerimine
Tootmiskeskkonnas paiguta MCP server stabiilsele HTTPS-aadressile, kasutades protokolli streamable HTTP transporti, tavaliselt rajal /mcp. Kui tööriistad loevad privaatseid andmeid või tegutsevad kasutaja nimel, kaitse serverit MCP spetsifikatsiooni määratletud autoriseerimisvoo abil – OAuth, mida käsitletakse üksikasjalikult 8. õppetunnis.
Liides: valikuline kiht
Tööriist peab töötama ilma liideseta: mudelile reageerimiseks piisab sageli lühikesest tekstist ja struktureeritud tulemusest. Liides on mõttekas siis, kui kasutaja peab struktureeritud teavet kontrollima, võrdlema, muutma, kinnitama või sirvima – näiteks toodete võrdlus, muudetav ajakava või kaart. Lihtne oleku kontrollimine ei vaja seda üldjuhul mitte.
Kui liides on olemas, on see ressurss, mille server deklareerib. ChatGPT kuvab seda iframe’is, kui seotud tööriist selle tagastab. ChatGPT rakendab avatud MCP Apps standardit: liides suhtleb hostiga JSON-RPC abil, kasutades postMessage. ChatGPT-spetsiifilised laiendused, mis on kättesaadavad window.openai kaudu, täiendavad standardit juhtudel, kui see konkreetset vajadust ei kata. Seda käsitletakse 6. õppetunnis.
Oskused: töövoo kiht
Oskus on kaust, mis sisaldab faili SKILL.md – nimi, kirjeldus, mis ütleb mudelile, millal seda arvesse võtta, juhised ning vajadusel viited, skriptid või mallid. Mudel näeb esialgu ainult nime ja kirjeldust; täielikud juhised laaditakse siis, kui päring vastab oskusele või kui kasutaja kutsub selle otse välja. Seetõttu soovitab OpenAI: kirjuta kirjeldus kasutaja eesmärgi ja käivitustingimuste ümber ning hoia samm-sammult üksikasjad põhiosas.
Kuidas on lood kaubandusega?
Müük pistikprogrammi kaudu ei ole eraldi kiht. See on teekond, mida valikuline liides saab toetada, kasutades OpenAI dokumenteeritud Checkout API-t. 7. õppetund selgitab, kuidas see toimib ja millised on selle piirangud.
Peamised punktid
- MCP server avalikustab tööriistad, ressursid, sisendid ja juhised; pistikprogrammid tuginevad peamiselt tööriistadele
- Tööriista tulemus ühendab
structuredContent,contentja_meta(peidetud mudeli eest, kuid mitte turvaline) - Tootmine: stabiilne HTTPS, streamable HTTP transport, autoriseerimine vastavalt MCP spetsifikatsioonile
- Liides on valikuline ressurss, mida ChatGPT kuvab vastavalt MCP Apps standardile
- Oskused haldavad töövoogu; server haldab andmeid, autoriseerimist ja tegevusi