Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Apps SDK:sta ChatGPT-lisäosiin

Oppitunti 1 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Mikä on lisäosa?
  2. Entä “Apps SDK”?
  3. Neljä mahdollista muotoa
  4. Missä lisäosa suoritetaan
  5. Mitä rakennat
  6. Keskeiset asiat

Kurssi kirjoitettu uudelleen 3. marraskuuta 2026 OpenAI:n Plugins-dokumentaation pohjalta. Edellinen versio perustui olemattomaan @openai/apps-sdk-pakettiin (joka sisälsi defineAction, defineWidget ja chatgpt-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ää.

MuotoValitse tämä, kun
Vain taidotOlemassa olevat ohjeet ja työkalut riittävät työnkulun hallintaan
Vain MCP-palvelinLisäosa tarvitsee MCP-työkaluja, mutta ei lisäohjeita työnkululle
Taidot ja MCP-palvelinTaitojen 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