Pregled

Administratori radnog prostora mogu uvesti tržnicu pluginova s GitHuba u katalog svojeg radnog prostora. Tržnica je katalog u JSON formatu koji sadrži popis pluginova za uvoz. Nakon uvoza svakodnevna sinkronizacija ažurira pluginove prema promjenama u repozitoriju.


Sinkronizacija tržnice uvozi sadržaj pluginova – ne povezuje račune članova radnog prostora niti odobrava pristup aplikacijama uključenima u plugin.


Uvod u pluginove i aplikacije koje sadrže potražite u članku Pluginovi u ChatGPT-u i Codexu.

Prije početka

• Upotrijebite GitHub račun s dozvolom za čitanje repozitorija tržnice i svih drugih repozitorija koje tržnica referencira. Podržani su javni i privatni repozitoriji na github.com.

• Ishodite sva potrebna odobrenja organizacije na GitHubu kako bi račun kojim se obavlja uvoz mogao pristupiti tim repozitorijima.

• Pregledajte sadržaj repozitorija. Pri uvozu obrađuju se svi valjani pluginovi bez zasebnog odobravanja svakog od njih, a buduće sinkronizacije mogu dodati nove pluginove.

Novi pluginovi u početku imaju postavku instalacije Dostupno i autentifikaciju pri instalaciji. Nove tržnice imaju omogućenu automatsku svakodnevnu sinkronizaciju. Nakon uvoza pregledajte postavke radnog prostora i potrebne aplikacije za svaki plugin.

Uvoz tržnice

1. Otvorite Administratorsku konzolu, odaberite željeni radni prostor u ChatGPT-u i otvorite Pluginovi. Zatim odaberite Dodaj pa Uvezi tržnicu.

2. U polje Izvor unesite URL repozitorija, primjerice https://github.com/example/team-plugins. Upotrijebite samo URL repozitorija, bez URL-a grane ili mape.

3. Ako se tržnica nalazi u poddirektoriju, unesite taj direktorij u polje Putanja. Primjerice, unesite team-tools za team-tools/.agents/plugins/marketplace.json. Za korijenski direktorij repozitorija ostavite polje Putanja praznim. Nemojte unositi naziv datoteke manifesta.

4. Po želji ispunite polje Grana, oznaka ili commit. Ostavite ga praznim da biste upotrebljavali zadanu granu repozitorija. Upotrijebite granu da biste primali buduće commitove. Odaberete li fiksni commit, sadržaj ostaje na toj reviziji.

5. Odaberite Uvezi tržnicu i odobrite pristup GitHubu kada se to zatraži.

6. Pregledajte Rezultate uvoza, a zatim otvorite svaki uvezeni plugin da biste konfigurirali pravila instalacije i sve potrebne aplikacije.

Početni uvoz vrlo velikih tržnica može potrajati do 1 sat. Naknadne svakodnevne sinkronizacije obično traju nekoliko minuta.

Ako se plugin ne može uvesti, pogreška je objašnjena u izvješću. Ostali valjani pluginovi i dalje se mogu uvesti.

Podržani formati

Odabrani direktorij mora sadržavati podržani manifest:

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

• .claude-plugin/marketplace.json za tržnicu kompatibilnu s Claudeom.

• .claude-plugin/plugin.json za samostalni plugin za Claude kada nije prisutan manifest tržnice.

Unosi tržnice mogu referencirati mape pluginova u istom repozitoriju ili podržane izvore iz repozitorija na GitHubu. Uvoz u radni prostor ne podržava druge servise za smještaj Git repozitorija ni izvore iz registara paketa, kao što je npm.

Podržane formate, primjere JSON-a i polja izvora potražite u dokumentu Upravljanje pluginovima.

Konfiguriranje pristupa u radnom prostoru

GitHub pruža sadržaj plugina, dok postavke radnog prostora određuju instalaciju i autentifikaciju. Uvoz i sinkronizacija ne primjenjuju vrijednosti pravila iz repozitorija, kao što su AVAILABLE ili ON_USE. Konfigurirajte te postavke za svaki plugin u svojem radnom prostoru.


U postavci Pravila instalacije odaberite Dostupno ili Instalirano za svaku ulogu koja ispunjava uvjete. Potrebne aplikacije također moraju biti omogućene, a članovi moraju imati pristup povezanoj usluzi i dovršiti svu potrebnu autentifikaciju.


Sinkronizacijom ažuriranja plugina ili prebacivanjem postojećeg plugina na upravljanje putem GitHuba zadržavaju se njegova pravila radnog prostora. Uvoz plugina ne odobrava pristup aplikacijama niti povezuje račune članova.


Informacije o navigaciji radnim prostorom, pristupu aplikacijama i kontrolama radnog prostora potražite u članku Administratorske kontrole, sigurnost i usklađenost za pluginove i aplikacije.

Održavanje pluginova ažurnima

Za nove tržnice ažuriranja se provjeravaju svakodnevno. Da biste zatražili ažuriranje bez čekanja na automatsku sinkronizaciju:

1. Otvorite Administratorsku konzolu, odaberite željeni radni prostor u ChatGPT-u i otvorite Pluginovi.

2. Otvorite Tržnice i odaberite tržnicu.

3. Odaberite Sinkroniziraj sada.

Sinkronizacija može dodati nove unose s tržnice i ažurirati postojeće pluginove. Pregledajte promjene u repozitoriju prije njihova spajanja jer automatska sinkronizacija može uvesti nove pluginove bez zasebnog koraka uvoza.

Pregled rezultata sinkronizacije

Nakon sinkronizacije pregledajte njezin status i spremljeno izvješće. Dovršeno — N pogrešaka znači da je sinkronizacija završena, ali neki pluginovi nisu mogli biti obrađeni.


Ako ažuriranje postojećeg plugina nije valjano, zadržava se njegova posljednja ispravna verzija. Ostala valjana ažuriranja i dalje se mogu dovršiti. Ispravite prijavljeni problem na GitHubu pa odaberite Sinkroniziraj sada da biste pokušali ponovno.


Ako se u administratorskom prikazu za pojedinačno uvezeni plugin prikazuje opcija Osvježi, upotrijebite je za osvježavanje tog plugina. Opcija Osvježi popis pluginova samo ponovno učitava prikazani popis; ne sinkronizira sadržaj s GitHuba.

Kako funkcioniraju uklanjanje i brisanje

Uklanjanjem unosa iz repozitorija ne briše se njegova kopija uvezena u radni prostor. Plugin dobiva oznaku Više nije u izvoru.


Brisanjem tržnice u ChatGPT-u brišu se svi pluginovi uvezeni s nje. Nemojte brisati tržnicu radi ponovnog povezivanja s GitHubom ili promjene vlasništva.

Ponovno povezivanje ili promjena pristupa GitHubu

Sinkronizacija tržnice upotrebljava vezu s GitHubom administratora koji ju je uvezao. Taj račun mora zadržati pristup repozitoriju tržnice i svim referenciranim repozitorijima.

Ponovno povezivanje izvornog računa

1. Provjerite ima li GitHub račun upotrijebljen za uvoz i dalje pristup svim potrebnim repozitorijima.

2. Zamolite administratora koji je izvorno uvezao tržnicu da otvori plugin za GitHub u ChatGPT-u i ponovno poveže svoj račun.

Prijenos na novog administratora

Novi administrator radnog prostora može uvesti istu tržnicu putem vlastite veze s GitHubom:

1. Otvorite Administratorsku konzolu, odaberite željeni radni prostor u ChatGPT-u i otvorite Pluginovi. Zatim odaberite Dodaj > Uvezi tržnicu.

2. U polja Izvor, Putanja i Grana, oznaka ili commit unesite iste vrijednosti koje su upotrijebljene za postojeću tržnicu.

3. Odaberite Uvezi tržnicu i odobrite pristup GitHubu kada se to zatraži.

Buduće sinkronizacije upotrebljavat će vezu s GitHubom novog administratora. Račun novog administratora mora imati dozvolu za čitanje repozitorija tržnice i svih repozitorija koje tržnica referencira.

Prebacivanje postojećeg plugina na upravljanje putem GitHuba

Tržnicu možete upotrebljavati za upravljanje postojećim pluginom u radnom prostoru koji je prenesen kao arhiva ili kojim se još ne upravlja putem izvora na GitHubu. Postojeći plugin mora biti u istom radnom prostoru i imati isti naziv plugina. Na ovaj način nije moguće preuzeti upravljanje pluginom kojim se upravlja putem drugog izvora na GitHubu.


Da biste označili postojeći plugin u svojoj tržnici:

1. Otvorite Administratorsku konzolu, odaberite željeni radni prostor u ChatGPT-u i otvorite Pluginovi. Otvorite plugin.

2. Kopirajte ID plugina koji se nalazi nakon /admin/plugins/ u njegovu URL-u.

3. Dodajte taj ID kao pluginId uz name i source u odgovarajućem unosu polja plugins tržnice. Nemojte ga dodavati u datoteku plugin.json plugina.

Plugin zadržava svoj ID, postavke dijeljenja i pravila radnog prostora. GitHub postaje izvor budućih ažuriranja pa ga naknadno prenesene arhive ne mogu zamijeniti.


Primjer migracije i preduvjete potražite u dokumentu Upravljanje pluginovima.

Referenciranje postojeće aplikacije

Plugin može referencirati postojeću aplikaciju u datoteci .app.json u korijenskom direktoriju plugina. Uključite početnu točku u naziv datoteke i upotrijebite ID aplikacije, a ne ID plugina. Za izvorni plugin postavite polje apps u datoteci .codex-plugin/plugin.json na ./.app.json.


Referenca ne stvara aplikaciju niti dodjeljuje dodatne dozvole. I dalje vrijede postojeće postavke aplikacije za pristup u radnom prostoru, autentifikaciju i upravljanje radnjama te dozvole za povezanu uslugu.


Format JSON-a potražite u dokumentu Upravljanje pluginovima.

Što znači oznaka „Samo za stolnu aplikaciju”

Plugin s oznakom Samo za stolnu aplikaciju ne može se pokrenuti u ChatGPT-u na webu. Uvezeni pluginovi mogu dobiti tu oznaku ako deklariraju MCP poslužitelje, primjerice u datoteci mcp.json ili .mcp.json, čak i ako poslužitelj upotrebljava udaljeni HTTPS URL.


Dodavanje reference u datoteci .app.json samo po sebi ne uklanja oznaku Samo za stolnu aplikaciju. Svaka referencirana aplikacija i dalje mora biti dostupna ulozi člana, a na nju se primjenjuju uobičajeni zahtjevi za pristup i autentifikaciju.