Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Optimalizálás: Metaadatok, készségek és események

14. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. A metaadat termék-szöveg
  2. Készségek ismétlődő munkafolyamatokhoz
  3. MCP események: Reagálás a változásokra
  4. ChatGPT felület-bővítmények
  5. Főbb megállapítások
  6. Teszteld a tudásod

A leckét 2026. november 3-án írtuk át az OpenAI Plugins dokumentáció Optimize Metadata, Build Skills, MCP Events és Plugin Extensions oldalai alapján. A lecke előző verziója egy nem létező SDK analytics és experiment moduljaira támaszkodott. Források: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.

A metaadat termék-szöveg

A ChatGPT és a Codex a megadott metaadatok alapján dönti el, mikor hívja meg az eszközeidet. A jól megírt nevek, leírások és paraméterek biztosítják, hogy az eszközöd akkor aktiválódjon, amikor szükség van rá, és megelőzik a nem kívánt indításokat. Az OpenAI azt javasolja, hogy ezeket a metaadatokat termék-szövegként kezeld: iteráld őket, teszteld, és mérd a teljesítményüket.

Referencia prompt-készlet

Mielőtt hozzányúlnál a metaadataidhoz, készíts egy címkézett teszt-prompt készletet:

  • Közvetlen promptok, amelyek explicit módon megnevezik a termékedet vagy az adatforrásodat.
  • Közvetett promptok, amelyek leírják a kívánt kimenetelt anélkül, hogy megneveznék az eszközödet.
  • Negatív promptok, amelyeket a beépített eszközöknek vagy más bővítményeknek kell kezelniük.

Minden prompt esetén dokumentáld a várt viselkedést: hívja meg az eszközödet, ne tegyen semmit, vagy halassza át a feladatot egy másik megoldásnak. Használd ezt a készletet minden nem-regressziós tesztnél.

A modellt irányító metaadatok

  • A név kombinálja a domaint és a műveletet, például: calendar.create_event.
  • A leírás a „Használd, amikor…“ kifejezéssel kezdődjön, és explicit módon sorolja fel a kizárt eseteket, például: „Ne használd emlékeztetőkhöz.“
  • Minden paramétert példákkal kell dokumentálni, és felsorolni az engedélyezett értékeket, ha a bemenet korlátozott.
  • Az annotációknak tükrözniük kell a tényleges viselkedést (lásd a 3. és 11. leckét).

Mérj, majd iterálj

Csatlakoztasd a szerveredet, telepítsd a bővítményt, futtasd a prompt-készletedet, és jegyezd fel, melyik eszközt választotta a rendszer, milyen argumentumokat adott át, és jelent-e meg valamilyen UI-komponens. Kövess nyomon két mutatót: a pontosságot (a megfelelő eszközt hívta meg?) és a teljességet (minden alkalommal meghívta az eszközt, amikor kellett?). Először a negatív promptoknál törekedj magas pontosságra, mielőtt a teljesség marginális javítására törekednél.

Egyszerre csak egy mezőt módosíts, hogy izoláld, mi okozza a javulást. Vezess dátumozott revíziós naplót az eredményekkel, és telepítés előtt kérd meg valakit, hogy vizsgálja felül a változtatásokat. Éles környezetben hetente vizsgáld felül az eszközhasználatot. A „rossz eszköz“ megerősítések hirtelen növekedése általában metaadat-elcsúszást jelez. Gyűjts felhasználói visszajelzést, és rendszeresen futtasd újra a prompt-teszteket, különösen új eszköz hozzáadása vagy egy strukturált mező módosítása után.

Készségek ismétlődő munkafolyamatokhoz

A szervered adatokat, hitelesítést és vezérelt műveleteket biztosít. Egy készség (skill) az eszközhívások sorozatát, a döntési pontokat, a kimenet formázását, példákat és sablonokat tartalmazza. A leggyorsabb kezdés a beépített @skill-creator használata, ahol leírod a felhasználó célját és az azt támogató MCP eszközöket.

Egy erős SKILL.md fájl meghatározza, mely lépéseket kell követni, milyen eredményt kell kapnia a felhasználónak, milyen tényeket nem találhat ki a modell, mikor kell kérdéseket feltenni, megállni vagy elutasítani a kérést, és mely fájlokat kell konzultálni. Részesítsd előnyben az adott munkafolyamatra fókuszáló készséget a szétszórt utasítások nagy halmazával szemben. Válaszd szét azokat a munkafolyamatokat, amelyek eltérnek a kiváltó okukban, bemeneteikben vagy sikerfeltételeikben. Tartsd tömören a SKILL.md fájlt, és a részleteket tárold máshol: használd a references/ mappát irányelvekhez, sémákhoz és példákhoz; az assets/ mappát másolandó vagy transzformálandó sablonokhoz; a scripts/ mappát pedig determinisztikus számításokhoz – de csak akkor, ha a meglévő utasítások és eszközök nem elegendőek.

Ha egy készség egy MCP szervertől függ, deklarálod ezt a függőséget az agents/openai.yaml fájlban. Ez elérhetővé teszi az eszközt, de nem helyettesíti azt a szükségletet, hogy világos utasításokat adj arról, mely eszközöket mikor és milyen sorrendben használja, valamint hogyan kezelje a hiányzó vagy ambivalens eredményeket. A GPT-6 Astra esetében az OpenAI azt tanácsolja, hogy vizsgáld felül az utasításkövetésre vonatkozó útmutatását: szüntesd meg a homályos vagy ellentmondó direktívákat, és tedd explicit módon egyértelművé, hogy a felhasználói utasítások elsőbbséget élveznek a készség utasításaival szemben.

Teszteld a készség aktiválódását és a kimenet minőségét közvetlen, közvetett, hiányos (amelynek tisztázó kérdést kell kiváltania), témán kívüli és perem eseteket lefedő promptokkal, ahol a készségnek kerülnie kell a hallucinálást vagy a hatáskörén kívüli cselekvést. Ha egy készség rossz időpontban aktiválódik, javítsd a leírását. Ha a megfelelő munkafolyamatot választja, de inkonzisztens eredményeket produkál, javítsd az utasításait.

MCP események: Reagálás a változásokra

Az MCP Events lehetővé teszi, hogy a ChatGPT feliratkozzon a szerveredről érkező frissítésekre, például új üzenetekre, módosított tartalmakra vagy állapotváltozásokra. A felhasználó dönti el, mit figyeljen, és hogyan reagáljon a ChatGPT egy frissítés érkezésekor – például: „Figyeld ezt a dokumentumot, és alkalmazd a megjegyzésekben kért korrekciókat.“

  1. A szervered felsorolja az általa támogatott eseményeket.
  2. A felhasználó megmondja a ChatGPT-nek, mit figyeljen és hogyan reagáljon.
  3. A ChatGPT feliratkozik az MCP szervereden keresztül, megadva egy visszahívási URL-t (callback URL) és egy aláíró titkot.
  4. A szervered elküldi a releváns eseményeket erre az URL-re.
  5. A ChatGPT fogadja az eseményt a feliratkozott beszélgetésben, és követi a felhasználó utasításait.

Ez a funkció a ChatGPT Work beszélgetésekben érhető el weben és az asztali alkalmazásban, ha a Cloud van kiválasztva. A ChatGPT az MCP Events specifikáció tervezetében meghatározott webhook-kézbesítésre támaszkodik. A szerverednek meg kell őriznie a feliratkozásokat, és képesnek kell lennie HTTPS-en keresztül elérni a visszahívási URL-eket.

ChatGPT felület-bővítmények

Az OpenAI MCP Extensions lehetővé teszi egy bővítmény számára, hogy integrálódjon a ChatGPT felület kulcsfontosságú területeibe: az oldalsávba, a beviteli területre és a fájlmegtekintőkbe. A beviteli területen történő említések csak az asztali alkalmazásban érhetők el. Az OpenAI közzétett egy minta bővítményt, a Bits & Bolts-ot, amely bemutatja ezeket a bővítményeket és nyomon követi azok telepítését. Ez a legjobb kiindulópont e képesség felfedezéséhez.

Főbb megállapítások

  • Kezeld a metaadatokat termék-szövegként: használj referencia prompt-készletet, kövesd nyomon a pontosságot és a teljességet, és egyszerre csak egy mezőt módosíts.
  • Írj olyan leírásokat, amelyek a „Használd, amikor…“ kifejezéssel kezdődnek, sorold fel explicit módon a kizárt eseteket, és dokumentáld az összes paramétert.
  • Hozz létre egy-egy fókuszált készséget minden munkafolyamathoz, tartsd tömören a SKILL.md fájlt, tárold az erőforrásokat külön, és deklaráld az MCP függőségeket.
  • Az MCP Events feliratkoztatja a ChatGPT-t a szervered frissítéseire, amelyek webhook-on keresztül érkeznek.
  • A bővítmények integrálják a pluginodat az oldalsávba, a beviteli területre és a fájlmegtekintőkbe.

Teszteld a tudásod

Az MCP eszközöktől a publikálásig: ellenőrizd, hogy elsajátítottad-e az alapokat.

1. Szükségem van egy `@openai/apps-sdk` csomagra alkalmazás létrehozásához a ChatGPT-ben?

Válasz: Nem, ez a csomag nem létezik. Egy MCP szervert építesz a hivatalos protokoll SDK-k segítségével (@modelcontextprotocol/sdk TypeScripthez, mcp Pythonhoz), opcionálisan hozzáadsz egy az MCP Apps szabványnak megfelelő felületet, és az egészet bővítményként terjeszted.

2. Létezhet-e eszköz felhasználói felület (UI) nélkül?

Válasz: Igen, és így is kell lennie: egy eszköz structuredContent-et és egy rövid szöveges összefoglalót ad vissza, ami elegendő a modell számára. A felhasználói felületet, amely a _meta.ui.resourceUri segítségével csatlakozik, csak akkor adjuk hozzá, ha segít a felhasználóknak az információk ellenőrzésében, összehasonlításában, szerkesztésében, megerősítésében vagy navigálásában.

3. Ki dönt arról, hogy a felhasználónak van-e jogosultsága az adatok hozzáféréséhez?

Válasz: Az MCP szerver dönt minden egyes kérésről a hitelesített OAuth token alapján (aláírás, kibocsátó, célközönség, lejárat, hatáskörök). Az annotációk segítik a ChatGPT-t a megfelelő megerősítési szint kiválasztásában, de sosem helyettesítik a szerveroldali autorizációt.

4. Árusíthat-e egy bővítmény előfizetést a szolgáltatására?

Válasz: Nem. A szabályok a kereskedelmet fizikai árukra korlátozzák. Egy meglévő előfizető bejelentkezhet és használhatja a csomagjában szereplő funkciókat. A bővítmény magyarázhatja, hogy egy funkció nem szerepel a csomagban, és hivatkozhat egy információs oldalra, de sosem hivatkozhat fizetési oldalra.

5. Hogyan frissülnek az eszközök egy közzétett bővítmény esetén?

Válasz: Új ZIP fájl nélkül: az OpenAI újra beolvassa a szervert, és minden új vagy módosított eszköz elérhetővé válik az automatizált ellenőrzések sikeres teljesítése után. Egy törölt eszköz azonnal eltűnik. A metaadatok és a készségek azonban új ZIP fájlt és új felülvizsgálatot igényelnek.

Jól leírt eszközök, opcionális felhasználói felületek, szerveroldali autorizáció és a szabályok betartása: ez az a keretrendszer, amely megbízható szolgáltatássá teszi a bővítményt a ChatGPT-ben és a Codexben.