Optimizēšana: metadati, prasmes un notikumi
Šajā lapā
Nodarbība pārrakstīta 2026. gada 3. novembrī, balstoties uz OpenAI spraudņu dokumentācijas lapām Optimize Metadata, Build Skills, MCP Events un Plugin Extensions. Iepriekšējā šīs nodarbības versija paļāvās uz neeksistējoša SDK
analyticsunexperimentmoduļiem. Avoti: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Metadati ir produkta teksts
ChatGPT un Codex lemj, kad izsaukt tavus rīkus, pamatojoties uz tavu sniegtajiem metadatiem. Labi uzrakstīti nosaukumi, apraksti un parametri nodrošina, ka tavs rīks tiek izsaukts, kad tas nepieciešams, un novērš nevēlamus aktivizējumus. OpenAI iesaka uztvert šos metadatus kā produkta tekstu: iteratīvi uzlabo tos, testē un mēri to veiktspēju.
Atsauces uzdevumu kopums
Pirms ķeries pie metadatu rediģēšanas, izveido marķētu testa uzdevumu kopu:
- Tiešie uzdevumi, kas tieši nosauc tavu produktu vai datu avotu.
- Netiešie uzdevumi, kas apraksta vēlamo rezultātu, nenosaucot tavu rīku.
- Negatīvie uzdevumi, kas jāapstrādā iebūvētiem rīkiem vai citiem spraudņiem.
Katram uzdevumam dokumentē paredzēto uzvedību: izsaukt tavu rīku, nedarīt neko vai nodot uzdevumu citam risinājumam. Izmanto šo kopu katrā regresijas testā.
Metadati, kas vada modeli
- Nosaukumam jāapvieno domēns un darbība, piemēram,
calendar.create_event. - Aprakstam jāsākas ar „Izmantot, ja…” un tieši jāuzskaita izslēgtie gadījumi, piemēram, „Neizmantot atgādinājumiem.”
- Katrs parametrs jādokumentē ar piemēriem un atļauto vērtību sarakstu, ja ievade ir ierobežota.
- Anotācijām jāatspoguļo faktiskā uzvedība (skat. 3. un 11. nodarbību).
Mēri, pēc tam iterē
Pieslēdz savu serveri, instalē spraudni, palaid savu uzdevumu kopu un fiksē, kurš rīks tika izvēlēts, kādi argumenti tika padoti un vai tika parādīts kāds lietotāja saskarnes komponents. Izseko divus rādītājus: precizitāti (vai tika izsaukts pareizais rīks?) un pilnīgumu (vai rīks tika izsaukts katru reizi, kad tam vajadzēja?). Vispirms tiecies uz augstu precizitāti negatīvajos uzdevumos, pirms dzenies pēc nelieliem pilnīguma uzlabojumiem.
Maini tikai vienu lauku vienlaikus, lai izolētu faktoru, kas veicina uzlabojumus. Uzturi datētu revīziju žurnālu ar rezultātiem un lūdz kādam citam pārskatīt izmaiņas pirms izvietošanas. Darbvidē ik nedēļu pārskati rīku lietojumu. Straujš „nepareiza rīka” apstiprinājumu pieaugums parasti signalizē metadatu novirzi. Vāc lietotāju atsauksmes un regulāri atkārto savu uzdevumu testus, it īpaši pēc jauna rīka pievienošanas vai strukturēta lauka modificēšanas.
Prasmes atkārtotām darbplūsmām
Tavs serveris nodrošina datus, autentifikāciju un kontrolētas darbības. Prasme nodrošina rīku izsaukumu secību, lēmumu punktus, izvades formatēšanu, piemērus un veidnes. Ātrākais veids, kā sākt, ir izmantot iebūvēto @skill-creator, kurā tu apraksti lietotāja mērķi un MCP rīkus, kas to atbalsta.
Spēcīgs SKILL.md fails precizē, kādas darbības jāveic, kādu rezultātu lietotājam jāsaņem, kādus faktus modelim nedrīkst izgudrot, kad jāuzdod jautājumi, jāapstājas vai jāatsakās, un kuri faili jākonsultē. Konkrētai darbplūsmai izvēlies fokusētu prasmi, nevis lielu kopu nesaskaņotu norādījumu. Sadali darbplūsmas, kas atšķiras pēc aktivizētāja, ievades vai veiksmes kritērijiem. Uzturi SKILL.md kodolīgu un detaļas glabā citur: izmanto references/ politikām, shēmām un piemēriem; assets/ veidnēm, ko kopēt vai transformēt; un scripts/ deterministiskiem aprēķiniem – bet tikai tad, ja esošie norādījumi un rīki ir nepietiekami.
Ja prasme ir atkarīga no MCP servera, deklarē šo atkarību failā agents/openai.yaml. Tas padara rīku pieejamu, taču neaizstāj nepieciešamību pēc skaidriem norādījumiem par to, kuri rīki jāizmanto, kādā secībā un kā rīkoties ar trūkstošiem vai neskaidriem rezultātiem. Attiecībā uz GPT-6 Astra OpenAI iesaka pārskatīt tās norādījumus par instrukciju ievērošanu: novērs neskaidrus vai pretrunīgus rīkojumus un skaidri norādi, ka lietotāja instrukcijām ir prioritāte pār prasmju instrukcijām.
Testē prasmju aktivizēšanu un izvades kvalitāti, izmantojot tiešus, netiešus, nepilnīgus (kam jāizraisa precizējošs jautājums), neatbilstošus tēmai un robežgadījumu uzdevumus, kuros prasmei jāizvairās no halucinācijām vai darbībām ārpus tās darbības jomas. Ja prasme aktivizējas nepareizā laikā, labo tās aprakstu. Ja tā izvēlas pareizo darbplūsmu, bet rada nesaskaņotus rezultātus, labo tās norādījumus.
MCP notikumi: reaģēšana uz izmaiņām
MCP Events ļauj ChatGPT abonēt atjauninājumus no tava servera, piemēram, jaunus ziņojumus, modificētu saturu vai statusa izmaiņas. Lietotājs izvēlas, ko uzraudzīt un kā ChatGPT reaģēt, kad pienāk atjauninājums – piemēram, „Uzraugi šo dokumentu un piemēro labojumus, kas pieprasīti komentāros.”
- Tavs serveris uzskaita atbalstītos notikumus.
- Lietotājs norāda ChatGPT, ko uzraudzīt un kā reaģēt.
- ChatGPT abonē, izmantojot tavu MCP serveri, nodrošinot atzvanīšanas URL un parakstīšanas noslēpumu.
- Tavs serveris nosūta attiecīgos notikumus uz šo URL.
- ChatGPT saņem notikumu abonētajā sarunā un seko lietotāja norādījumiem.
Šī funkcija ir pieejama ChatGPT Work sarunās tīmeklī un darbvirsmas lietotnē, ja ir atlasīts Cloud. ChatGPT paļaujas uz tīmekļa āķu (webhook) piegādi, kā definēts MCP Events specifikācijas melnrakstā. Tavam serverim jāglabā abonementi un jāspēj sasniegt atzvanīšanas URL, izmantojot HTTPS.
ChatGPT saskarnes paplašinājumi
OpenAI MCP Extensions ļauj spraudnim integrēties ChatGPT saskarnes galvenajās zonās: sānjoslā, ievades laukā un failu skatītājos. Pieminēšana ievades laukā ir pieejama tikai darbvirsmas lietotnē. OpenAI publicē parauga spraudni Bits & Bolts, kas demonstrē šos paplašinājumus un izseko to izvietošanu. Tas ir labākais sākumpunkts šīs iespējas izpētei.
Galvenās atziņas
- Uztver metadatus kā produkta tekstu: izmanto atsauces uzdevumu kopu, izseko precizitāti un pilnīgumu, un maini vienu lauku vienlaikus.
- Raksti aprakstus, sākot ar „Izmantot, ja…”, tieši uzskaiti izslēgtos gadījumus un dokumentē visus parametrus.
- Izveido vienu fokusētu prasmi katrai darbplūsmai, uzturi
SKILL.mdkodolīgu, glabā resursus atsevišķi un deklarē MCP atkarības. - MCP Events abonē ChatGPT tava servera atjauninājumiem, kas tiek piegādāti, izmantojot tīmekļa āķi.
- Paplašinājumi integrē tavu spraudni sānjoslā, ievades laukā un failu skatītājos.
Pārbaudi savas zināšanas
No MCP rīkiem līdz publikācijai: pārliecinies, ka esi apguvis pamatus.
1. Vai man ir nepieciešams `@openai/apps-sdk` pakotne, lai izveidotu lietotni ChatGPT?
Atbilde: Nē, šāda pakotne neeksistē. Tu veido MCP serveri, izmantojot oficiālos protokola SDK (@modelcontextprotocol/sdk priekš TypeScript, mcp priekš Python), pēc vēlēšanās pievieno saskarni, kas atbilst MCP Apps standartam, un izplati visu to kā spraudni.
2. Vai rīks var pastāvēt bez lietotāja saskarnes?
Atbilde: Jā, un tam tā vajadzētu būt: rīks atgriež structuredContent un īsu teksta kopsavilkumu, kas modelim ir pietiekami. Lietotāja saskarne, kas pievienota, izmantojot _meta.ui.resourceUri, tiek iekļauta tikai tad, ja tā palīdz lietotājiem pārbaudīt, salīdzināt, rediģēt, apstiprināt vai pārvietoties informācijā.
3. Kurš lemj, vai lietotājam ir atļauja piekļūt datiem?
Atbilde: MCP serveris lemj par katru pieprasījumu, balstoties uz verificētu OAuth tokeni (paraksts, izdevējs, auditorija, derīguma termiņš, scopes). Anotācijas palīdz ChatGPT izvēlēties atbilstošu apstiprinājuma līmeni, taču tās nekad neaizstāj servera puses autorizāciju.
4. Vai spraudnis var pārdot abonementu savam servisam?
Atbilde: Nē. Noteikumi ierobežo komerciju ar fiziskām precēm. Esošs abonents var pieteikties un izmantot funkcijas, kas iekļautas viņa plānā. Spraudnis var paskaidrot, ka funkcija nav iekļauta, un norādīt saiti uz informācijas lapu, taču tam nekad nedrīkst būt saite uz maksājumu lapu.
5. Kā rīki tiek atjaunināti publicētam spraudnim?
Atbilde: Bez jauna ZIP faila: OpenAI atkārtoti skenē serveri, un jebkurš jauns vai modificēts rīks kļūst pieejams pēc automatizēto pārbaužu nokārtošanas. Dzēsts rīks pazūd uzreiz. Tomēr metadati un prasmes prasa jaunu ZIP failu un jaunu pārskatīšanu.
Labi aprakstīti rīki, opcionālas lietotāja saskarnes, servera puses autorizācija un noteikumu ievērošana: tas ir ietvars, kas padara spraudni par uzticamu servisu ChatGPT un Codex vidē.