Apps SDK:sta ChatGPT-lisäosiin
Tällä sivulla
Kurssi kirjoitettu uudelleen 3. marraskuuta 2026 OpenAI:n Plugins-dokumentaation pohjalta. Edellinen versio perustui olemattomaan
@openai/apps-sdk-pakettiin (joka sisälsidefineAction,defineWidgetjachatgpt-app.json-manifestin). Nyt rakennat ChatGPT-sovelluksia käyttämällä MCP-protokollaa, sen virallisia SDK-kirjastoja ja MCP Apps -rajapintastandardia. Olemme kirjoittaneet uudelleen kaikki neljätoista oppituntia ja poistaneet vanhan version tukemattomat yhteensopivuusluettelot, palkkiorakenteet ja julkaisuvaiheet. Lähteet: Quickstart · Plugin architecture.
Mikä on lisäosa?
Lisäosa on paketti, jonka löydät, asennat, jaat ja julkaiset ChatGPT:ssä ja Codexissa. Se laajentaa avustajan toimintakykyä tarjoamalla uutta tietämystä, työkaluja tai molempia. OpenAI:n dokumentaatio tunnistaa neljä rakennuspalikkaa:
- Taidot (Skills), jotka antavat mallille ohjeet ja resurssit toistuvien työnkulkujen hallintaan;
- MCP-palvelin, joka tarjoaa työkaluja ja yhdistää avustajan ulkoisiin järjestelmiin – APIisi, tietokantaasi tai palveluusi;
- Molemmat, kun malli tarvitsee sekä toimintaohjeet että infrastruktuurisi tarjoamat valmiudet;
- Elinkaarikoukut (Lifecycle hooks), komentoja, jotka suoritetaan tietyissä vaiheissa Codexin ajoaikaympäristössä, mukaan lukien ChatGPT Workissa.
ChatGPT ja Codex jakavat saman lisäosahakemiston: julkinen lisäosa julkaistaan kerran, ja se tulee näkyviin molempien tuotteiden yhteensopivissa käyttöliittymissä. Jotkin ominaisuudet ovat kuitenkin käyttöliittymäkohtaisia – esimerkiksi koukkuskriptin on oltava olemassa ajoaikaympäristössä, joten lisäosan asentaminen verkkoversioon ei automaattisesti ota sitä käyttöön siellä.
Entä “Apps SDK”?
Tämä termi viittaa OpenAI:n työkalupakkiin sovellusten rakentamiseksi ChatGPT:n sisälle: MCP-protokolla ja sen viralliset SDK-kirjastot, avoin MCP Apps -standardi, jonka ChatGPT toteuttaa käyttöliittymien renderöintiin, ChatGPT-kohtaiset laajennukset, suunnittelujärjestelmä (@openai/apps-sdk-ui) ja esimerkkivarasto. Dokumentaatio ryhmittelee nämä nyt nimikkeelle “ChatGPT-lisäosat ja Apps SDK”: sovellus keskittyy MCP-palvelimeen, sisältää valinnaisen käyttöliittymän ja jakautuu osana lisäosaa.
MCP:n valinta on harkittu. Model Context Protocol on avoin eritelmä tekoälyasiakkaiden yhdistämiseksi työkaluihin ja dataan. ChatGPT:tä varten kirjoittamasi palvelin puhuu protokollaa, jota muut isännät ymmärtävät, ja MCP Apps -standardin mukainen käyttöliittymä toimii missä tahansa kyseisen standardin tukevassa isännässä.
Neljä mahdollista muotoa
Aloita pienimmästä muodosta, joka kattaa käyttötapauksesi; voit lisätä palvelimen tai käyttöliittymän myöhemmin muuttamatta lisäosan ydintehtävää.
| Muoto | Valitse tämä, kun |
|---|---|
| Vain taidot | Olemassa olevat ohjeet ja työkalut riittävät työnkulun hallintaan |
| Vain MCP-palvelin | Lisäosa tarvitsee MCP-työkaluja, mutta ei lisäohjeita työnkululle |
| Taidot ja MCP-palvelin | Taitojen on ohjattava mallia työnkulkuissa, jotka käyttävät työkalujasi |
| MCP-palvelin käyttöliittymällä | Visuaalinen vuorovaikutus parantaa merkittävästi osaa työnkulusta |
Lisäosa, joka laatii kokousmuistioita yrityksesi sääntöjen mukaan, saattaa tarvita vain taitoja. Heti kun sen on luettava elävää dataa, tunnistettava käyttäjä tai toimittava ylläpitämäsi järjestelmän sisällä, se vaatii MCP-palvelimen. Lopuksi, käyttöliittymä ei ole koskaan pakollinen: työkalun on pysyttävä hyödyllisenä ilman sitäkin.
Missä lisäosa suoritetaan
ChatGPT:ssä käynnistät asennetun lisäosan suoraan kirjoittamalla syöttökenttään @ ja valitsemalla sen. Malli voi myös kutsua sitä automaattisesti, kun pyyntö vastaa sen työkaluja tai taitoja. OpenAI:n pikaopas suosittelee ensimmäisen lisäosan testaamista ChatGPT Workissa, joka on ChatGPT:n verkkosivuston etusivun Work-välilehti. Samat lisäosat näkyvät Codexissa, kunkin käyttöliittymän erityisominaisuuksien rajoittamina.
Mitä rakennat
Tämä kurssi seuraa dokumentaatiossa hahmoteltua polkua. Aloitat määrittelemällä työkalusi käyttäjätarpeiden perusteella, yhdistät ensimmäisen MCP-palvelimen ChatGPT:hen ja rakennat sen jälkeen oman kokonaisuutesi: hyvin dokumentoidut työkalut, MCP Apps -käyttöliittymän sinne, missä se tuottaa lisäarvoa, OAuth-tunnistautumisen yksityiselle datalle ja, jos liiketoimintamallisi sopii yhteen, ostotapahtuman Checkout API:n avulla. Viimeistelet kurssin pakkaamiseen, julkaisusääntöihin ja hakemistoon lähettämiseen.
Keskeiset asiat
- Lisäosa yhdistää taitoja, MCP-palvelimen tai molemmat; käyttöliittymä on valinnainen
- ChatGPT ja Codex jakavat saman lisäosahakemiston
- “Apps SDK” viittaa OpenAI:n työkaluihin sovellusten rakentamiseen: MCP, MCP Apps -standardi, ChatGPT-laajennukset ja suunnittelujärjestelmä
@openai/apps-sdk-pakettia ei ole olemassa: aloita virallisilla MCP SDK-kirjastoilla- Valitse pienin lisäosan muoto, joka kattaa käyttötapauksesi