Përmbledhje

Administratorët e hapësirës së punës mund të importojnë një treg shtesash nga GitHub në katalogun e hapësirës së tyre të punës. Një treg shtesash është një katalog JSON që rendit shtesat për importim. Pas importimit, sinkronizimi ditor i mban shtesat të përditësuara me ndryshimet nga depoja.


Sinkronizimi i tregut importon përmbajtjen e shtesave; ai nuk lidh llogaritë e anëtarëve të hapësirës së punës dhe nuk jep qasje tek aplikacionet e përfshira në një shtesë.


Për t'u njohur me shtesat dhe aplikacionet e përfshira në to, shihni: Shtesat në ChatGPT dhe Codex.

Para se të filloni

• Përdorni një llogari GitHub që ka leje leximi për depon e tregut dhe çdo depo tjetër që ai referon. Mbështeten depot publike dhe private në github.com.

• Merrni çdo miratim të nevojshëm nga organizata në GitHub që llogaria që kryen importimin të ketë qasje në ato depo.

• Shqyrtoni përmbajtjen e depos. Importimi përpunon të gjitha shtesat e vlefshme pa një hap të veçantë miratimi për secilën, dhe sinkronizimet e ardhshme mund të shtojnë shtesa të reja.

Shtesat e reja fillojnë me politikën e instalimit E disponueshme dhe me autentikim gjatë instalimit. Tregjet e reja e kanë të aktivizuar sinkronizimin automatik ditor. Pas importimit, shqyrtoni cilësimet e hapësirës së punës dhe aplikacionet e nevojshme për çdo shtesë.

Importoni një treg shtesash

1. Shkoni te Konsola e administratorit, zgjidhni hapësirën e dëshiruar të punës në ChatGPT dhe hapni Shtesat. Pastaj zgjidhni Shto dhe më pas Importo tregun.

2. Te Burimi, vendosni URL-në e depos, si p.sh. https://github.com/example/team-plugins. Përdorni vetëm URL-në e depos, jo URL-në e një dege ose dosjeje.

3. Nëse tregu ndodhet në një nëndosje, vendoseni atë dosje te Shtegu. Për shembull, vendosni team-tools për team-tools/.agents/plugins/marketplace.json. Lëreni bosh fushën Shtegu për dosjen rrënjë të depos. Mos vendosni emrin e skedarit manifest.

4. Nëse dëshironi, plotësoni fushën Dega, etiketa ose commit. Lëreni bosh për të përdorur degën e parazgjedhur të depos. Përdorni një degë për të marrë commit-et e ardhshme. Një commit i fiksuar mbetet në atë version.

5. Zgjidhni Importo tregun dhe autorizoni qasjen në GitHub kur t'ju kërkohet.

6. Shqyrtoni Rezultatet e importimit, pastaj hapni çdo shtesë të importuar për të konfiguruar politikën e saj të instalimit dhe aplikacionet e nevojshme.

Importimi fillestar mund të zgjasë deri në 1 orë për tregje shumë të mëdha. Sinkronizimet ditore të mëvonshme zakonisht zgjasin pak minuta.

Nëse një shtesë nuk mund të importohet, raporti shpjegon gabimin. Shtesat e tjera të vlefshme mund të importohen gjithsesi.

Formatet e mbështetura

Dosja e zgjedhur duhet të përmbajë një manifest të mbështetur:

• .agents/plugins/marketplace.json për një treg Codex.

• .claude-plugin/marketplace.json për një treg të pajtueshëm me Claude.

• .claude-plugin/plugin.json për një shtesë të pavarur Claude kur nuk ka manifest tregu.

Elementet e tregut mund të referojnë dosje shtesash në të njëjtën depo ose burime të mbështetura nga depot e GitHub. Importimi në hapësirën e punës nuk mbështet platforma të tjera pritëse Git ose burime nga regjistra paketash, si npm.

Për formatet e mbështetura, shembuj JSON dhe fushat e burimit, shihni: Menaxhimi i shtesave.

Konfiguroni qasjen në hapësirën e punës

GitHub siguron përmbajtjen e shtesës, ndërsa cilësimet e hapësirës së punës kontrollojnë instalimin dhe autentikimin. Importimi dhe sinkronizimi nuk zbatojnë vlerat e politikave të depos, si AVAILABLE ose ON_USE. Konfigurojini këto cilësime për çdo shtesë në hapësirën tuaj të punës.


Përdorni Politika e instalimit për të zgjedhur E disponueshme ose E instaluar për çdo rol që plotëson kushtet. Edhe aplikacionet e nevojshme duhet të jenë të aktivizuara, ndërsa anëtarët duhet të kenë qasje në shërbimin e lidhur dhe të kryejnë çdo autentikim të kërkuar.


Sinkronizimi i një përditësimi të shtesës ose kalimi i një shtese ekzistuese në menaxhim përmes GitHub ruan politikat e saj të hapësirës së punës. Importimi i një shtese nuk jep qasje tek aplikacionet dhe nuk lidh llogaritë e anëtarëve.


Për lundrimin në hapësirën e punës, qasjen tek aplikacionet dhe kontrollet e hapësirës së punës, shihni: Kontrollet e administratorit, siguria dhe pajtueshmëria për shtesat dhe aplikacionet.

Mbajini shtesat të përditësuara

Tregjet e reja kontrollojnë çdo ditë për përditësime. Për të kërkuar një përditësim pa pritur sinkronizimin automatik:

1. Shkoni te Konsola e administratorit, zgjidhni hapësirën e dëshiruar të punës në ChatGPT dhe hapni Shtesat.

2. Hapni Tregjet dhe zgjidhni tregun.

3. Zgjidhni Sinkronizo tani.

Sinkronizimi mund të shtojë elemente të reja nga tregu dhe të përditësojë shtesat ekzistuese. Shqyrtoni ndryshimet në depo para se t'i bashkoni, sepse sinkronizimi automatik mund të importojë shtesa të reja pa një hap tjetër importimi.

Shqyrtoni rezultatet e sinkronizimit

Pas një sinkronizimi, shqyrtoni statusin e tij dhe raportin e ruajtur. Përfundoi — N gabime do të thotë se sinkronizimi përfundoi, por disa shtesa nuk mund të përpunoheshin.


Nëse një përditësim i një shtese ekzistuese është i pavlefshëm, ruhet versioni i fundit funksional i saj. Përditësimet e tjera të vlefshme mund të përfundojnë gjithsesi. Rregulloni problemin e raportuar në GitHub, pastaj zgjidhni Sinkronizo tani për të provuar sërish.


Nëse në pamjen e administratorit shfaqet Rifresko për një shtesë të importuar veçmas, përdoreni për ta rifreskuar atë shtesë. Rifresko listën e shtesave vetëm ringarkon listën e shfaqur; nuk kryen sinkronizim nga GitHub.

Kuptoni heqjen dhe fshirjen

Heqja e një elementi nga depoja nuk e fshin kopjen e tij të importuar në hapësirën e punës. Shtesa shënohet me etiketën Nuk gjendet më në burim.


Fshirja e tregut në ChatGPT fshin të gjitha shtesat e importuara prej tij. Mos e fshini një treg për të rilidhur GitHub ose për të ndryshuar pronësinë.

Rilidhni ose ndryshoni qasjen në GitHub

Sinkronizimi i tregut përdor lidhjen me GitHub të administratorit që e importoi. Ajo llogari duhet të vazhdojë të ketë qasje në depon e tregut dhe në të gjitha depot e referuara.

Rilidhni llogarinë fillestare

1. Konfirmoni që llogaria GitHub e përdorur për importimin ka ende qasje në të gjitha depot e nevojshme.

2. Kërkojini administratorit që importoi fillimisht tregun të hapë shtesën GitHub në ChatGPT dhe të rilidhë llogarinë e vet.

Transferojani një administratori të ri

Administratori i ri i hapësirës së punës mund të importojë të njëjtin treg duke përdorur lidhjen e vet me GitHub:

1. Shkoni te Konsola e administratorit, zgjidhni hapësirën e dëshiruar të punës në ChatGPT dhe hapni Shtesat. Pastaj zgjidhni Shto > Importo tregun.

2. Vendosni të njëjtat vlera për Burimi, Shtegu dhe Dega, etiketa ose commit që u përdorën për tregun ekzistues.

3. Zgjidhni Importo tregun dhe autorizoni qasjen në GitHub kur t'ju kërkohet.

Sinkronizimet e ardhshme përdorin lidhjen me GitHub të administratorit të ri. Llogaria e administratorit të ri duhet të ketë leje leximi për depon e tregut dhe çdo depo që ai referon.

Kaloni një shtesë ekzistuese në menaxhim përmes GitHub

Mund të përdorni një treg për të menaxhuar një shtesë ekzistuese të hapësirës së punës që është ngarkuar si arkiv ose që ende nuk menaxhohet nga një burim GitHub. Shtesa ekzistuese duhet të jetë në të njëjtën hapësirë pune dhe të ketë të njëjtin emër shtese. Menaxhimi i një shtese nga një burim tjetër GitHub nuk mund të merret përsipër në këtë mënyrë.


Për të identifikuar shtesën ekzistuese në tregun tuaj:

1. Shkoni te Konsola e administratorit, zgjidhni hapësirën e dëshiruar të punës në ChatGPT dhe hapni Shtesat. Hapni shtesën.

2. Kopjoni ID-në e shtesës që vjen pas /admin/plugins/ në URL-në e saj.

3. Shtojeni atë ID si pluginId, krahas name dhe source, në elementin përkatës të vargut plugins të tregut. Mos e shtoni në skedarin plugin.json të shtesës.

Shtesa ruan ID-në, cilësimet e ndarjes dhe politikat e hapësirës së punës. GitHub bëhet burimi për përditësimet e ardhshme, ndaj ngarkimet e mëvonshme të arkivave nuk mund ta zëvendësojnë atë.


Për një shembull migrimi dhe kërkesat përkatëse, shihni: Menaxhimi i shtesave.

Referoni një aplikacion ekzistues

Një shtesë mund të referojë një aplikacion ekzistues në .app.json në dosjen rrënjë të shtesës. Përfshini pikën në fillim të emrit të skedarit dhe përdorni ID-në e aplikacionit, jo ID-në e një shtese. Për një shtesë në formatin vendas, caktoni vlerën ./.app.json në fushën apps te .codex-plugin/plugin.json.


Referenca nuk krijon një aplikacion dhe nuk jep leje shtesë. Rregullat ekzistuese të aplikacionit për qasjen në hapësirën e punës, autentikimin, kontrollet e veprimeve dhe lejet e shërbimit të lidhur vazhdojnë të zbatohen.


Për formatin JSON, shihni: Menaxhimi i shtesave.

Kuptoni etiketën Vetëm për kompjuter

Një shtesë me etiketën Vetëm për kompjuter nuk mund të ekzekutohet në ChatGPT në ueb. Shtesat e importuara mund të marrin këtë etiketë kur deklarojnë serverë MCP, për shembull në mcp.json ose .mcp.json, edhe kur një server përdor një URL HTTPS në distancë.


Shtimi i një reference .app.json nuk mjafton për të hequr etiketën Vetëm për kompjuter. Çdo aplikacion i referuar duhet të jetë gjithsesi i disponueshëm për rolin e anëtarit dhe kërkesat e tij të zakonshme për qasje dhe autentikim vazhdojnë të zbatohen.