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

Optimoi: Metatiedot, taidot ja tapahtumat

Oppitunti 14 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Metatiedot ovat tuotetekstiä
  2. Toistuvien työnkulkujen taidot
  3. MCP-tapahtumat: Reagointi muutoksiin
  4. ChatGPT-käyttöliittymän laajennukset
  5. Keskeiset asiat
  6. Testaa tietämyksesi

Tunti kirjoitettu uudelleen 3. marraskuuta 2026 OpenAI Plugins -dokumentaation sivujen Optimize Metadata, Build Skills, MCP Events ja Plugin Extensions pohjalta. Tunnin edellinen versio perustui olemattoman SDK:n analytics- ja experiment-moduuleihin. Lähteet: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.

Metatiedot ovat tuotetekstiä

ChatGPT ja Codex päättävät työkalujesi kutsumisen tarjoamiesi metatietojen perusteella. Hyvin kirjoitetut nimet, kuvaukset ja parametrit varmistavat, että työkalusi kutsutaan tarvittaessa, ja estävät ei-toivotut käynnistykset. OpenAI suosittelee käsittelemään näitä metatietoja kuin tuotetekstiä: iteroi niitä, testaa ja mittaa niiden suorituskykyä.

Vertailukelpoinen kehotejoukko

Ennen kuin muokkaat metatietojasi, luo nimetty joukko testikehotteita:

  • Suorat kehotteet, jotka nimeävät tuotteesi tai tietolähteesi eksplisiittisesti.
  • Epäsuorat kehotteet, jotka kuvaavat haluttua lopputulosta nimeämättä työkaluasi.
  • Kielteiset kehotteet, jotka sisäänrakennettujen työkalujen tai muiden lisäosien tulisi hoitaa.

Dokumentoi jokaiselle kehotteelle odotettu käyttäytyminen: kutsu työkalusi, älä tee mitään tai siirrä vastuu toiselle ratkaisulle. Käytä tätä joukkoa jokaisessa regressiotestissä.

Mallia ohjaavat metatiedot

  • Nimen tulee yhdistää toimiala ja toiminto, kuten calendar.create_event.
  • Kuvauksen tulee alkaa sanoilla “Käytä, kun…” ja luetella eksplisiittisesti poissuljetut tapaukset, kuten “Älä käytä muistutuksiin.”
  • Jokainen parametri on dokumentoitava esimerkein ja sallittujen arvojen luettelolla, jos syöte on rajoitettu.
  • Huomautusten (annotations) tulee vastata todellista käyttäytymistä (katso tunnit 3 ja 11).

Mittaa, sitten iteroi

Yhdistä palvelimesi, asenna lisäosa, suorita kehotejoukkosi ja kirjaa ylös, mikä työkalu valittiin, mitä argumentteja välitettiin ja näytettiinkö mikään käyttöliittymäkomponentti. Seuraa kahta mittaria: tarkkuutta (kutsuttiinko oikea työkalu?) ja palautusta (kutsuttiinko työkalua joka kerta, kun se olisi pitänyt?). Pyri ensin korkeaan tarkkuuteen kielteisissä kehotteissa ennen kuin tavoittelet marginaalisia parannuksia palautuksessa.

Muuta vain yhtä kenttää kerrallaan eristääksesi parannuksen aiheuttajan. Pidä päivättyä revisiolokia tuloksineen ja pyydä jotakuta muuta tarkistamaan muutokset ennen käyttöönottoa. Tuotannossa tarkista työkalujen käyttöä viikoittain. Piikki “väärä työkalu” -varmistuksissa kertoo yleensä metatietojen ajautumisesta. Kerää käyttäjäpalautetta ja suorita kehottetestisi uudelleen säännöllisesti, erityisesti uuden työkalun lisäämisen tai rakenteellisen kentän muokkaamisen jälkeen.

Toistuvien työnkulkujen taidot

Palvelimesi tarjoaa dataa, todennusta ja hallittuja toimintoja. Taito tarjoaa työkalukutsujen sekvenssin, päätöspisteet, tulosteen muotoilun, esimerkit ja mallipohjat. Nopein tapa päästä alkuun on käyttää sisäänrakennettua @skill-creator-työkalua, jossa kuvaat käyttäjän tavoitteen ja sitä tukevat MCP-työkalut.

Vahva SKILL.md-tiedosto määrittää, mitä vaiheita seurataan, mitä tulosta käyttäjän tulee saada, mitä faktoja malli ei saa keksiä, milloin tulee kysyä kysymyksiä, lopettaa tai kieltäytyä, ja mitä tiedostoja tulee konsultoida. Suosi yhtä keskittynyttä taitoa tiettyä työnkulkua varten laajan joukon hajanaisia ohjeita sijaan. Jaa työnkulut, jotka eroavat käynnistimeltään, syötteiltään tai onnistumiskriteereiltään. Pidä SKILL.md ytimekkäänä ja tallenna yksityiskohdat muualle: käytä hakemistoa references/ käytännöille, skeemoille ja esimerkeille; assets/ mallipohjille, joita kopioidaan tai muunnetaan; ja scripts/ deterministisille laskutoimituksille – mutta vain, jos olemassa olevat ohjeet ja työkalut eivät riitä.

Jos taito riippuu MCP-palvelimesta, ilmoita tämä riippuvuus tiedostossa agents/openai.yaml. Tämä tekee työkalusta saatavilla, mutta ei korvaa tarvetta selkeille ohjeille siitä, mitä työkaluja käytetään, missä järjestyksessä ja miten puuttuvia tai epäselviä tuloksia käsitellään. GPT-6 Astraa varten OpenAI neuvoo tarkistamaan sen ohjeistuksen ohjeiden noudattamisesta: poista epäselvät tai ristiriitaiset direktiivit ja tee eksplisiittiseksi, että käyttäjän ohjeet ovat etusijalla suhteessa taito-ohjeisiin.

Testaa taidon aktivoitumista ja tulosteen laatua käyttämällä suoria, epäsuoria, epätäydellisiä (joiden tulisi laukaista tarkentava kysymys), aiheeseen kuulumattomia ja reunatapaus-kehotteita, joissa taidon on vältettävä hallusinaatioita tai toimimista oman scope-alueensa ulkopuolella. Jos taito aktivoituu väärään aikaan, korjaa sen kuvaus. Jos se valitsee oikean työnkulun mutta tuottaa epäjohdonmukaisia tuloksia, korjaa sen ohjeet.

MCP-tapahtumat: Reagointi muutoksiin

MCP Events mahdollistaa sen, että ChatGPT tilaa päivityksiä palvelimeltasi, kuten uusia viestejä, muokattua sisältöä tai tilamuutoksia. Käyttäjä valitsee, mitä seurataan ja miten ChatGPT:n tulee reagoida päivityksen saapuessa – esimerkiksi “Seuraa tätä dokumenttia ja soveltaa kommentteihin pyydettyjä korjauksia.”

  1. Palvelimesi luettelee tukemansa tapahtumat.
  2. Käyttäjä kertoo ChatGPT:lle, mitä seurataan ja miten reagoida.
  3. ChatGPT tilaa tapahtumat MCP-palvelimesi kautta tarjoamalla callback-URL:n ja allekirjoitusavaimen.
  4. Palvelimesi lähettää asiaankuuluvat tapahtumat kyseiseen URL-osoitteeseen.
  5. ChatGPT vastaanottaa tapahtuman tilatussa keskustelussa ja noudattaa käyttäjän ohjeita.

Tämä ominaisuus on saatavilla ChatGPT Work -keskusteluissa verkossa ja työpöytäsovelluksessa, kun Cloud on valittuna. ChatGPT luottaa webhook-toimitukseen, kuten MCP Events -spesifikaation luonnoksessa määritellään. Palvelimesi tulee pysyväistää tilaukset ja pystyä tavoittamaan callback-URL-osoitteet HTTPS:n yli.

ChatGPT-käyttöliittymän laajennukset

OpenAI MCP Extensions mahdollistaa lisäosan integroinnin ChatGPT-käyttöliittymän keskeisiin alueisiin: sivupalkkiin, syöttöalueeseen ja tiedostokatselimiin. Maininnat syöttöalueella ovat saatavilla vain työpöytäsovelluksessa. OpenAI julkaisee esimerkkilisäosan Bits & Bolts, joka demonstroi näitä laajennuksia ja seuraa niiden käyttöönottoa. Se on paras lähtökohta tämän kyvyn tutkimiseen.

Keskeiset asiat

  • Kohtele metatietoja tuotetekstinä: käytä vertailukelpoista kehotejoukkoa, seuraa tarkkuutta ja palautusta sekä muuta yhtä kenttää kerrallaan.
  • Kirjoita kuvaukset aloittaen sanoilla “Käytä, kun…”, listaa poissuljetut tapaukset eksplisiittisesti ja dokumentoi kaikki parametrit.
  • Luo yksi keskittynyt taito työnkulkua kohden, pidä SKILL.md ytimekkäänä, tallenna resurssit erikseen ja ilmoita MCP-riippuvuudet.
  • MCP Events tilaa ChatGPT:n palvelimesi päivityksiin, jotka toimitetaan webhookin kautta.
  • Laajennukset integroivat lisäosasi sivupalkkiin, syöttöalueeseen ja tiedostokatselimiin.

Testaa tietämyksesi

MCP-työkaluista julkaisuun: varmista, että hallitset perusteet.

1. Tarvitsenko `@openai/apps-sdk`-paketin luodakseni sovelluksen ChatGPT:hen?

Vastaus: Ei, kyseistä pakettia ei ole olemassa. Rakennat MCP-palvelimen virallisia protokolla-SDK:ita käyttäen (@modelcontextprotocol/sdk TypeScriptille, mcp Pythonille), lisäät valinnaisesti MCP Apps -standardin mukaisen käyttöliittymän ja jaat kokonaisuuden lisäosana.

2. Voiko työkalu olla olemassa ilman käyttöliittymää?

Vastaus: Kyllä, ja sen pitäisi olla: työkalu palauttaa structuredContent-sisällön ja lyhyen tekstiyhteenvedon, mikä riittää mallille. Käyttöliittymä, joka liitetään _meta.ui.resourceUri-avaimella, lisätään vain, kun se auttaa käyttäjiä tarkastelemaan, vertailemaan, muokkaamaan, vahvistamaan tai navigoimaan tietoja.

3. Kuka päättää, onko käyttäjällä lupa käyttää dataa?

Vastaus: MCP-palvelin päättää jokaisesta pyynnöstä varmennetun OAuth-tokenin (allekirjoitus, myöntäjä, kohde, vanheneminen, scope-oikeudet) perusteella. Huomautukset auttavat ChatGPT:tä valitsemaan sopivan vahvistustason, mutta ne eivät koskaan korvaa palvelinpuolen valtuutusta.

4. Voiko lisäosa myydä tilausta palveluunsa?

Vastaus: Ei. Säännöt rajoittavat kaupankäynnin fyysisiin hyödykkeisiin. Olemassa oleva tilaaja voi kirjautua sisään ja käyttää suunnitelmaansa sisältyviä ominaisuuksia. Lisäosa voi selittää, että ominaisuus ei sisälly tilaukseen, ja linkittää tietosivulle, mutta sen ei tule koskaan linkittää maksusivulle.

5. Miten työkalut päivittyvät julkaistulle lisäosalle?

Vastaus: Ilman uutta ZIP-tiedostoa: OpenAI skannaa palvelimen uudelleen, ja kaikki uudet tai muokatut työkalut tulevat saataville läpäistyään automatisoidut tarkistukset. Poistettu työkalu katoaa välittömästi. Metatiedot ja taidot vaativat kuitenkin uuden ZIP-tiedoston ja uuden tarkastuksen.

Hyvin kuvatut työkalut, valinnaiset käyttöliittymät, palvelinpuolen valtuutus ja sääntöjen noudattaminen: tämä on viitekehys, joka tekee lisäosasta luotettavan palvelun ChatGPT:ssä ja Codexissa.