Pregled

Skrbniki delovnega prostora lahko iz GitHuba uvozijo tržnico dodatkov v katalog svojega delovnega prostora. Tržnica je katalog v obliki JSON, ki vsebuje seznam dodatkov za uvoz. Po uvozu dnevna sinhronizacija posodablja dodatke s spremembami iz repozitorija.


Sinhronizacija tržnice uvozi vsebino dodatkov – ne poveže računov članov delovnega prostora in ne odobri dostopa do aplikacij, vključenih v dodatek.


Za uvod v dodatke in aplikacije, ki jih vključujejo, glejte: Dodatki v storitvah ChatGPT in Codex.

Preden začnete

• Uporabite račun GitHub z dovoljenjem za branje repozitorija tržnice in vseh drugih repozitorijev, na katere se ta sklicuje. Podprti so javni in zasebni repozitoriji na github.com.

• Pridobite vse odobritve organizacije v GitHubu, ki jih račun za uvoz potrebuje za dostop do teh repozitorijev.

• Preglejte vsebino repozitorija. Uvoz obdela vse veljavne dodatke brez ločene odobritve vsakega posebej, prihodnje sinhronizacije pa lahko dodajo nove dodatke.

Novi dodatki imajo sprva pravilnik namestitve Na voljo in preverjanje pristnosti ob namestitvi. Nove tržnice imajo omogočeno samodejno dnevno sinhronizacijo. Po uvozu za vsak dodatek preglejte nastavitve v delovnem prostoru in zahtevane aplikacije.

Uvoz tržnice

1. Pojdite v skrbniško konzolo, izberite želeni delovni prostor ChatGPT in odprite Dodatki. Nato izberite Dodaj in Uvozi tržnico.

2. V polje Vir vnesite URL repozitorija, na primer https://github.com/example/team-plugins. Uporabite samo URL repozitorija, ne URL-ja veje ali mape.

3. Če je tržnica v podmapi, vnesite to mapo v polje Pot. Za team-tools/.agents/plugins/marketplace.json na primer vnesite team-tools. Za korensko mapo repozitorija pustite polje Pot prazno. Ne vnašajte imena datoteke manifest.

4. Po želji izpolnite polje Veja, oznaka ali potrditev. Če želite uporabiti privzeto vejo repozitorija, pustite polje prazno. Za prejemanje prihodnjih potrditev uporabite vejo. Če izberete določeno potrditev, ostane vsebina pri tej reviziji.

5. Izberite Uvozi tržnico in ob pozivu odobrite dostop do GitHuba.

6. Preglejte Rezultati uvoza, nato odprite vsak uvoženi dodatek ter nastavite njegov pravilnik namestitve in morebitne zahtevane aplikacije.

Začetni uvoz zelo velikih tržnic lahko traja do 1 ure. Naslednje dnevne sinhronizacije običajno trajajo nekaj minut.

Če dodatka ni mogoče uvoziti, je napaka pojasnjena v poročilu. Druge veljavne dodatke je še vedno mogoče uvoziti.

Podprte oblike

Izbrana mapa mora vsebovati podprt manifest:

• .agents/plugins/marketplace.json za tržnico Codex.

• .claude-plugin/marketplace.json za tržnico, združljivo s storitvijo Claude.

• .claude-plugin/plugin.json za samostojni dodatek Claude, kadar manifest tržnice ni prisoten.

Vnosi v tržnici se lahko sklicujejo na mape dodatkov v istem repozitoriju ali na podprte vire iz repozitorijev GitHub. Uvoz v delovni prostor ne podpira drugih ponudnikov gostovanja Git in virov iz registrov paketov, kot je npm.

Za podprte oblike, primere JSON in polja za vire glejte: Upravljanje dodatkov.

Nastavitev dostopa v delovnem prostoru

GitHub zagotavlja vsebino dodatka, nastavitve delovnega prostora pa nadzorujejo namestitev in preverjanje pristnosti. Uvoz in sinhronizacija ne uveljavita vrednosti pravilnikov iz repozitorija, kot sta AVAILABLE ali ON_USE. Te nastavitve določite za vsak dodatek v svojem delovnem prostoru.


V razdelku Pravilnik namestitve za vsako upravičeno vlogo izberite Na voljo ali Nameščeno. Omogočene morajo biti tudi zahtevane aplikacije, člani pa morajo imeti dostop do povezane storitve in opraviti morebitno zahtevano preverjanje pristnosti.


Pri sinhronizaciji posodobitve dodatka ali prenosu upravljanja obstoječega dodatka v GitHub se ohranijo njegovi pravilniki delovnega prostora. Uvoz dodatka ne odobri dostopa do aplikacij in ne poveže računov članov.


Za krmarjenje po delovnem prostoru, dostop do aplikacij in nadzorne nastavitve delovnega prostora glejte: Skrbniški nadzor, varnost in skladnost za dodatke in aplikacije.

Posodabljanje dodatkov

Nove tržnice vsak dan preverjajo, ali so na voljo posodobitve. Če želite sprožiti posodobitev brez čakanja na samodejno sinhronizacijo:

1. Pojdite v skrbniško konzolo, izberite želeni delovni prostor ChatGPT in odprite Dodatki.

2. Odprite Tržnice in izberite tržnico.

3. Izberite Sinhroniziraj zdaj.

Sinhronizacija lahko doda nove vnose iz tržnice in posodobi obstoječe dodatke. Pred združitvijo preglejte spremembe v repozitoriju, saj lahko samodejna sinhronizacija uvozi nove dodatke brez ponovnega ročnega uvoza.

Pregled rezultatov sinhronizacije

Po sinhronizaciji preglejte njeno stanje in shranjeno poročilo. Dokončano — N napak pomeni, da se je sinhronizacija končala, vendar nekaterih dodatkov ni bilo mogoče obdelati.


Če posodobitev obstoječega dodatka ni veljavna, se ohrani njegova zadnja delujoča različica. Druge veljavne posodobitve se lahko vseeno dokončajo. Odpravite težavo, navedeno v poročilu, v GitHubu in nato izberite Sinhroniziraj zdaj za ponovni poskus.


Če je v skrbniškem pogledu za posamično uvožen dodatek prikazana možnost Osveži, jo uporabite za osvežitev tega dodatka. Možnost Osveži seznam dodatkov le znova naloži prikazani seznam; ne izvede sinhronizacije z GitHubom.

Razlika med odstranitvijo in izbrisom

Če vnos odstranite iz repozitorija, se njegova uvožena kopija v delovnem prostoru ne izbriše. Dodatek dobi oznako Ni več v viru.


Če tržnico izbrišete v storitvi ChatGPT, se izbrišejo vsi dodatki, uvoženi iz nje. Tržnice ne izbrišite zato, da bi znova vzpostavili povezavo z GitHubom ali spremenili lastništvo.

Ponovna povezava ali sprememba dostopa do GitHuba

Sinhronizacija tržnice uporablja povezavo z GitHubom skrbnika, ki jo je uvozil. Ta račun mora ohraniti dostop do repozitorija tržnice in vseh repozitorijev, na katere se ta sklicuje.

Ponovna povezava prvotnega računa

1. Preverite, ali ima račun GitHub, uporabljen za uvoz, še vedno dostop do vseh zahtevanih repozitorijev.

2. Prosite skrbnika, ki je prvotno uvozil tržnico, naj v storitvi ChatGPT odpre dodatek GitHub in znova poveže svoj račun.

Prenos na novega skrbnika

Novi skrbnik delovnega prostora lahko isto tržnico uvozi s svojo povezavo z GitHubom:

1. Pojdite v skrbniško konzolo, izberite želeni delovni prostor ChatGPT in odprite Dodatki. Nato izberite Dodaj > Uvozi tržnico.

2. V polja Vir, Pot in Veja, oznaka ali potrditev vnesite enake vrednosti, kot so bile uporabljene za obstoječo tržnico.

3. Izberite Uvozi tržnico in ob pozivu odobrite dostop do GitHuba.

Prihodnje sinhronizacije bodo uporabljale povezavo novega skrbnika z GitHubom. Račun novega skrbnika mora imeti dovoljenje za branje repozitorija tržnice in vseh repozitorijev, na katere se ta sklicuje.

Prenos upravljanja obstoječega dodatka v GitHub

S tržnico lahko upravljate obstoječi dodatek v delovnem prostoru, ki je bil naložen kot arhiv ali ga še ne upravlja vir v GitHubu. Obstoječi dodatek mora biti v istem delovnem prostoru in imeti enako ime dodatka. Dodatka, ki ga upravlja drug vir v GitHubu, ni mogoče prevzeti na ta način.


Če želite v tržnici določiti obstoječi dodatek:

1. Pojdite v skrbniško konzolo, izberite želeni delovni prostor ChatGPT in odprite Dodatki. Odprite dodatek.

2. Kopirajte ID dodatka, ki je v njegovem URL-ju za /admin/plugins/.

3. Ta ID dodajte kot pluginId poleg polj name in source v ustreznem vnosu polja plugins v tržnici. Ne dodajajte ga v datoteko plugin.json dodatka.

Dodatek ohrani svoj ID, nastavitve skupne rabe in pravilnike delovnega prostora. GitHub postane vir za prihodnje posodobitve, zato dodatka pozneje ni mogoče nadomestiti z nalaganjem arhivov.


Za primer selitve in zahteve glejte: Upravljanje dodatkov.

Sklicevanje na obstoječo aplikacijo

Dodatek se lahko sklicuje na obstoječo aplikacijo v datoteki .app.json v korenski mapi dodatka. V ime datoteke vključite začetno piko in uporabite ID aplikacije, ne ID-ja dodatka. Za izvorni dodatek nastavite polje apps v datoteki .codex-plugin/plugin.json na ./.app.json.


Sklic ne ustvari aplikacije in ne dodeli dodatnih dovoljenj. Za aplikacijo še vedno veljajo obstoječe nastavitve dostopa v delovnem prostoru, preverjanja pristnosti in nadzora dejanj ter dovoljenja za povezane storitve.


Za obliko JSON glejte: Upravljanje dodatkov.

Pomen oznake Samo za namizno aplikacijo

Dodatek z oznako Samo za namizno aplikacijo ne more delovati v spletni različici storitve ChatGPT. Uvoženi dodatki lahko dobijo to oznako, če določajo strežnike MCP, na primer v datoteki mcp.json ali .mcp.json, tudi če strežnik uporablja oddaljeni URL HTTPS.


Dodajanje sklica v datoteki .app.json samo po sebi ne odstrani oznake Samo za namizno aplikacijo. Vsaka aplikacija, na katero se dodatek sklicuje, mora biti še vedno na voljo vlogi člana, zanjo pa veljajo običajne zahteve za dostop in preverjanje pristnosti.