Optimalizace: Metadata, dovednosti a události
Na této stránce
Lekce přepracována 3. listopadu 2026 na základě dokumentace OpenAI Plugins Optimize Metadata, Build Skills, MCP Events a Plugin Extensions. Předchozí verze této lekce spoléhala na moduly
analyticsaexperimentz neexistujícího SDK. Zdroje: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Metadata jsou texty produktu
ChatGPT a Codex se rozhodují, kdy zavolat vaše nástroje, na základě poskytnutých metadat. Dobře napsané názvy, popisy a parametry zajistí, že bude váš nástroj vyvolán, když je potřeba, a zabrání nežádoucím spuštěním. OpenAI doporučuje zacházet s těmito metadaty jako s texty produktu: iterativně je vylepšujte, testujte je a měřte jejich výkon.
Referenční sada promptů
Než začnete upravovat metadata, vytvořte označenou sadu testovacích promptů:
- Přímé prompty, které explicitně pojmenovávají váš produkt nebo zdroj dat.
- Nepřímé prompty, které popisují požadovaný výsledek bez uvedení názvu vašeho nástroje.
- Negativní prompty, které by měly být zpracovány vestavěnými nástroji nebo jinými pluginy.
Pro každý prompt zdokumentujte očekávané chování: zavolat váš nástroj, nedělat nic nebo přenechat řešení jinému nástroji. Tuto sadu používejte pro každý test zpětné kompatibility.
Metadata, která vedou model
- Název by měl kombinovat doménu a akci, například
calendar.create_event. - Popis by měl začínat frází „Použít, když…“ a explicitně uvádět vyloučené případy, například „Nepoužívat pro připomínky.“
- Každý parametr musí být zdokumentován s příklady a seznamem povolených hodnot, pokud je vstup omezen.
- Anotace musí odpovídat skutečnému chování (viz lekce 3 a 11).
Měření a následná iterace
Připojte svůj server, nainstalujte plugin, spusťte svou sadu promptů a zaznamenejte, který nástroj byl vybrán, jaké argumenty byly předány a zda se zobrazila nějaká komponenta uživatelského rozhraní. Sledujte dvě metriky: přesnost (byl zavolán správný nástroj?) a úplnost (byl nástroj zavolán pokaždé, když měl?). Nejprve usilujte o vysokou přesnost u negativních promptů, než budete honit marginální zisky v úplnosti.
Měňte vždy pouze jedno pole, abyste izolovali faktor, který přináší zlepšení. Veďte datovaný revizní deník s výsledky a nechte změny před nasazením zkontrolovat někým jiným. V produkčním prostředí recenzujte využití nástrojů týdně. Prudký nárůst potvrzení „špatný nástroj“ obvykle signalizuje drift metadat. Pravidelně shromažďujte zpětnou vazbu od uživatelů a znovu spouštějte své testy promptů, zejména po přidání nového nástroje nebo úpravě strukturovaného pole.
Dovednosti pro opakující se pracovní postupy
Váš server poskytuje data, autentizaci a řízené akce. Dovednost (skill) poskytuje sekvenci volání nástrojů, rozhodovací body, formátování výstupu, příklady a šablony. Nejrychlejším způsobem, jak začít, je použití vestavěného @skill-creator, kde popíšete cíl uživatele a nástroje MCP, které jej podporují.
Silný soubor SKILL.md specifikuje, které kroky následovat, jaký výsledek by uživatel měl obdržet, jaká fakta si model nesmí vymýšlet, kdy se ptát, zastavit nebo odmítnout, a které soubory konzultovat. Upřednostněte zaměřenou dovednost pro konkrétní pracovní postup před velkou sadou rozptýlených pokynů. Rozdělte pracovní postupy, které se liší svým spouštěčem, vstupy nebo kritérii úspěchu. Udržujte SKILL.md stručné a podrobnosti ukládejte jinam: použijte references/ pro zásady, schémata a příklady; assets/ pro šablony ke kopírování nebo transformaci; a scripts/ pro deterministické výpočty – ale pouze pokud stávající pokyny a nástroje nestačí.
Pokud dovednost závisí na serveru MCP, deklarujte tuto závislost v souboru agents/openai.yaml. To zpřístupní nástroj, ale nenahrazuje potřebu jasných pokynů ohledně toho, které nástroje použít, v jakém pořadí a jak zacházet s chybějícími nebo nejednoznačnými výsledky. Pro GPT-6 Astra OpenAI doporučuje prostudovat její pokyny týkající se dodržování instrukcí: eliminujte vágní nebo rozporuplné direktivy a explicitně uveďte, že pokyny uživatele mají přednost před pokyny dovednosti.
Otestujte aktivaci dovednosti a kvalitu výstupu pomocí přímých, nepřímých, neúplných (které by měly vyvolat upřesňující otázku), off-topic a hraničních promptů, kde se dovednost musí vyvarovat halucinací nebo jednání mimo svůj rozsah. Pokud se dovednost aktivuje ve špatný čas, opravte její popis. Pokud vybere správný pracovní postup, ale produkuje nekonzistentní výsledky, opravte její pokyny.
Události MCP: Reakce na změny
Události MCP (MCP Events) umožňují ChatGPT odebírat aktualizace z vašeho serveru, jako jsou nové zprávy, upravený obsah nebo změny stavu. Uživatel si zvolí, co má sledovat a jak má ChatGPT reagovat, když aktualizace dorazí – například „Sleduj tento dokument a aplikuj opravy požadované v komentářích.“
- Váš server vypíše události, které podporuje.
- Uživatel řekne ChatGPT, co má sledovat a jak reagovat.
- ChatGPT se přihlásí k odběru prostřednictvím vašeho serveru MCP a poskytne URL adresu zpětného volání a podpisový tajný klíč.
- Váš server odešle relevantní události na tuto URL adresu.
- ChatGPT obdrží událost v přihlášené konverzaci a následuje pokyny uživatele.
Tato funkce je dostupná v konverzacích ChatGPT Work na webu a v desktopové aplikaci s vybranou možností Cloud. ChatGPT spoléhá na doručování webhooků podle definice v návrhu specifikace Událostí MCP. Váš server musí trvale uchovávat přihlášení k odběru a být schopen dosáhnout na URL adresy zpětného volání přes HTTPS.
Rozšíření rozhraní ChatGPT
Rozšíření OpenAI MCP umožňují pluginu integrovat se do klíčových oblastí rozhraní ChatGPT: postranního panelu, vstupní oblasti a prohlížečů souborů. Zmiňování ve vstupní oblasti je dostupné pouze v desktopové aplikaci. OpenAI publikuje ukázkový plugin Bits & Bolts, který demonstruje tato rozšíření a sleduje jejich nasazení. Je to nejlepší výchozí bod pro průzkum této schopnosti.
Klíčové poznatky
- Zacházejte s metadaty jako s texty produktu: používejte referenční sadu promptů, sledujte přesnost a úplnost a měňte vždy pouze jedno pole.
- Pište popisy začínající frází „Použít, když…“, explicitně uvádějte vyloučené případy a dokumentujte všechny parametry.
- Vytvořte jednu zaměřenou dovednost pro každý pracovní postup, udržujte
SKILL.mdstručné, ukládejte zdroje odděleně a deklarujte závislosti MCP. - Události MCP přihlašují ChatGPT k odběru aktualizací vašeho serveru, které jsou doručovány prostřednictvím webhooku.
- Rozšíření integrují váš plugin do postranního panelu, vstupní oblasti a prohlížečů souborů.
Ověřte si své znalosti
Od nástrojů MCP až po publikaci: ověřte si, že jste zvládli základy.
1. Potřebuji balíček `@openai/apps-sdk` k vytvoření aplikace v ChatGPT?
Odpověď: Ne, tento balíček neexistuje. Server MCP vytvoříte pomocí oficiálních SDK protokolu (@modelcontextprotocol/sdk pro TypeScript, mcp pro Python), volitelně přidáte rozhraní kompatibilní se standardem MCP Apps a celou věc distribuujete jako plugin.
2. Může nástroj existovat bez uživatelského rozhraní?
Odpověď: Ano, a měl by: nástroj vrací structuredContent a krátký textový souhrn, což pro model stačí. Uživatelské rozhraní, připojené prostřednictvím _meta.ui.resourceUri, se přidá pouze tehdy, když pomáhá uživatelům informace kontrolovat, porovnávat, upravovat, potvrzovat nebo v nich navigovat.
3. Kdo rozhoduje o tom, zda má uživatel oprávnění přistupovat k datům?
Odpověď: Server MCP rozhoduje o každém požadavku na základě ověřeného OAuth tokenu (podpis, vydavatel, audience, platnost, rozsahy). Anotace pomáhají ChatGPT vybrat odpovídající úroveň potvrzení, ale nikdy nenahrazují autorizaci na straně serveru.
4. Může plugin prodávat předplatné své služby?
Odpověď: Ne. Pravidla omezují obchod na fyzické zboží. Stávající předplatitel se může přihlásit a používat funkce zahrnuté v jeho plánu. Plugin může vysvětlit, že funkce není zahrnuta, a odkázat na informační stránku, ale nikdy nesmí odkazovat na platební stránku.
5. Jak se aktualizují nástroje pro publikovaný plugin?
Odpověď: Bez nového souboru ZIP: OpenAI znovu proskenuje server a jakýkoli nový nebo upravený nástroj se stane dostupným po úspěšném absolvování automatizovaných kontrol. Smazaný nástroj okamžitě zmizí. Metadata a dovednosti však vyžadují nový soubor ZIP a novou revizi.
Dobře popsané nástroje, volitelná uživatelská rozhraní, autorizace na straně serveru a dodržování pravidel: to je rámec, který dělá z pluginu spolehlivou službu v ChatGPT a Codex.