Zistite, ako importovať trhovisko doplnkov z GitHubu, spravovať prístup v pracovnom priestore a udržiavať jeho doplnky aktuálne.

Prehľad

Správcovia pracovného priestoru môžu importovať trhovisko doplnkov z GitHubu do adresára svojho pracovného priestoru. Trhovisko je katalóg vo formáte JSON so zoznamom doplnkov na import. Po importe denná synchronizácia udržiava doplnky aktuálne podľa zmien v repozitári.

Synchronizácia trhoviska importuje obsah doplnkov – nepripája účty členov pracovného priestoru ani neudeľuje prístup k aplikáciám zahrnutým v doplnku.

Úvodné informácie o doplnkoch a aplikáciách, ktoré obsahujú, nájdete v článku Doplnky v ChatGPT a Codexe.

Skôr než začnete

Použite účet GitHub s prístupom na čítanie k repozitáru trhoviska a ku všetkým ďalším repozitárom, na ktoré odkazuje. Podporované sú verejné aj súkromné repozitáre na github.com.
Získajte všetky schválenia organizácie na GitHube potrebné na to, aby mal účet používaný na import prístup k týmto repozitárom.
Skontrolujte obsah repozitára. Import spracuje všetky platné doplnky bez samostatného schvaľovania každého z nich a budúce synchronizácie môžu pridať nové doplnky.

Nové doplnky majú predvolene nastavenú inštaláciu na Dostupné a overovanie pri inštalácii. Nové trhoviská majú zapnutú automatickú dennú synchronizáciu. Po importe skontrolujte nastavenia každého doplnku v pracovnom priestore a jeho požadované aplikácie.

Import trhoviska

Prejdite do Konzoly správcu, vyberte požadovaný pracovný priestor ChatGPT a otvorte sekciu Doplnky. Potom vyberte Pridať a zvoľte Importovať trhovisko.
Do poľa Zdroj zadajte URL adresu repozitára, napríklad https://github.com/example/team-plugins. Použite iba URL adresu repozitára, nie adresu vetvy alebo priečinka.
Ak sa trhovisko nachádza v podadresári, zadajte tento adresár do poľa Cesta. Napríklad pre team-tools/.agents/plugins/marketplace.json zadajte team-tools. Ak ide o koreňový adresár repozitára, pole Cesta nechajte prázdne. Nezadávajte názov súboru manifestu.
Voliteľne vyplňte pole Vetva, značka alebo commit. Ak ho necháte prázdne, použije sa predvolená vetva repozitára. Ak chcete prijímať budúce commity, použite vetvu. Ak zadáte konkrétny commit, verzia zostane nemenná.
Vyberte Importovať trhovisko a po zobrazení výzvy povoľte prístup ku GitHubu.
Skontrolujte Výsledky importu a potom otvorte každý importovaný doplnok a nastavte jeho zásady inštalácie a všetky požadované aplikácie.

Pri veľmi veľkých trhoviskách môže úvodný import trvať až 1 hodinu. Následné denné synchronizácie zvyčajne trvajú niekoľko minút.

Ak sa doplnok nedá importovať, v správe nájdete vysvetlenie chyby. Ostatné platné doplnky sa môžu importovať aj napriek tomu.

Podporované formáty

Vybraný adresár musí obsahovať podporovaný manifest:

.agents/plugins/marketplace.json pre trhovisko Codex.
.claude-plugin/marketplace.json pre trhovisko kompatibilné s Claude.
.claude-plugin/plugin.json pre samostatný doplnok Claude, ak nie je prítomný manifest trhoviska.

Položky trhoviska môžu odkazovať na priečinky doplnkov v rovnakom repozitári alebo na podporované zdroje v repozitároch na GitHube. Import do pracovného priestoru nepodporuje iné hostingové služby pre Git ani zdroje z registrov balíkov, napríklad npm.

Podporované formáty, príklady JSON a polia zdrojov nájdete v dokumentácii Správa doplnkov.

Nastavenie prístupu v pracovnom priestore

GitHub poskytuje obsah doplnkov, zatiaľ čo nastavenia pracovného priestoru riadia inštaláciu a overovanie. Pri importe a synchronizácii sa neuplatňujú hodnoty zásad z repozitára, napríklad AVAILABLE alebo ON_USE. Tieto nastavenia nakonfigurujte pre každý doplnok vo svojom pracovnom priestore.

V časti Zásady inštalácie vyberte pre každú oprávnenú rolu možnosť Dostupné alebo Nainštalované. Požadované aplikácie musia byť tiež povolené a členovia musia mať prístup k pripojenej službe a vykonať všetky požadované overenia.

Pri synchronizácii aktualizácie doplnku alebo presune existujúceho doplnku pod správu cez GitHub sa zachovajú jeho zásady pracovného priestoru. Import doplnku neudeľuje prístup k aplikáciám ani nepripája účty členov.

Informácie o navigácii v pracovnom priestore, prístupe k aplikáciám a ovládacích prvkoch pracovného priestoru nájdete v článku Ovládacie prvky správcu, zabezpečenie a súlad s predpismi pre doplnky a aplikácie.

Udržiavanie doplnkov v aktuálnom stave

Nové trhoviská denne kontrolujú dostupnosť aktualizácií. Ak chcete požiadať o aktualizáciu bez čakania na automatickú synchronizáciu:

Prejdite do Konzoly správcu, vyberte požadovaný pracovný priestor ChatGPT a otvorte sekciu Doplnky.
Otvorte sekciu Trhoviská a vyberte trhovisko.
Vyberte Synchronizovať teraz.

Synchronizácia môže pridať nové položky trhoviska a aktualizovať existujúce doplnky. Pred zlúčením zmien v repozitári ich skontrolujte, pretože automatická synchronizácia môže importovať nové doplnky bez ďalšieho manuálneho importu.

Kontrola výsledkov synchronizácie

Po synchronizácii skontrolujte jej stav a uloženú správu. Stav Dokončené — počet chýb: N znamená, že synchronizácia sa skončila, ale niektoré doplnky sa nepodarilo spracovať.

Ak je aktualizácia existujúceho doplnku neplatná, zachová sa jeho posledná funkčná verzia. Ostatné platné aktualizácie sa môžu dokončiť aj napriek tomu. Opravte nahlásený problém na GitHube a potom vyberte Synchronizovať teraz, čím synchronizáciu zopakujete.

Ak sa vám v zobrazení správcu pri samostatne importovanom doplnku zobrazuje možnosť Obnoviť, použite ju na obnovenie tohto doplnku. Možnosť Obnoviť zoznam doplnkov iba znova načíta zobrazený zoznam; nespúšťa synchronizáciu z GitHubu.

Ako funguje odstránenie a vymazanie

Odstránením položky z repozitára sa nevymaže jej importovaná kópia v pracovnom priestore. Doplnok sa označí štítkom Už nie je v zdroji.

Vymazaním trhoviska v ChatGPT sa vymažú všetky doplnky, ktoré z neho boli importované. Trhovisko nevymazávajte, ak chcete znova pripojiť GitHub alebo zmeniť vlastníka.

Opätovné pripojenie alebo zmena prístupu ku GitHubu

Synchronizácia trhoviska používa pripojenie ku GitHubu správcu, ktorý ho importoval. Tento účet musí mať naďalej prístup k repozitáru trhoviska aj ku všetkým repozitárom, na ktoré odkazuje.

Opätovné pripojenie pôvodného účtu

Overte, či má účet GitHub použitý na import stále prístup ku všetkým požadovaným repozitárom.
Požiadajte správcu, ktorý pôvodne importoval trhovisko, aby v ChatGPT otvoril doplnok GitHub a znova pripojil svoj účet.

Prenos na nového správcu

Nový správca pracovného priestoru môže importovať rovnaké trhovisko pomocou vlastného pripojenia ku GitHubu:

Prejdite do Konzoly správcu, vyberte požadovaný pracovný priestor ChatGPT a otvorte sekciu Doplnky. Potom vyberte Pridať > Importovať trhovisko.
Do polí Zdroj, Cesta a Vetva, značka alebo commit zadajte rovnaké hodnoty, aké sú použité pre existujúce trhovisko.
Vyberte Importovať trhovisko a po zobrazení výzvy povoľte prístup ku GitHubu.

Budúce synchronizácie budú používať pripojenie ku GitHubu nového správcu. Účet nového správcu musí mať prístup na čítanie k repozitáru trhoviska a ku každému repozitáru, na ktorý odkazuje.

Presun existujúceho doplnku pod správu cez GitHub

Pomocou trhoviska môžete spravovať existujúci doplnok pracovného priestoru, ktorý bol nahraný ako archív alebo ho zatiaľ nespravuje žiadny zdroj na GitHube. Existujúci doplnok musí byť v rovnakom pracovnom priestore a musí mať rovnaký názov. Takto nemožno prevziať správu doplnku, ktorý spravuje iný zdroj na GitHube.

Ak chcete vo svojom trhovisku identifikovať existujúci doplnok:

Prejdite do Konzoly správcu, vyberte požadovaný pracovný priestor ChatGPT a otvorte sekciu Doplnky. Otvorte doplnok.
Skopírujte ID doplnku, ktoré sa v jeho URL adrese nachádza za /admin/plugins/.
Pridajte toto ID ako pluginId vedľa name a source do príslušnej položky poľa plugins v trhovisku. Nepridávajte ho do súboru plugin.json doplnku.

Doplnok si zachová svoje ID, nastavenia zdieľania a zásady pracovného priestoru. GitHub sa stane zdrojom budúcich aktualizácií, takže doplnok už nebude možné nahradiť nahraním archívu.

Príklad migrácie a požiadavky nájdete v dokumentácii Správa doplnkov.

Odkazovanie na existujúcu aplikáciu

Doplnok môže odkazovať na existujúcu aplikáciu v súbore .app.json v koreňovom adresári doplnku. V názve súboru nezabudnite na úvodnú bodku a namiesto ID doplnku použite ID aplikácie. Pri natívnom doplnku nastavte pole apps v súbore .codex-plugin/plugin.json na hodnotu ./.app.json.

Odkaz nevytvára aplikáciu ani neudeľuje ďalšie povolenia. Naďalej platia existujúce nastavenia prístupu k aplikácii v pracovnom priestore, overovania, ovládania akcií a povolení pripojenej služby.

Informácie o formáte JSON nájdete v dokumentácii Správa doplnkov.

Čo znamená štítok Len pre počítače

Doplnok označený štítkom Len pre počítače nemožno spustiť vo webovej verzii ChatGPT. Importované doplnky môžu dostať tento štítok, ak deklarujú servery MCP, napríklad v súbore mcp.json alebo .mcp.json, a to aj vtedy, keď server používa vzdialenú URL adresu HTTPS.

Samotné pridanie odkazu v súbore .app.json neodstráni štítok Len pre počítače. Každá odkazovaná aplikácia musí byť aj naďalej dostupná pre rolu člena a platia pre ňu bežné požiadavky na prístup a overovanie.

Import a synchronizácia trhovísk doplnkov z GitHubu