Pregled

Administratori radnog prostora mogu uvesti tržište dodataka s GitHuba u katalog svog radnog prostora. Tržište je JSON katalog koji navodi dodatke za uvoz. Nakon uvoza, svakodnevna sinhronizacija ažurira dodatke prema promjenama u repozitoriju.


Sinhronizacijom tržišta uvozi se sadržaj dodataka — ona ne povezuje račune članova radnog prostora niti odobrava pristup aplikacijama uključenim u dodatak.


Za uvod u dodatke i aplikacije koje sadrže pogledajte: Dodaci u ChatGPT-u i Codexu.

Prije nego što počnete

• Koristite GitHub račun koji ima pristup za čitanje repozitorija tržišta i svih drugih repozitorija koje ono referencira. Podržani su javni i privatni repozitoriji na github.com.

• Pribavite sva odobrenja GitHub organizacije potrebna da račun kojim se vrši uvoz može pristupiti tim repozitorijima.

• Pregledajte sadržaj repozitorija. Uvoz obrađuje sve ispravne dodatke bez zasebnog odobravanja svakog od njih, a buduće sinhronizacije mogu dodati nove dodatke.

Novi dodaci počinju s postavkom instalacije Dostupno i autentifikacijom pri instalaciji. Za nova tržišta omogućena je automatska svakodnevna sinhronizacija. Nakon uvoza pregledajte postavke radnog prostora i potrebne aplikacije za svaki dodatak.

Uvoz tržišta

1. Idite u Administratorsku konzolu, odaberite željeni ChatGPT radni prostor i otvorite Dodatke. Zatim odaberite Dodaj pa Uvezi tržište.

2. U polje Izvor unesite URL repozitorija, npr. https://github.com/example/team-plugins. Koristite samo URL repozitorija, a ne URL grane ili mape.

3. Ako se tržište nalazi u poddirektoriju, unesite taj direktorij u polje Putanja. Naprimjer, unesite team-tools za team-tools/.agents/plugins/marketplace.json. Za korijenski direktorij repozitorija ostavite polje Putanja prazno. Nemojte unositi naziv manifest datoteke.

4. Po želji popunite polje Grana, oznaka ili commit. Ostavite ga prazno da biste koristili zadanu granu repozitorija. Koristite granu da biste primali buduće commitove. Ako odaberete fiksni commit, sadržaj ostaje na toj reviziji.

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

6. Pregledajte Rezultate uvoza, a zatim otvorite svaki uvezeni dodatak da biste podesili njegova pravila instalacije i sve potrebne aplikacije.

Početni uvoz veoma velikih tržišta može trajati do 1 sat. Naredne svakodnevne sinhronizacije obično traju nekoliko minuta.

Ako se dodatak ne može uvesti, u izvještaju je objašnjena greška. Ostali ispravni dodaci i dalje se mogu uvesti.

Podržani formati

Odabrani direktorij mora sadržavati podržani manifest:

• .agents/plugins/marketplace.json za Codex tržište.

• .claude-plugin/marketplace.json za tržište kompatibilno s Claudeom.

• .claude-plugin/plugin.json za samostalni Claude dodatak kada manifest tržišta nije prisutan.

Unosi tržišta mogu referencirati mape dodataka u istom repozitoriju ili podržane izvore repozitorija na GitHubu. Uvoz u radni prostor ne podržava druge Git hosting servise ni izvore iz registara paketa, kao što je npm.

Za podržane formate, JSON primjere i polja izvora pogledajte: Upravljanje dodacima.

Podešavanje pristupa u radnom prostoru

GitHub pruža sadržaj dodataka, dok postavke radnog prostora upravljaju instalacijom i autentifikacijom. Uvoz i sinhronizacija ne primjenjuju vrijednosti pravila iz repozitorija, kao što su AVAILABLE ili ON_USE. Podesite ove postavke za svaki dodatak u svom radnom prostoru.


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


Sinhronizacija ažuriranja dodatka ili prebacivanje postojećeg dodatka na upravljanje putem GitHuba zadržava njegova pravila radnog prostora. Uvoz dodatka ne odobrava pristup aplikacijama niti povezuje račune članova.


Za navigaciju u radnom prostoru, pristup aplikacijama i kontrole radnog prostora pogledajte: Administratorske kontrole, sigurnost i usklađenost za dodatke i aplikacije.

Redovno ažuriranje dodataka

Za nova tržišta ažuriranja se provjeravaju svakodnevno. Da biste zatražili ažuriranje bez čekanja na automatsku sinhronizaciju:

1. Idite u Administratorsku konzolu, odaberite željeni ChatGPT radni prostor i otvorite Dodatke.

2. Otvorite Tržišta i odaberite tržište.

3. Odaberite Sinhroniziraj sada.

Sinhronizacija može dodati nove unose s tržišta i ažurirati postojeće dodatke. Pregledajte promjene u repozitoriju prije njihovog spajanja jer automatska sinhronizacija može uvesti nove dodatke bez ponovnog pokretanja uvoza.

Pregled rezultata sinhronizacije

Nakon sinhronizacije pregledajte njen status i sačuvani izvještaj. Završeno — N grešaka znači da je sinhronizacija završena, ali neki dodaci nisu mogli biti obrađeni.


Ako ažuriranje postojećeg dodatka nije ispravno, zadržava se njegova posljednja funkcionalna verzija. Ostala ispravna ažuriranja i dalje se mogu dovršiti. Ispravite prijavljeni problem na GitHubu, a zatim odaberite Sinhroniziraj sada da biste pokušali ponovo.


Ako se u administratorskom prikazu za pojedinačno uvezeni dodatak prikazuje opcija Osvježi, koristite je da biste osvježili taj dodatak. Opcija Osvježi listu dodataka samo ponovo učitava prikazanu listu; ne vrši sinhronizaciju s GitHubom.

Razlika između uklanjanja i brisanja

Uklanjanjem unosa iz repozitorija ne briše se njegova uvezena kopija u radnom prostoru. Dodatak dobija oznaku Više nije u izvoru.


Brisanjem tržišta u ChatGPT-u brišu se svi dodaci uvezeni s njega. Nemojte brisati tržište da biste ponovo povezali GitHub ili promijenili vlasništvo.

Ponovno povezivanje ili promjena pristupa GitHubu

Sinhronizacija tržišta koristi vezu s GitHubom administratora koji ga je uvezao. Taj račun mora zadržati pristup repozitoriju tržišta i svim referenciranim repozitorijima.

Ponovno povezivanje prvobitnog računa

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

2. Zamolite administratora koji je prvobitno uvezao tržište da otvori GitHub dodatak u ChatGPT-u i ponovo poveže svoj račun.

Prijenos na novog administratora

Novi administrator radnog prostora može uvesti isto tržište koristeći vlastitu vezu s GitHubom:

1. Idite u Administratorsku konzolu, odaberite željeni ChatGPT radni prostor i otvorite Dodatke. Zatim odaberite Dodaj > Uvezi tržište.

2. Unesite iste vrijednosti za Izvor, Putanju i Granu, oznaku ili commit koje su korištene za postojeće tržište.

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

Buduće sinhronizacije koristit će vezu s GitHubom novog administratora. Račun novog administratora mora imati pristup za čitanje repozitorija tržišta i svih repozitorija koje ono referencira.

Prebacivanje postojećeg dodatka na upravljanje putem GitHuba

Tržište možete koristiti za upravljanje postojećim dodatkom u radnom prostoru koji je otpremljen kao arhiva ili kojim se još ne upravlja putem izvora na GitHubu. Postojeći dodatak mora biti u istom radnom prostoru i imati isti naziv dodatka. Dodatak kojim se upravlja putem drugog izvora na GitHubu ne može se preuzeti na ovaj način.


Da biste identificirali postojeći dodatak u svom tržištu:

1. Idite u Administratorsku konzolu, odaberite željeni ChatGPT radni prostor i otvorite Dodatke. Otvorite dodatak.

2. Kopirajte ID dodatka koji se nalazi iza /admin/plugins/ u njegovom URL-u.

3. Dodajte taj ID kao pluginId pored name i source u odgovarajućem unosu niza plugins tržišta. Nemojte ga dodavati u datoteku plugin.json dodatka.

Dodatak zadržava svoj ID, postavke dijeljenja i pravila radnog prostora. GitHub postaje izvor budućih ažuriranja, pa se dodatak više ne može zamijeniti naknadnim otpremanjem arhiva.


Za primjer migracije i zahtjeve pogledajte: Upravljanje dodacima.

Referenciranje postojeće aplikacije

Dodatak može referencirati postojeću aplikaciju u datoteci .app.json u korijenskom direktoriju dodatka. Uključite početnu tačku u naziv datoteke i koristite ID aplikacije umjesto ID-a dodatka. Za izvorni dodatak postavite polje apps u datoteci .codex-plugin/plugin.json na ./.app.json.


Referenca ne kreira aplikaciju niti dodjeljuje dodatne dozvole. I dalje važe postojeće postavke pristupa aplikaciji u radnom prostoru, autentifikacija, kontrole radnji i dozvole povezane usluge.


Za JSON format pogledajte: Upravljanje dodacima.

Značenje oznake Samo za desktop

Dodatak s oznakom Samo za desktop ne može se pokrenuti u ChatGPT-u na webu. Uvezeni dodaci mogu dobiti ovu oznaku ako imaju deklarirane MCP servere, naprimjer u datotekama mcp.json ili .mcp.json, čak i kada server koristi udaljeni HTTPS URL.


Samo dodavanje reference u .app.json ne uklanja oznaku Samo za desktop. Svaka referencirana aplikacija i dalje mora biti dostupna ulozi člana, a za nju važe uobičajeni zahtjevi za pristup i autentifikaciju.