Optimizacija: metapodatki, veščine in dogodki
Na tej strani
Lekcija je bila ponovno napisana 3. novembra 2026 na podlagi dokumentacije OpenAI za vtičnike Optimize Metadata, Build Skills, MCP Events in Plugin Extensions. Prejšnja različica te lekcije se je zanašala na modula
analyticsinexperimentiz neobstoječega SDK-ja. Viri: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Metapodatki so besedilo vašega izdelka
ChatGPT in Codex se odločita, kdaj poklicati vaša orodja, na podlagi metapodatkov, ki jih zagotovite. Dobro napisana imena, opisi in parametri zagotavljajo, da se vaše orodje sproži, ko je potrebno, in preprečujejo neželene sprožitve. OpenAI priporoča, da te metapodatke obravnavate kot besedilo izdelka: iterirajte jih, testirajte in merite njihovo uspešnost.
Referenčni nabor pozivov
Preden se dotaknete metapodatkov, sestavite označen nabor testnih pozivov:
- Neposredni pozivi, ki izrecno poimenujejo vaš izdelek ali vir podatkov.
- Posredni pozivi, ki opisujejo želeni rezultat brez imenovanja vašega orodja.
- Negativni pozivi, ki bi jih morala obravnavati vgrajena orodja ali drugi vtičniki.
Za vsak poziv dokumentirajte pričakovano vedenje: pokliči vaše orodje, ne stori ničesar ali prepusti drugo rešitev. Ta nabor uporabite za vsak test preprečevanja regresije.
Metapodatki, ki usmerjajo model
- Ime naj združuje domeno in dejanje, na primer
calendar.create_event. - Opis naj se začne z „Uporabi, ko…” in izrecno našteje izključene primere, na primer „Ne uporabi za opomnike.”
- Vsak parameter mora biti dokumentiran s primeri in seznamom dovoljenih vrednosti, če je vnos omejen.
- Opombe morajo odražati dejansko vedenje (glej lekciji 3 in 11).
Merjenje in nato iteracija
Povežite svoj strežnik, namestite vtičnik, zaženite svoj nabor pozivov in zabeležite, katero orodje je bilo izbrano, kateri argumenti so bili posredovani in ali je bila prikazana kakšna komponenta uporabniškega vmesnika. Spremljajte dva kazalnika: natančnost (ali je bilo poklicano pravo orodje?) in odzivnost (ali je bilo orodje poklicano vsakič, ko bi moralo biti?). Najprej ciljajte na visoko natančnost pri negativnih pozivih, preden lovite robne izboljšave v odzivnosti.
Spremenite samo eno polje naenkrat, da izolirate dejavnik, ki prispeva k izboljšanju. Vodite dnevnik revizij z datumi in rezultati ter pred uvedbo v proizvodno okolje naj spremembe pregleda nekdo drug. V proizvodnem okolju tedensko pregledujte uporabo orodij. Skok v potrditvah „napačno orodje” običajno signalizira drift metapodatkov. Zberite povratne informacije uporabnikov in redno ponovno zaženite teste pozivov, še posebej po dodajanju novega orodja ali spreminjanju strukturiranega polja.
Veščine za ponavljajoča se delovna opravila
Vaš strežnik zagotavlja podatke, avtentikacijo in nadzorovana dejanja. Veščina zagotavlja zaporedje klicev orodij, odločitvene točke, oblikovanje izhoda, primere in predloge. Najhitrejši način za začetek je uporaba vgrajenega @skill-creator, kjer opišete cilj uporabnika in orodja MCP, ki ga podpirajo.
Močna datoteka SKILL.md določa, katere korake slediti, kakšen rezultat naj uporabnik prejme, katerih dejstev model ne sme izmisliti, kdaj postaviti vprašanja, ustaviti ali zavrniti zahtevo ter katere datoteke uporabiti. Raje izberite osredotočeno veščino za specifičen delovni tok kot velik nabor razpršenih navodil. Razdelite delovne toke, ki se razlikujejo v sprožilcu, vhodih ali merilih uspeha. Ohranite SKILL.md jedrnat in podrobnosti shranite drugje: uporabite references/ za pravilnike, sheme in primere; assets/ za predloge za kopiranje ali transformacijo; in scripts/ za deterministične izračune – vendar le, če obstoječa navodila in orodja niso zadostna.
Če veščina temelji na strežniku MCP, to odvisnost deklarirajte v agents/openai.yaml. To omogoči orodje, vendar ne nadomešča potrebe po jasnih navodilih o tem, katera orodja uporabiti, v kakšnem vrstnem redu in kako ravnati z manjkajočimi ali dvoumnimi rezultati. Za GPT-6 Astra OpenAI svetuje pregled njihovih smernic za sledenje navodilom: odpravite nejasna ali protislovna navodila in izrecno določite, da imajo uporabnikova navodila prednost pred navodili veščine.
Preizkusite aktivacijo veščine in kakovost izhoda z uporabo neposrednih, posrednih, nepopolnih (ki bi morali sprožiti pojasnjevalno vprašanje), nepomembnih pozivov in pozivov za robne primere, kjer se mora veščina izogibati halucinacijam ali delovanju zunaj svojega obsega. Če se veščina aktivira ob napačnem času, popravite njen opis. Če izbere pravi delovni tok, vendar proizvaja nedosledne rezultate, popravite njena navodila.
Dogodki MCP: Odzivanje na spremembe
Dogodki MCP omogočajo ChatGPT, da se naroči na posodobitve z vašega strežnika, kot so nova sporočila, spremenjena vsebina ali spremembe stanja. Uporabnik izbere, kaj naj spremlja in kako naj ChatGPT reagira, ko prispe posodobitev – na primer: „Spremljaj ta dokument in uporabi popravke, zahtevane v komentarjih.”
- Vaš strežnik našteje dogodke, ki jih podpira.
- Uporabnik pove ChatGPT, kaj naj spremlja in kako naj reagira.
- ChatGPT se naroči prek vašega strežnika MCP in zagotovi URL povratnega klica ter tajni ključ za podpisovanje.
- Vaš strežnik pošlje ustrezne dogodke na ta URL.
- ChatGPT prejme dogodek v naročeni pogovorni seji in sledi uporabnikovim navodilom.
Ta funkcija je na voljo v pogovornih sejah ChatGPT Work na spletu in v namizni aplikaciji z izbrano možnostjo Cloud. ChatGPT se zanaša na dostavo spletnih kljuk, kot je opredeljeno v osnutku specifikacije dogodkov MCP. Vaš strežnik mora trajno hraniti naročila in biti zmožen doseči URL-je povratnih klicev prek HTTPS.
Razširitve vmesnika ChatGPT
Razširitve OpenAI MCP omogočajo vtičniku integracijo v ključna področja vmesnika ChatGPT: stransko vrstico, vnosno polje in pregledovalnike datotek. Omembe v vnosnem polju so na voljo le v namizni aplikaciji. OpenAI objavlja vzorčni vtičnik Bits & Bolts, ki prikazuje te razširitve in sledi njihovi uvedbi. To je najboljša izhodiščna točka za raziskovanje te zmožnosti.
Ključne ugotovitve
- Metapodatke obravnavajte kot besedilo izdelka: uporabite referenčni nabor pozivov, spremljajte natančnost in odzivnost ter spreminjajte eno polje naenkrat.
- Pišite opise, ki se začnejo z „Uporabi, ko…”, izrecno naštejte izključene primere in dokumentirajte vse parametre.
- Ustvarite eno osredotočeno veščino na delovni tok, ohranite
SKILL.mdjedrnat, vire shranite ločeno in deklarirajte odvisnosti MCP. - Dogodki MCP naročijo ChatGPT na posodobitve vašega strežnika, ki so dostavljene prek spletnih kljuk.
- Razširitve integrirajo vaš vtičnik v stransko vrstico, vnosno polje in pregledovalnike datotek.
Preverite svoje znanje
Od orodij MCP do objave: preverite, ali ste obvladali osnove.
1. Ali potrebujem paket `@openai/apps-sdk` za ustvarjanje aplikacije v ChatGPT?
Odgovor: Ne, ta paket ne obstaja. Strežnik MCP zgradite z uporabo uradnih SDK-jev za protokol (@modelcontextprotocol/sdk za TypeScript, mcp za Python), po želji dodate vmesnik, skladen s standardom MCP Apps, in celotno stvar distribuirate kot vtičnik.
2. Ali lahko orodje obstaja brez uporabniškega vmesnika?
Odgovor: Da, in tako bi moralo biti: orodje vrne structuredContent in kratek besedni povzetek, kar je za model dovolj. Uporabniški vmesnik, pripet prek _meta.ui.resourceUri, se doda le, kadar uporabnikom pomaga pri pregledovanju, primerjavi, urejanju, potrditvi ali navigaciji po informacijah.
3. Kdo odloča, ali ima uporabnik dovoljenje za dostop do podatkov?
Odgovor: Strežnik MCP odloča o vsaki zahtevi na podlagi preverjenega žetona OAuth (podpis, izdajatelj, ciljna publika, potek veljavnosti, obsegi). Opombe pomagajo ChatGPT izbrati ustrezno raven potrditve, vendar nikoli ne nadomeščajo avtorizacije na strani strežnika.
4. Ali lahko vtičnik prodaja naročnino na svojo storitev?
Odgovor: Ne. Pravila omejujejo trgovanje na fizično blago. Obstoječi naročnik se lahko prijavi in uporabi funkcije, vključene v njegov načrt. Vtičnik lahko pojasni, da funkcija ni vključena, in poveže na informativno stran, vendar se nikoli ne sme povezati na stran za plačilo.
5. Kako se orodja posodabljajo za objavljen vtičnik?
Odgovor: Brez nove datoteke ZIP: OpenAI ponovno pregleda strežnik in vsako novo ali spremenjeno orodje postane na voljo po opravljenih avtomatiziranih preverjanjih. Izbrisano orodje izgine takoj. Vendar pa metapodatki in veščine zahtevajo novo datoteko ZIP in nov pregled.
Dobro opisana orodja, izbirni uporabniški vmesniki, avtorizacija na strani strežnika in upoštevanje pravil: to je okvir, ki iz vtičnika naredi zanesljivo storitev v ChatGPT in Codex.