Ülevaade

Tööjaama administraatorid saavad importida GitHubist pluginate turuplatsi oma tööjaama kataloogi. Turuplats on JSON-kataloog, milles on loetletud imporditavad pluginad. Pärast importimist hoiab igapäevane sünkroonimine pluginad varamu muudatustega ajakohasena.


Turuplatsi sünkroonimine impordib pluginate sisu – see ei ühenda tööjaama liikmete kontosid ega anna juurdepääsu pluginas sisalduvatele rakendustele.


Pluginate ja neis sisalduvate rakenduste tutvustuse leiad artiklist Pluginad ChatGPT-s ja Codexis.

Enne alustamist

• Kasuta GitHubi kontot, millel on lugemisõigus turuplatsi varamule ja kõigile teistele varamutele, millele see viitab. Toetatud on github.com-i avalikud ja privaatsed varamud.

• Hangi GitHubi organisatsioonilt kõik vajalikud heakskiidud, et importimiseks kasutatav konto pääseks neile varamutele juurde.

• Vaata varamu sisu üle. Importimine töötleb kõiki nõuetele vastavaid pluginaid ilma neid eraldi kinnitamata ning edaspidised sünkroonimised võivad lisada uusi pluginaid.

Uute pluginate algne paigalduspoliitika on Saadaval ja autentimine toimub paigaldamisel. Uutel turuplatsidel on automaatne igapäevane sünkroonimine lubatud. Pärast importimist vaata üle iga plugina tööjaama seaded ja vajalikud rakendused.

Turuplatsi importimine

1. Ava halduskonsool, vali soovitud ChatGPT tööjaam ja ava Pluginad. Seejärel vali Lisa ja Impordi turuplats.

2. Sisesta väljale Allikas varamu URL, näiteks https://github.com/example/team-plugins. Kasuta ainult varamu URL-i, ilma haru või kausta aadressita.

3. Kui turuplats asub alamkataloogis, sisesta see kataloog väljale Tee. Näiteks faili team-tools/.agents/plugins/marketplace.json puhul sisesta team-tools. Varamu juurkataloogi puhul jäta väli Tee tühjaks. Ära sisesta avalduse failinime.

4. Soovi korral täida väli Haru, silt või kommit. Varamu vaikeharu kasutamiseks jäta see tühjaks. Edaspidiste kommitite vastuvõtmiseks kasuta haru. Kindla kommiti valimisel jääb kasutusele see versioon.

5. Vali Impordi turuplats ja anna küsimisel GitHubi juurdepääsuluba.

6. Vaata üle Importimise tulemused, seejärel ava iga imporditud plugin, et seadistada selle paigalduspoliitika ja vajalikud rakendused.

Väga suurte turuplatside esmane importimine võib kesta kuni 1 tund. Järgnevad igapäevased sünkroonimised võtavad tavaliselt mõne minuti.

Kui pluginat ei saa importida, selgitab aruanne vea põhjust. Teisi nõuetele vastavaid pluginaid saab siiski importida.

Toetatud vormingud

Valitud kataloog peab sisaldama toetatud avaldust:

• .agents/plugins/marketplace.json Codexi turuplatsi puhul.

• .claude-plugin/marketplace.json Claude'iga ühilduva turuplatsi puhul.

• .claude-plugin/plugin.json eraldiseisva Claude'i plugina puhul, kui turuplatsi avaldus puudub.

Turuplatsi kirjed võivad viidata samas varamus olevatele pluginakaustadele või toetatud GitHubi varamuallikatele. Tööjaama importimine ei toeta teisi Giti majutusteenuseid ega paketiregistrite allikaid, näiteks npm-i.

Toetatud vormingud, JSON-i näited ja allikaväljad leiad juhendist Pluginate haldamine.

Tööjaama juurdepääsu seadistamine

Plugina sisu pärineb GitHubist, kuid paigaldamist ja autentimist juhivad tööjaama seaded. Importimine ja sünkroonimine ei rakenda varamu poliitikaväärtusi, nagu AVAILABLE või ON_USE. Seadista need iga oma tööjaama plugina jaoks eraldi.


Vali jaotises Paigalduspoliitika iga sobiva rolli jaoks Saadaval või Paigaldatud. Ka vajalikud rakendused peavad olema lubatud ning liikmetel peab olema juurdepääs ühendatud teenusele ja nad peavad läbima nõutava autentimise.


Plugina värskenduse sünkroonimisel või olemasoleva plugina viimisel GitHubi halduse alla säilivad selle tööjaama poliitikad. Plugina importimine ei anna juurdepääsu rakendustele ega ühenda liikmete kontosid.


Tööjaamas navigeerimise, rakendustele juurdepääsu ja tööjaama juhtseadete kohta leiad teavet artiklist Pluginate ja rakenduste haldusseaded, turvalisus ja vastavus.

Pluginate ajakohasena hoidmine

Uued turuplatsid kontrollivad värskendusi iga päev. Värskenduse taotlemiseks automaatset sünkroonimist ootamata tee järgmist.

1. Ava halduskonsool, vali soovitud ChatGPT tööjaam ja ava Pluginad.

2. Ava Turuplatsid ja vali turuplats.

3. Vali Sünkrooni kohe.

Sünkroonimine võib lisada uusi turuplatsi kirjeid ja värskendada olemasolevaid pluginaid. Vaata varamu muudatused enne ühendamist üle, sest automaatne sünkroonimine võib importida uusi pluginaid ilma eraldi importimiseta.

Sünkroonimise tulemuste ülevaatamine

Pärast sünkroonimist vaata üle selle olek ja salvestatud aruanne. Lõpetatud – N viga tähendab, et sünkroonimine lõppes, kuid mõnda pluginat ei õnnestunud töödelda.


Kui olemasoleva plugina värskendus ei vasta nõuetele, säilitatakse selle viimane töötav versioon. Teised nõuetele vastavad värskendused saavad siiski lõpule jõuda. Paranda teatatud probleem GitHubis ja vali uuesti proovimiseks Sünkrooni kohe.


Kui administraatorivaates on eraldi imporditud plugina juures valik Värskenda, kasuta seda selle plugina värskendamiseks. Värskenda pluginate loendit laadib uuesti ainult kuvatava loendi ega sünkrooni GitHubist.

Eemaldamise ja kustutamise mõju

Kirje eemaldamine varamust ei kustuta selle tööjaama imporditud koopiat. Plugin saab märke Pole enam allikas.


Turuplatsi kustutamine ChatGPT-s kustutab kõik sealt imporditud pluginad. Ära kustuta turuplatsi GitHubi ühenduse taastamiseks või omaniku vahetamiseks.

GitHubi ühenduse taastamine või juurdepääsu muutmine

Turuplatsi sünkroonimine kasutab selle importinud administraatori GitHubi ühendust. Sellel kontol peab säilima juurdepääs turuplatsi varamule ja kõigile viidatud varamutele.

Algse konto taasühendamine

1. Veendu, et importimiseks kasutatud GitHubi kontol on endiselt juurdepääs kõigile vajalikele varamutele.

2. Palu turuplatsi algselt importinud administraatoril avada ChatGPT-s GitHubi plugin ja oma konto uuesti ühendada.

Üleandmine uuele administraatorile

Tööjaama uus administraator saab sama turuplatsi importida oma GitHubi ühenduse kaudu:

1. Ava halduskonsool, vali soovitud ChatGPT tööjaam ja ava Pluginad. Seejärel vali Lisa > Impordi turuplats.

2. Sisesta väljadele Allikas, Tee ja Haru, silt või kommit samad väärtused, mida kasutati olemasoleva turuplatsi puhul.

3. Vali Impordi turuplats ja anna küsimisel GitHubi juurdepääsuluba.

Edaspidised sünkroonimised kasutavad uue administraatori GitHubi ühendust. Uue administraatori kontol peab olema lugemisõigus turuplatsi varamule ja kõigile varamutele, millele see viitab.

Olemasoleva plugina viimine GitHubi halduse alla

Turuplatsi abil saad hallata tööjaama olemasolevat pluginat, mis laaditi üles arhiivina või mida ei hallata veel GitHubi allika kaudu. Olemasolev plugin peab asuma samas tööjaamas ja kandma sama nime. Teise GitHubi allika kaudu hallatavat pluginat ei saa sel viisil üle võtta.


Olemasoleva plugina määratlemiseks oma turuplatsil tee järgmist.

1. Ava halduskonsool, vali soovitud ChatGPT tööjaam ja ava Pluginad. Ava plugin.

2. Kopeeri plugina URL-ist osa /admin/plugins/ järel olev plugina ID.

3. Lisa see ID turuplatsi massiivi plugins vastavasse kirjesse väljana pluginId väljade name ja source kõrvale. Ära lisa seda plugina faili plugin.json.

Plugina ID, jagamisseaded ja tööjaama poliitikad säilivad. Edaspidiste värskenduste allikaks saab GitHub, seega ei saa pluginat hiljem üleslaaditud arhiividega asendada.


Üleviimise näite ja nõuded leiad juhendist Pluginate haldamine.

Olemasolevale rakendusele viitamine

Plugin saab viidata olemasolevale rakendusele plugina juurkataloogis asuvas failis .app.json. Lisa failinime algusse punkt ja kasuta plugina ID asemel rakenduse ID-d. Omaplugina puhul määra failis .codex-plugin/plugin.json välja apps väärtuseks ./.app.json.


Viide ei loo rakendust ega anna lisalube. Rakenduse senised tööjaama juurdepääsuõigused, autentimine, toimingute juhtseaded ja ühendatud teenuse load kehtivad edasi.


JSON-vormingu kohta leiad teavet juhendist Pluginate haldamine.

Märgi „Ainult töölaual“ tähendus

Märgiga Ainult töölaual plugin ei saa töötada ChatGPT veebiversioonis. Imporditud pluginad võivad saada selle märgi, kui neis on deklareeritud MCP-serverid, näiteks failis mcp.json või .mcp.json, isegi kui server kasutab kaugserveri HTTPS-i URL-i.


Viite lisamine faili .app.json ei eemalda iseenesest märki Ainult töölaual. Iga viidatud rakendus peab endiselt olema liikme rollile saadaval ning kehtivad selle tavapärased juurdepääsu- ja autentimisnõuded.