Architektūra: įrankiai, ištekliai ir sąsaja
Šiame puslapyje
Pamoka perrašyta 2026 m. lapkričio 3 d. remiantis MCP serverio, Papildinių architektūros ir Įgūdžių puslapiais OpenAI papildinių dokumentacijoje. Senoji „veiksmų, valdiklių, prekybos“ architektūra apibūdino SDK, kuris nebeegzistuoja. Šaltiniai: MCP serveris · Papildinių architektūra · Įgūdžiai.
Apžvalga
Papildinį sudaro nepriklausomi sluoksniai. Įgūdžiai pateikia veiksmų planą, MCP serveris suteikia galimybes, o sąsaja prireikus užtikrina vizualinį bendravimo būdą.
Papildinys
├── Įgūdžiai
└── MCP serveris (nebūtinas)
├── Įrankiai ir struktūrizuoti rezultatai
└── Sąsajos ištekliai (nebūtini)
Kiekvienas sluoksnis atlieka skirtingą vaidmenį. Dokumentacija šią ribą apibendrina taip: MCP serveris teikia duomenis, autentifikavimą, autorizaciją ir veiksmus; įgūdis suteikia pakartotinai naudojamas instrukcijas, pavyzdžius ir dokumentų šablonus.
Ką atskleidžia MCP serveris
MCP serveris gali atskleisti keturių tipų subjektus:
- Įrankiai: Funkcijos, kurias modelis iškviečia naudodamas struktūrizuotas įvestis.
- Ištekliai: Duomenys arba turinys, kurį klientas gali nuskaityti.
- Užuominos (Prompts): Pakartotinai naudojami užuominų šablonai.
- Instrukcijos: Direktyvos, taikomos visam serveriui.
Papildiniai daugiausia remiasi įrankiais. Kiekvienas įrankis turi pavadinimą, aprašymą, įvesties schemą ir, jei reikia, išvesties schemą. Šie laukai leidžia modeliui nuspręsti, kada išsikviesti įrankį ir kaip panaudoti jo rezultatą.
Užklausos eiga
Kai vartotojas pateikia užklausą, atitinkančią įrankį, nuosekliai įvyksta keturi žingsniai:
- Klientas atranda MCP serverio atskleistus įrankius.
- Modelis pasirenka įrankį ir pateikia argumentus, atitinkančius jo įvesties schemą.
- Serveris patikrina užklausą, atlieka operaciją ir grąžina rezultatą.
- Modelis naudoja tą rezultatą tęsdamas pokalbį.
Įrankio rezultatas gali turėti tris dalis. structuredContent perduoda glaustus duomenis, kuriuos modelis gali patikrinti ir panaudoti vėlesniuose kvietimuose. content perduoda tekstą ar kitą MCP turinį, padedantį modeliui suformuluoti atsakymą. _meta perduoda duomenis, skirtus klientui ir paslėptus nuo modelio – paslėptus, bet neapsaugotus. Šis laukas nepakeičia autorizacijos ar saugyklos.
Transportas ir autorizacija
Gamybinėje aplinkoje diekite MCP serverį stabiliu HTTPS adresu naudodami protokolo streamable HTTP transportą, paprastai /mcp keliu. Jei įrankiai skaito privačius duomenis arba veikia vartotojo vardu, apsaugokite serverį MCP specifikacijoje nustatyta autorizacijos eiga – OAuth, kurią detaliai nagrinėsime 8 pamokoje.
Sąsaja: nebūtinas sluoksnis
Įrankis privalo veikti be sąsajos: glausto teksto ir struktūrizuoto rezultato dažnai pakanka, kad modelis atsakytų. Sąsaja prasminga tada, kai vartotojui reikia patikrinti, palyginti, modifikuoti, patvirtinti arba naršyti struktūrizuotą informaciją – pavyzdžiui, produktų palyginimą, redaguojamą grafiką ar žemėlapį. Paprastam būsenos tikrinimui jos paprastai nereikia.
Jei sąsaja egzistuoja, tai yra išteklius, kurį serveris deklaruoja. „ChatGPT“ ją rodo iframe lange, kai susijęs įrankis ją grąžina. „ChatGPT“ įgyvendina atvirą MCP Apps standartą: sąsaja su šeimininke bendrauja per JSON-RPC naudodama postMessage. „ChatGPT“ specifiniai plėtiniai, pasiekiami per window.openai, papildo standartą, kai jis neapima konkrečių poreikių. Tai nagrinėjama 6 pamokoje.
Įgūdžiai: darbo eigos sluoksnis
Įgūdis yra aplankas, kuriame yra SKILL.md failas – pavadinimas, aprašymas, nurodantis modeliui, kada jį svarstyti, instrukcijos ir, jei reikia, nuorodos, scenarijai ar šablonai. Iš pradžių modelis mato tik pavadinimą ir aprašymą; pilnas instrukcijas jis įkelia, kai užklausa atitinka įgūdį arba kai vartotojas jį iškviečia tiesiogiai. Todėl OpenAI pataria: aprašymą kurkite pagal vartotojo tikslą ir suaktyvinimo sąlygas, o žingsnis po žingsnio detales palikite pagrindinei daliai.
O kaip dėl prekybos?
Pardavimas per papildinį nėra atskiras sluoksnis. Tai kelionė, kurią gali palaikyti nebūtina sąsaja, naudojant OpenAI dokumentuotą Checkout API. 7 pamokoje paaiškinsime, kaip tai veikia ir kokios yra jo ribos.
Svarbiausi punktai
- MCP serveris atskleidžia įrankius, išteklius, užuominas ir instrukcijas; papildiniai daugiausia remiasi įrankiais
- Įrankio rezultatas sujungia
structuredContent,contentir_meta(paslėpta nuo modelio, bet nesaugu) - Gamyba: stabilus HTTPS, streamable HTTP transportas, autorizacija pagal MCP specifikaciją
- Sąsaja yra nebūtinas išteklius, kurį „ChatGPT“ rodo pagal MCP Apps standartą
- Įgūdžiai valdo darbo eigą; serveris valdo duomenis, autorizaciją ir veiksmus