Áttekintés

A munkaterület adminisztrátorai beépülőmodul-piacteret importálhatnak a GitHubról a munkaterület katalógusába. A piactér egy JSON-katalógus, amely az importálandó beépülő modulokat sorolja fel. Az importálás után a napi szinkronizálás az adattár változásai alapján naprakészen tartja a beépülő modulokat.


A piactér szinkronizálása a beépülő modulok tartalmát importálja – nem kapcsolja össze a munkaterület tagjainak fiókjait, és nem biztosít hozzáférést a beépülő modulokban szereplő alkalmazásokhoz.


A beépülő modulokról és a bennük szereplő alkalmazásokról itt találsz bevezetőt: Beépülő modulok a ChatGPT-ben és a Codexben.

Mielőtt elkezdenéd

• Olyan GitHub-fiókot használj, amely olvasási hozzáféréssel rendelkezik a piactér adattárához és minden más adattárhoz, amelyre az hivatkozik. A github.com nyilvános és privát adattárai egyaránt támogatottak.

• Szerezd be a GitHub-szervezet minden szükséges jóváhagyását, hogy az importáláshoz használt fiók hozzáférhessen ezekhez az adattárakhoz.

• Tekintsd át az adattár tartalmát. Az importálás minden érvényes beépülő modult feldolgoz, modulonkénti külön jóváhagyás nélkül, és a későbbi szinkronizálások új modulokat is hozzáadhatnak.

Az új beépülő modulok kezdetben Elérhető telepítési beállítást kapnak, és telepítéskor hitelesítést igényelnek. Az új piactereken engedélyezve van az automatikus napi szinkronizálás. Az importálás után tekintsd át az egyes beépülő modulok munkaterületi beállításait és a hozzájuk szükséges alkalmazásokat.

Piactér importálása

1. Lépj az Adminisztrációs konzolra, válaszd ki a kívánt ChatGPT-munkaterületet, és nyisd meg a Beépülő modulok oldalt. Ezután válaszd a Hozzáadás, majd a Piactér importálása lehetőséget.

2. A Forrás mezőben add meg az adattár URL-címét, például: https://github.com/example/team-plugins. Csak az adattár URL-címét használd, ne egy ág vagy mappa URL-címét.

3. Ha a piactér egy alkönyvtárban található, add meg azt az Elérési út mezőben. A team-tools/.agents/plugins/marketplace.json esetén például a team-tools értéket add meg. Az adattár gyökérkönyvtárához hagyd üresen az Elérési út mezőt. Ne add meg a manifest fájlnevét.

4. Igény szerint töltsd ki az Ág, címke vagy commit mezőt. Az adattár alapértelmezett ágának használatához hagyd üresen. A későbbi commitok átvételéhez adj meg egy ágat. Rögzített commit esetén a verzió nem változik.

5. Válaszd a Piactér importálása lehetőséget, és amikor a rendszer kéri, engedélyezd a GitHub-hozzáférést.

6. Tekintsd át az Importálás eredményei részt, majd nyisd meg az összes importált beépülő modult a telepítési házirend és a szükséges alkalmazások beállításához.

Nagyon nagy piacterek esetén az első importálás akár 1 órát is igénybe vehet. A későbbi napi szinkronizálások általában néhány percig tartanak.

Ha egy beépülő modul nem importálható, a jelentés ismerteti a hibát. A többi érvényes beépülő modul ettől még importálható.

Támogatott formátumok

A kiválasztott könyvtárnak tartalmaznia kell egy támogatott manifestet:

• .agents/plugins/marketplace.json a Codex-piacterekhez.

• .claude-plugin/marketplace.json a Claude-kompatibilis piacterekhez.

• .claude-plugin/plugin.json az önálló Claude beépülő modulokhoz, ha nincs piactéri manifest.

A piactéri bejegyzések hivatkozhatnak az ugyanabban az adattárban lévő beépülőmodul-mappákra vagy támogatott GitHub-adattárforrásokra. A munkaterületre történő importálás nem támogat más Git-tárhelyeket és csomagregiszter-forrásokat, például az npm-et.

A támogatott formátumokról, JSON-példákról és forrásmezőkről itt olvashatsz: Beépülő modulok kezelése.

Munkaterületi hozzáférés beállítása

A beépülő modul tartalmát a GitHub biztosítja, míg a telepítést és a hitelesítést a munkaterület beállításai szabályozzák. Az importálás és a szinkronizálás nem alkalmazza az adattár házirendértékeit, például az AVAILABLE vagy az ON_USE értéket. Ezeket a munkaterület minden beépülő moduljánál külön állítsd be.


A Telepítési házirend alatt válaszd az Elérhető vagy a Telepítve beállítást minden jogosult szerepkörhöz. A szükséges alkalmazásokat is engedélyezni kell, a tagoknak pedig hozzá kell férniük a csatlakoztatott szolgáltatáshoz, és el kell végezniük a szükséges hitelesítést.


A beépülő modul frissítésének szinkronizálása vagy egy meglévő modul GitHub-alapú kezelésre való átállítása megőrzi a munkaterületi házirendeket. A beépülő modul importálása nem biztosít hozzáférést az alkalmazásokhoz, és nem kapcsolja össze a tagok fiókjait.


A munkaterületen való navigációról, az alkalmazásokhoz való hozzáférésről és a munkaterület szabályozási lehetőségeiről itt olvashatsz: A beépülő modulok és alkalmazások adminisztrátori vezérlői, biztonsága és megfelelősége.

Beépülő modulok naprakészen tartása

Az új piacterek naponta ellenőrzik, hogy van-e frissítés. Ha az automatikus szinkronizálás megvárása nélkül szeretnél frissítést kérni:

1. Lépj az Adminisztrációs konzolra, válaszd ki a kívánt ChatGPT-munkaterületet, és nyisd meg a Beépülő modulok oldalt.

2. Nyisd meg a Piacterek oldalt, és válaszd ki a piacteret.

3. Válaszd a Szinkronizálás most lehetőséget.

A szinkronizálás új piactéri bejegyzéseket adhat hozzá, és frissítheti a meglévő beépülő modulokat. Az egyesítés előtt tekintsd át az adattár módosításait, mert az automatikus szinkronizálás külön importálási lépés nélkül is importálhat új beépülő modulokat.

Szinkronizálási eredmények áttekintése

A szinkronizálás után tekintsd át annak állapotát és mentett jelentését. A Befejezve – N hiba állapot azt jelenti, hogy a szinkronizálás befejeződött, de néhány beépülő modult nem sikerült feldolgozni.


Ha egy meglévő beépülő modul frissítése érvénytelen, a legutóbbi működő verziója marad meg. A többi érvényes frissítés ettől még befejeződhet. Javítsd ki a jelentésben jelzett problémát a GitHubon, majd az újrapróbálkozáshoz válaszd a Szinkronizálás most lehetőséget.


Ha az adminisztrátori nézetben egy külön importált beépülő modulnál megjelenik a Frissítés lehetőség, ezzel frissítheted az adott modult. A Beépülő modulok listájának frissítése csak a megjelenített listát tölti újra; nem szinkronizál a GitHubról.

Tudnivalók az eltávolításról és a törlésről

Ha eltávolítasz egy bejegyzést az adattárból, a munkaterületre importált példánya nem törlődik. A beépülő modul a Már nem szerepel a forrásban jelölést kapja.


Ha törlöd a piacteret a ChatGPT-ben, az összes belőle importált beépülő modul is törlődik. Ne töröld a piacteret a GitHub-kapcsolat helyreállításához vagy a tulajdonos módosításához.

GitHub-kapcsolat helyreállítása vagy a hozzáférés módosítása

A piactér szinkronizálása az importálást végző adminisztrátor GitHub-kapcsolatát használja. Ennek a fióknak folyamatos hozzáférésre van szüksége a piactér adattárához és az összes hivatkozott adattárhoz.

Az eredeti fiók újbóli csatlakoztatása

1. Ellenőrizd, hogy az importáláshoz használt GitHub-fiók továbbra is hozzáfér-e az összes szükséges adattárhoz.

2. Kérd meg a piacteret eredetileg importáló adminisztrátort, hogy nyissa meg a GitHub beépülő modult a ChatGPT-ben, és csatlakoztassa újra a fiókját.

Átadás új adminisztrátornak

A munkaterület új adminisztrátora a saját GitHub-kapcsolatával importálhatja ugyanazt a piacteret:

1. Lépj az Adminisztrációs konzolra, válaszd ki a kívánt ChatGPT-munkaterületet, és nyisd meg a Beépülő modulok oldalt. Ezután válaszd a Hozzáadás > Piactér importálása lehetőséget.

2. A Forrás, az Elérési út és az Ág, címke vagy commit mezőkben ugyanazokat az értékeket add meg, amelyeket a meglévő piactér használ.

3. Válaszd a Piactér importálása lehetőséget, és amikor a rendszer kéri, engedélyezd a GitHub-hozzáférést.

A későbbi szinkronizálások az új adminisztrátor GitHub-kapcsolatát használják. Az új adminisztrátor fiókjának olvasási hozzáféréssel kell rendelkeznie a piactér adattárához és minden adattárhoz, amelyre az hivatkozik.

Meglévő beépülő modul átállítása GitHub-alapú kezelésre

Piactérrel kezelheted a munkaterület olyan meglévő beépülő modulját, amelyet archívumként töltöttek fel, vagy amelyet még nem GitHub-forrásból kezelnek. A meglévő beépülő modulnak ugyanazon a munkaterületen kell lennie, és a nevének is meg kell egyeznie. Egy másik GitHub-forrásból kezelt beépülő modul kezelése így nem vehető át.


A meglévő beépülő modul azonosításához a piactéren:

1. Lépj az Adminisztrációs konzolra, válaszd ki a kívánt ChatGPT-munkaterületet, és nyisd meg a Beépülő modulok oldalt. Nyisd meg a beépülő modult.

2. Másold ki a beépülő modul azonosítóját az URL-címében található /admin/plugins/ rész után.

3. Add hozzá ezt az azonosítót pluginId értékként a name és a source mellé a piactér plugins tömbjének megfelelő bejegyzésében. Ne add hozzá a beépülő modul plugin.json fájljához.

A beépülő modul megőrzi azonosítóját, megosztási beállításait és munkaterületi házirendjeit. A későbbi frissítések forrása a GitHub lesz, így a modul ezután már nem cserélhető le archívum feltöltésével.


Az átállásra vonatkozó példát és követelményeket itt találod: Beépülő modulok kezelése.

Hivatkozás meglévő alkalmazásra

A beépülő modul a gyökérkönyvtárában lévő .app.json fájlban hivatkozhat egy meglévő alkalmazásra. A fájlnév elejéről ne hagyd le a pontot, és az alkalmazás azonosítóját használd, ne egy beépülő modulét. Natív beépülő modul esetén a .codex-plugin/plugin.json fájl apps mezőjének értékét állítsd erre: ./.app.json.


A hivatkozás nem hoz létre alkalmazást, és nem ad további jogosultságokat. Az alkalmazás munkaterületi hozzáférésére, hitelesítésére és műveleteire vonatkozó meglévő szabályok, valamint a csatlakoztatott szolgáltatás jogosultságai továbbra is érvényesek.


A JSON-formátumról itt olvashatsz: Beépülő modulok kezelése.

Mit jelent a „Csak asztali alkalmazásban” címke?

A Csak asztali alkalmazásban jelölésű beépülő modulok nem futtathatók a ChatGPT webes felületén. Az importált beépülő modulok akkor kaphatják ezt a címkét, ha MCP-szervereket deklarálnak, például az mcp.json vagy a .mcp.json fájlban, még akkor is, ha a szerver távoli HTTPS URL-címet használ.


Egy .app.json hivatkozás hozzáadása önmagában nem távolítja el a Csak asztali alkalmazásban címkét. Minden hivatkozott alkalmazásnak továbbra is elérhetőnek kell lennie a tag szerepköre számára, és az alkalmazás szokásos hozzáférési és hitelesítési követelményei is érvényesek.