Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Optimalizácia: Metadáta, zručnosti a udalosti

Lekcia 14 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Metadáta sú textom produktu
  2. Zručnosti pre opakujúce sa pracovné postupy
  3. Udalosti MCP: Reakcia na zmeny
  4. Rozšírenia rozhrania ChatGPT
  5. Kľúčové poznatky
  6. Over si svoje vedomosti

Lekcia prepísaná 3. novembra 2026 na základe dokumentácie OpenAI Plugins pre stránky Optimize Metadata, Build Skills, MCP Events a Plugin Extensions. Predchádzajúca verzia tejto lekcie sa spoliehala na moduly analytics a experiment z neexistujúceho SDK. Zdroje: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.

Metadáta sú textom produktu

ChatGPT a Codex sa rozhodujú, kedy zavolať tvoje nástroje, na základe metadát, ktoré poskytuješ. Dobre napísané názvy, popisy a parametre zabezpečia, že sa tvoj nástroj spustí, keď je to potrebné, a zabránia nechceným aktiváciám. OpenAI odporúča zaobchádzať s týmito metadátami ako s textom produktu: iteratívne ich vylepšuj, testuj a meraj ich výkon.

Referenčná sada promptov

Predtým, než začneš upravovať metadáta, vytvor si označenú sadu testovacích promptov:

  • Priame prompty, ktoré explicitne menujú tvoj produkt alebo zdroj dát.
  • Nepriame prompty, ktoré opisujú požadovaný výsledok bez pomenovania tvojho nástroja.
  • Negatívne prompty, ktoré by mali byť vybavené vstavanými nástrojmi alebo inými pluginmi.

Pre každý prompt zdokumentuj očakávané správanie: zavolať tvoj nástroj, neurobiť nič alebo delegovať na iné riešenie. Túto sadu používaj pri každom teste regresie.

Metadáta, ktoré vedú model

  • Názov by mal kombinovať doménu a akciu, napríklad calendar.create_event.
  • Popis by mal začínať frázou „Použiť, keď…“ a explicitne vymenovať vylúčené prípady, napríklad „Nepoužívať na pripomienky.“
  • Každý parameter musí byť zdokumentovaný s príkladmi a zoznamom povolených hodnôt, ak je vstup obmedzený.
  • Anotácie musia odrážať skutočné správanie (pozri Lekcie 3 a 11).

Meraj a potom iteruj

Pripoj svoj server, nainštaluj plugin, spusti svoju sadu promptov a zaznamenaj, ktorý nástroj bol vybratý, aké argumenty boli odovzdané a či sa zobrazila nejaká komponenta používateľského rozhrania. Sleduj dve metriky: presnosť (bol zavolaný správny nástroj?) a úplnosť (bol nástroj zavolaný zakaždým, keď mal byť?). Najprv sa zameraj na vysokú presnosť pri negatívnych promptoch, až potom sa snaž o marginálne zlepšenia v úplnosti.

Meň vždy len jedno pole naraz, aby si izoloval faktor, ktorý prináša zlepšenie. Veď si datovaný log revízií s výsledkami a pred nasadením nechaj zmeny skontrolovať niekým iným. V prevádzke recenzuj využitie nástrojov týždenne. Nárast potvrdení „nesprávny nástroj“ zvyčajne signalizuje posun v metadátach. Zbieraj spätnú väzbu od používateľov a pravidelne znovu spúšťaj svoje testy promptov, najmä po pridaní nového nástroja alebo úprave štruktúrovaného poľa.

Zručnosti pre opakujúce sa pracovné postupy

Tvoj server poskytuje dáta, autentifikáciu a riadené akcie. Zručnosť (skill) poskytuje sekvenciu volaní nástrojov, rozhodovacie body, formátovanie výstupu, príklady a šablóny. Najrýchlejším spôsobom, ako začať, je použitie vstavaného @skill-creator, kde opíšeš cieľ používateľa a nástroje MCP, ktoré ho podporujú.

Silný súbor SKILL.md špecifikuje, ktoré kroky nasledovať, aký výsledok by používateľ mal dostať, aké fakty si model nesmie vymyslieť, kedy sa má opýtať, zastaviť alebo odmietnuť, a ktoré súbory konzultovať. Uprednostni zameranú zručnosť pre konkrétny pracovný postup pred veľkou sadou roztrieštených inštrukcií. Rozdeľ pracovné postupy, ktoré sa líšia v spúšťači, vstupoch alebo kritériách úspechu. Udržuj SKILL.md stručné a podrobnosti ukladaj inde: použite references/ pre politiky, schémy a príklady; assets/ pre šablóny na kopírovanie alebo transformáciu; a scripts/ pre deterministické výpočty – ale len vtedy, ak existujúce inštrukcie a nástroje nestačia.

Ak zručnosť závisí od servera MCP, deklaruj túto závislosť v súbore agents/openai.yaml. Tým sa nástroj stane dostupným, ale nenahrádza to potrebu jasných inštrukcií o tom, ktoré nástroje použiť, v akom poradí a ako zaobchádzať s chýbajúcimi alebo nejednoznačnými výsledkami. Pre GPT-6 Astra OpenAI odporúča preštudovať si jej usmernenia týkajúce sa dodržiavania inštrukcií: odstráň vágne alebo protichodné smernice a explicitne uveď, že inštrukcie používateľa majú prednosť pred inštrukciami zručnosti.

Testuj aktiváciu zručnosti a kvalitu výstupu pomocou priamych, nepriamych, neúplných (ktoré by mali vyvolať objasňujúcu otázku), irelevantných promptov a promptov s hraničnými prípadmi, kde sa zručnosť musí vyhnúť halucináciám alebo konaniu mimo svojho rozsahu. Ak sa zručnosť aktivuje v nesprávny čas, oprav jej popis. Ak vyberie správny pracovný postup, ale produkuje nekonzistentné výsledky, oprav jej inštrukcie.

Udalosti MCP: Reakcia na zmeny

Udalosti MCP (MCP Events) umožňujú ChatGPT prihlásiť sa na odber aktualizácií z tvojho servera, ako sú nové správy, upravený obsah alebo zmeny stavu. Používateľ si vyberie, čo má sledovať a ako má ChatGPT reagovať, keď príde aktualizácia – napríklad: „Sleduj tento dokument a aplikuj opravy požadované v komentároch.“

  1. Tvoj server zoznamuje udalosti, ktoré podporuje.
  2. Používateľ povie ChatGPT, čo má sledovať a ako reagovať.
  3. ChatGPT sa prihlási na odber cez tvoj server MCP a poskytne URL spätného volania a podpisový tajný kľúč.
  4. Tvoj server odosiela príslušné udalosti na túto URL.
  5. ChatGPT prijme udalosť v prihlásenej konverzácii a nasleduje inštrukcie používateľa.

Táto funkcia je dostupná v konverzáciách ChatGPT Work na webe a v desktopovej aplikácii so zvolenou možnosťou Cloud. ChatGPT sa spolieha na doručovanie webhookov podľa definície v návrhu špecifikácie Událostí MCP. Tvoj server musí persistovať prihlášky na odber a musí byť schopný dosiahnuť URL spätného volania cez HTTPS.

Rozšírenia rozhrania ChatGPT

Rozšírenia OpenAI MCP umožňujú pluginu integrovať sa do kľúčových oblastí rozhrania ChatGPT: bočného panela, oblasti vstupu a prehliadačov súborov. Mentiony (zmienky) v oblasti vstupu sú dostupné len v desktopovej aplikácii. OpenAI publikuje ukážkový plugin Bits & Bolts, ktorý demonštruje tieto rozšírenia a sleduje ich nasadenie. Je to najlepší východiskový bod preskúmavania tejto schopnosti.

Kľúčové poznatky

  • Zaobchádzaj s metadátami ako s textom produktu: používaj referenčnú sadu promptov, sleduj presnosť a úplnosť a meň vždy len jedno pole naraz.
  • Píš popisy začínajúce frázou „Použiť, keď…“, explicitne vymenuj vylúčené prípady a zdokumentuj všetky parametre.
  • Vytvor jednu zameranú zručnosť pre každý pracovný postup, udržuj SKILL.md stručné, ukladaj zdroje oddelene a deklaruj závislosti MCP.
  • Udalosti MCP prihlasujú ChatGPT na odber aktualizácií tvojho servera, ktoré sú doručované cez webhook.
  • Rozšírenia integrujú tvoj plugin do bočného panela, oblasti vstupu a prehliadačov súborov.

Over si svoje vedomosti

Od nástrojov MCP po publikáciu: over si, že si zvládol základy.

1. Potrebujem balík `@openai/apps-sdk` na vytvorenie aplikácie v ChatGPT?

Odpoveď: Nie, tento balík neexistuje. Server MCP vytvoríš pomocou oficiálnych SDK protokolu (@modelcontextprotocol/sdk pre TypeScript, mcp pre Python), voliteľne pridáš rozhranie kompatibilné so štandardom MCP Apps a celú vec distribuujete ako plugin.

2. Môže nástroj existovať bez používateľského rozhrania?

Odpoveď: Áno, a mal by: nástroj vracia structuredContent a krátky textový súhrn, čo pre model stačí. Používateľské rozhranie, pripojené cez _meta.ui.resourceUri, sa pridáva len vtedy, keď pomáha používateľom kontrolovať, porovnávať, upravovať, potvrdzovať alebo navigovať v informáciách.

3. Kto rozhoduje o tom, či má používateľ povolenie na prístup k dátam?

Odpoveď: Server MCP rozhoduje pri každej požiadavke na základe overeného OAuth tokenu (podpis, vydavateľ, cieľová skupina, platnosť, rozsahy). Anotácie pomáhajú ChatGPT vybrať vhodnú úroveň potvrdenia, ale nikdy nenahrádzajú autorizáciu na strane servera.

4. Môže plugin predávať predplatné svojej služby?

Odpoveď: Nie. Pravidlá obmedzujú obchod na fyzický tovar. Existujúci predplatiteľ sa môže prihlásiť a používať funkcie zahrnuté v jeho pláne. Plugin môže vysvetliť, že funkcia nie je zahrnutá, a odkázať na informačnú stránku, ale nikdy nesmie odkazovať na platobnú stránku.

5. Ako sa aktualizujú nástroje pre publikovaný plugin?

Odpoveď: Bez nového súboru ZIP: OpenAI znovu preskenuje server a akýkoľvek nový alebo upravený nástroj sa stane dostupným po úspešnom prechode automatizovanými kontrolami. Vymazaný nástroj zmizne okamžite. Metadáta a zručnosti si však vyžadujú nový súbor ZIP a novú recenziu.

Dobre opísané nástroje, voliteľné používateľské rozhrania, autorizácia na strane servera a dodržiavanie pravidiel: toto je rámec, ktorý robí z pluginu spoľahlivú službu v ChatGPT a Codex.