Optimeeri: metaandmed, oskused ja sündmused
Sellel lehel
Õppetund kirjutati ümber 3. novembril 2026, tuginedes OpenAI pistikprogrammide dokumentatsiooni lehtedele Optimize Metadata, Build Skills, MCP Events ja Plugin Extensions. Eelmine versioon toetus olematule SDK-le kuuluvatele moodulitele
analyticsjaexperiment. Allikad: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Metaandmed on tootekirjandus
ChatGPT ja Codex otsustavad sinu tööriistade kutsumise põhjal metaandmetel, mida sa pakud. Hästi kirjutatud nimed, kirjeldused ja parameetrid tagavad, et sinu tööriista kasutatakse vajadusel, ning hoiavad ära soovimatud käivitumised. OpenAI soovitab käsitleda neid metaandmeid tootekirjandusena: täienda neid, testi ja mõõda nende tulemuslikkust.
Võrdluslik vihjete kogum
Enne metaandmete muutmist koosta märgistatud testvihjete kogum:
- Otsesed vihjed, mis nimetavad sinu toodet või andmeallikat sõnaselgelt.
- Kaudsed vihjed, mis kirjeldavad soovitud tulemust ilma sinu tööriista nimetamata.
- Negatiivsed vihjed, mida peaksid käsitlema sisseehitatud tööriistad või muud pistikprogrammid.
Dokumendi iga vihje jaoks oodatav käitumine: kutsu oma tööriist, ära tee midagi või suuna teisele lahendusele. Kasuta seda kogumit iga regressioonitesti puhul.
Mudelit juhtivad metaandmed
- Nimi peaks ühendama valdkonna ja tegevuse, näiteks
calendar.create_event. - Kirjeldus peaks algama fraasiga „Kasuta, kui…“ ja loetlema sõnaselgelt välistatud juhtumid, näiteks „Ära kasuta meeldetuletuste jaoks.“
- Iga parameeter peab olema dokumenteeritud näidetega ja lubatud väärtuste loeteluga, kui sisend on piiratud.
- Annotatsioonid peavad kajastama tegelikku käitumist (vt õppetunde 3 ja 11).
Mõõda ja seejärel täienda
Ühenda oma server, paigalda pistikprogramm, käivita oma vihjete kogum ja salvesta, milline tööriist valiti, millised argumendid edastati ja kas kuvati mõni kasutajaliidese komponent. Jälgi kahte näitajat: täpsust (kas kutsuti õige tööriist?) ja täielikkust (kas tööriista kutsuti iga kord, kui seda oleks pidanud?). Püüa esmalt saavutada kõrge täpsus negatiivsete vihjete puhul, enne kui jahid marginaalseid kasumeid täielikkuses.
Muuda korraga ainult ühte välja, et isoleerida edasiminekut põhjustav tegur. Pea kuupäevastatud revisjonilogi tulemustega ja lase kellegi teisel muudatused enne kasutuselevõttu üle vaadata. Tootmiskeskkonnas vaata tööriistade kasutust üle kord nädalas. „Vale tööriista“ kinnituste järsk tõus annab tavaliselt märku metaandmete triivist. Kogu kasutajatagasisidet ja käivita oma vihjeteste regulaarselt uuesti, eriti pärast uue tööriista lisamist või struktureeritud välja muutmist.
Korduvate töövoogude oskused
Sinu server pakub andmeid, autentimist ja kontrollitud toiminguid. Oskus pakub tööriistakutsete jada, otsustuspunkte, väljundi vormindamist, näiteid ja malle. Kiireim viis alustamiseks on kasutada sisseehitatud @skill-creator, kus kirjeldad kasutaja eesmärki ja seda toetavaid MCP tööriistu.
Tugev SKILL.md fail täpsustab, milliseid samme järgida, millist tulemust kasutaja peaks saama, milliseid fakte mudel ei tohi välja mõelda, millal küsida küsimusi, peatuda või keelduda, ning milliseid faile konsulteerida. Eelista konkreetsele töövoole suunatud oskust suurele hulgale erinevatele juhistele. Jaota töövoogud, millel on erinevad käivitajad, sisendid või edu kriteeriumid. Hoia SKILL.md lühike ja salvesta üksikasjad mujale: kasuta kausta references/ poliitikate, skeemide ja näidete jaoks; assets/ mallide jaoks, mida kopeerida või teisendada; ja scripts/ deterministlike arvutuste jaoks – kuid ainult siis, kui olemasolevad juhised ja tööriistad on ebapiisavad.
Kui oskus sõltub MCP serverist, deklareeri see sõltuvus failis agents/openai.yaml. See teeb tööriista kättesaadavaks, kuid ei asenda vajadust selgete juhiste järele selle kohta, milliseid tööriistu kasutada, millises järjekorras ja kuidas käsitleda puuduvaid või ebaselgeid tulemusi. GPT-6 Astra jaoks soovitab OpenAI tutvuda selle juhistega juhiste järgimise kohta: kõrvalda ebamäärased või vastuolulised direktiivid ja tee sõnaselgeks, et kasutaja juhised on oskuse juhistest olulisemad.
Testi oskuse aktiveerumist ja väljundi kvaliteeti, kasutades otseseid, kaudseid, mittetäielikke (mis peaksid esile kutsuma täpsustava küsimuse), teemaväliseid ja piirjuhtumite vihjeid, kus oskus peab vältima hallutsineerimist või tegutsemist väljaspool oma ulatust. Kui oskus aktiveerub valel ajal, paranda selle kirjeldust. Kui see valib õige töövoogu, kuid toodab ebajärjekindlaid tulemusi, paranda selle juhiseid.
MCP sündmused: reageerimine muutustele
MCP Events võimaldab ChatGPT-l tellida uuendusi sinu serverist, nagu uued sõnumid, muudetud sisu või olekumuutused. Kasutaja valib, mida jälgida ja kuidas ChatGPT peaks uuenduse saabumisel reageerima – näiteks „Jälgi seda dokumenti ja rakenda kommentaarides taotletud parandusi.“
- Sinu server loetleb toetatud sündmused.
- Kasutaja ütleb ChatGPT-le, mida jälgida ja kuidas reageerida.
- ChatGPT tellib teenuse läbi sinu MCP serveri, esitades tagasikutse URL-i ja allkirjastamise saladuse.
- Sinu server saadab asjakohased sündmused sellele URL-ile.
- ChatGPT saab sündmuse tellitud vestluses ja järgib kasutaja juhiseid.
See funktsioon on saadaval ChatGPT Worki vestlustes veebis ja töölauarakenduses, kui on valitud Cloud. ChatGPT tugineb veebikonksu (webhook) kohaletoimetamisele, nagu on määratletud MCP Eventsi spetsifikatsiooni mustandis. Sinu server peab säilitama tellimusi ja suutma jõuda tagasikutse URL-ideni üle HTTPS-i.
ChatGPT liidese laiendused
OpenAI MCP Extensions võimaldavad pistikprogrammil integreeruda ChatGPT liidese võtmeosadesse: külgribale, sisendalale ja failivaaturitele. Mainimised sisendalal on saadaval ainult töölauarakenduses. OpenAI avaldab näidispistikprogrammi Bits & Bolts, mis demonstreerib neid laiendusi ja jälgib nende kasutuselevõttu. See on parim lähtepunkt selle võimekuse uurimiseks.
Peamised punktid
- Käitle metaandmeid tootekirjandusena: kasuta võrdluslikku vihjete kogumit, jälgi täpsust ja täielikkust ning muuda korraga ainult ühte välja.
- Kirjuta kirjeldused, mis algavad fraasiga „Kasuta, kui…“, loetle välistatud juhtumid sõnaselgelt ja dokumenteeri kõik parameetrid.
- Loo iga töövoogu kohta üks keskendunud oskus, hoia
SKILL.mdlühike, salvesta ressursid eraldi ja deklareeri MCP sõltuvused. - MCP Events tellib ChatGPT-i sinu serveri uuendustele, mis toimetatakse veebikonksu kaudu.
- Laiendused integreerivad sinu pistikprogrammi külgribale, sisendalale ja failivaaturitesse.
Testi oma teadmisi
Alates MCP tööriistadest kuni avaldamiseni: veendu, et oled valdanud põhialuseid.
1. Kas rakenduse loomiseks ChatGPT-s on vaja paketti `@openai/apps-sdk`?
Vastus: Ei, seda paketti ei eksisteeri. Ehitad MCP serveri, kasutades ametlikke protokolli SDK-sid (@modelcontextprotocol/sdk TypeScripti jaoks, mcp Pythoni jaoks), lisad valikuliselt MCP Apps standardile vastava liidese ja levitad kogu selle pistikprogrammina.
2. Kas tööriist võib eksisteerida ilma kasutajaliideseta?
Vastus: Jah, ja see peaks nii olema: tööriist tagastab structuredContent ja lühikese tekstikokkuvõtte, mis mudelile piisab. Kasutajaliides, mis on lisatud _meta.ui.resourceUri kaudu, lisatakse ainult siis, kui see aitab kasutajatel teavet kontrollida, võrrelda, redigeerida, kinnitada või navigeerida.
3. Kes otsustab, kas kasutajal on andmetele juurdepääsu luba?
Vastus: MCP server otsustab iga päringu põhjal, tuginedes kontrollitud OAuth tokenile (allkiri, väljaandja, sihtrühm, aegumine, ulatused). Annotatsioonid aitavad ChatGPT-l valida sobivat kinnitustaset, kuid need ei asenda kunagi serveripoolset autoriseerimist.
4. Kas pistikprogramm võib müüa oma teenusele tellimust?
Vastus: Ei. Reeglid piiravad kaubanduse füüsiliste kaupadega. Olemasolev tellija saab sisse logida ja kasutada oma plaani kuuluvaid funktsioone. Pistikprogramm võib selgitada, et funktsioon ei kuulu paketti, ja linkida teabelehele, kuid see ei tohi kunagi linkida makselehele.
5. Kuidas uuendatakse tööriistu avaldatud pistikprogrammi jaoks?
Vastus: Ilma uue ZIP-failita: OpenAI skannib serveri uuesti ja iga uus või muudetud tööriist muutub kättesaadavaks pärast automatiseeritud kontrollide läbimist. Kustutatud tööriist kaob koheselt. Metaandmed ja oskused nõuavad siiski uut ZIP-faili ja uut ülevaatust.
Hästi kirjeldatud tööriistad, valikulised kasutajaliidesed, serveripoolne autoriseerimine ja reeglite järgimine: see on raamistik, mis muudab pistikprogrammi usaldusväärseks teenuseks ChatGPT-s ja Codexis.