Optimiziraj: Metapodatke, Vještine i Događaje
Na ovoj stranici
Lekcija je ponovno napisana 3. studenog 2026. na temelju stranica dokumentacije OpenAI Plugins Optimize Metadata, Build Skills, MCP Events i Plugin Extensions. Prethodna verzija ove lekcije oslanjala se na module
analyticsiexperimentiz nepostojećeg SDK-a. Izvori: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Metapodaci su tekst proizvoda
ChatGPT i Codex odlučuju kada će pozvati tvoje alate na temelju metapodataka koje dostaviš. Dobro napisani nazivi, opisi i parametri osiguravaju da će se tvoj alat pozvati kada je to potrebno i sprječavaju neželjene okidače. OpenAI preporučuje da na ove metapodatke gledaš kao na tekst proizvoda: iteriraj ih, testiraj i mjeri njihovu učinkovitost.
Referentni skup upita
Prije nego što dotakneš svoje metapodatke, izradi označeni skup testnih upita:
- Izravni upiti koji izričito imenuju tvoj proizvod ili izvor podataka.
- Neizravni upiti koji opisuju željeni ishod bez imenovanja tvog alata.
- Negativni upiti s kojima bi se trebali nositi ugrađeni alati ili drugi dodaci.
Za svaki upit dokumentiraj očekivano ponašanje: pozovi svoj alat, ne čini ništa ili prepusti rješenje drugom alatu. Koristi ovaj skup za svaki test nepovratne regresije.
Metapodaci koji vode model
- Naziv bi trebao kombinirati domenu i radnju, npr.
calendar.create_event. - Opis bi trebao započeti s „Koristi kada…“ i izričito navesti isključene slučajeve, npr. „Ne koristi za podsjetnike.“
- Svaki parametar mora biti dokumentiran s primjerima i popisom dopuštenih vrijednosti ako je ulaz ograničen.
- Anotacije moraju odražavati stvarno ponašanje (vidi Lekcije 3 i 11).
Izmjeri, zatim iteriraj
Spoji svoj poslužitelj, instaliraj dodatak, pokreni svoj skup upita i zabilježi koji je alat odabran, koji su argumenti proslijeđeni i je li prikazana bilo koja UI komponenta. Prati dvije metrike: preciznost (je li pozvan ispravan alat?) i odziv (je li alat pozvan svaki put kada je trebao biti?). Prvo ciljaj na visoku preciznost kod negativnih upita prije nego što juriš marginalna poboljšanja u odzivu.
Mijenjaj samo jedno polje odjednom kako bi izolirao što pokreće poboljšanje. Vodi dnevnik revizija s datumima i rezultatima te neka netko drugi pregleda promjene prije implementacije. U proizvodnji pregledavaj korištenje alata tjedno. Nagli porast potvrda „pogrešan alat“ obično signalizira drift metapodataka. Prikupljaj povratne informacije korisnika i redovito ponovno pokreći svoje testove upita, posebno nakon dodavanja novog alata ili modificiranja strukturiranog polja.
Vještine za ponavljajuće tijekove rada
Tvoj poslužitelj osigurava podatke, autentifikaciju i kontrolirane radnje. Vještina osigurava slijed poziva alata, točke odlučivanja, formatiranje izlaza, primjere i predloške. Najbrži način za početak je korištenje ugrađenog @skill-creator, gdje opisuješ korisnikov cilj i MCP alate koji ga podržavaju.
Jaka datoteka SKILL.md specificira koje korake slijediti, koji rezultat korisnik treba primiti, koje činjenice model ne smije izmisliti, kada postavljati pitanja, stati ili odbiti te koje datoteke konzultirati. Daj prednost fokusiranoj vještini za specifičan tijek rada umjesto velikom skupu različitih uputa. Razdvoj tijekove rada koji se razlikuju u okidaču, ulazima ili kriterijima uspjeha. Drži SKILL.md sažetim, a pojedinosti pohrani drugdje: koristi references/ za politike, sheme i primjere; assets/ za predloške za kopiranje ili transformaciju; i scripts/ za determinističke izračune – ali samo ako postojeće upute i alati nisu dovoljni.
Ako vještina ovisi o MCP poslužitelju, deklariraj tu ovisnost u agents/openai.yaml. To čini alat dostupnim, ali ne zamjenjuje potrebu za jasnim uputama o tome koje alate koristiti, kojim redoslijedom i kako rukovati nedostajućim ili dvosmislenim rezultatima. Za GPT-6 Astra, OpenAI savjetuje pregledavanje njihovih smjernica o slijeđenju uputa: eliminiraj nejasne ili kontradiktorne direktive i učini eksplicitnim da korisničke upute imaju prioritet nad uputama vještine.
Testiraj aktivaciju vještine i kvalitetu izlaza koristeći izravne, neizravne, nepotpune (koji bi trebali pokrenuti pitanje za razjašnjenje), nebitne upite i upite s rubnim slučajevima gdje vještina mora izbjeći haluciniranje ili djelovanje izvan svog opsega. Ako se vještina aktivira u pogrešno vrijeme, ispravi njezin opis. Ako odabere ispravan tijek rada, ali proizvodi nedosljedne rezultate, ispravi njezine upute.
MCP Događaji: Reagiranje na promjene
MCP Događaji omogućuju ChatGPT-u pretplatu na ažuriranja s tvog poslužitelja, poput novih poruka, modificiranog sadržaja ili promjena statusa. Korisnik bira što će pratiti i kako ChatGPT treba reagirati kada stigne ažuriranje – na primjer, „Prati ovaj dokument i primijeni ispravke zatražene u komentarima.“
- Tvoj poslužitelj navodi događaje koje podržava.
- Korisnik govori ChatGPT-u što pratiti i kako reagirati.
- ChatGPT se pretplaćuje putem tvog MCP poslužitelja, pružajući URL povratnog poziva i tajnu za potpisivanje.
- Tvoj poslužitelj šalje relevantne događaje na taj URL.
- ChatGPT prima događaj u pretplaćenom razgovoru i slijedi korisnikove upute.
Ova značajka dostupna je u razgovorima ChatGPT Work na webu i u aplikaciji za računalo s odabranom opcijom Cloud. ChatGPT se oslanja na isporuku webhooka kako je definirano u nacrtu specifikacije MCP Događaja. Tvoj poslužitelj mora trajno pohraniti pretplate i biti u mogućnosti doseći URL-ove povratnog poziva putem HTTPS-a.
Proširenja sučelja ChatGPT-a
OpenAI MCP Extensions omogućuju dodatku integraciju u ključna područja sučelja ChatGPT-a: bočnu traku, područje unosa i preglednike datoteka. Spominjanja u području unosa dostupna su samo u aplikaciji za računalo. OpenAI objavljuje uzorak dodatka, Bits & Bolts, koji demonstrira ova proširenja i prati njihovu implementaciju. To je najbolja polazna točka za istraživanje ove mogućnosti.
Ključne točke
- Tretiraj metapodatke kao tekst proizvoda: koristi referentni skup upita, prati preciznost i odziv te mijenjaj jedno polje odjednom.
- Piši opise koji počinju s „Koristi kada…“, izričito navedi isključene slučajeve i dokumentiraj sve parametre.
- Stvori jednu fokusiranu vještinu po tijeku rada, drži
SKILL.mdsažetim, pohrani resurse odvojeno i deklariraj MCP ovisnosti. - MCP Događaji pretplaćuju ChatGPT na ažuriranja tvog poslužitelja, isporučena putem webhooka.
- Proširenja integriraju tvoj dodatak u bočnu traku, područje unosa i preglednike datoteka.
Provjeri svoje znanje
Od MCP alata do objave: provjeri jesam li savladao osnove.
1. Trebam li paket `@openai/apps-sdk` za stvaranje aplikacije u ChatGPT-u?
Odgovor: Ne, taj paket ne postoji. Gradiš MCP poslužitelj koristeći službene SDK-ove protokola (@modelcontextprotocol/sdk za TypeScript, mcp za Python), opcionalno dodaješ sučelje usklađeno sa standardom MCP Apps i distribuiraš cijelu stvar kao dodatak.
2. Može li alat postojati bez korisničkog sučelja?
Odgovor: Da, i trebao bi: alat vraća structuredContent i kratak tekstualni sažetak, što je modelu dovoljno. Korisničko sučelje, povezano putem _meta.ui.resourceUri, dodaje se samo kada pomaže korisnicima u pregledu, usporedbi, uređivanju, potvrđivanju ili navigaciji informacijama.
3. Tko odlučuje ima li korisnik dopuštenje za pristup podacima?
Odgovor: MCP poslužitelj odlučuje o svakom zahtjevu, na temelju verificiranog OAuth tokena (potpis, izdavatelj, publika, istek, opsezi). Anotacije pomažu ChatGPT-u odabrati odgovarajuću razinu potvrde, ali nikada ne zamjenjuju autorizaciju na strani poslužitelja.
4. Može li dodatak prodavati pretplatu na svoju uslugu?
Odgovor: Ne. Pravila ograničavaju trgovinu na fizičku robu. Postojeći pretplatnik može se prijaviti i koristiti značajke uključene u svoj plan. Dodatak može objasniti da značajka nije uključena i povezati se na informativnu stranicu, ali nikada ne smije povezivati na stranicu za plaćanje.
5. Kako se alati ažuriraju za objavljeni dodatak?
Odgovor: Bez nove ZIP datoteke: OpenAI ponovno skenira poslužitelj i svaki novi ili modificirani alat postaje dostupan nakon prolaska automatiziranih provjera. Izbrisani alat odmah nestaje. Međutim, metapodaci i vještine zahtijevaju novu ZIP datoteku i novu recenziju.
Dobro opisani alati, opcionalna korisnička sučelja, autorizacija na strani poslužitelja i pridržavanje pravila: to je okvir koji dodatak čini pouzdanom uslugom u ChatGPT-u i Codexu.