Pārskats

Darbvietas administratori var importēt spraudņu tirgu no GitHub savas darbvietas katalogā. Spraudņu tirgus ir JSON katalogs, kurā uzskaitīti importējamie spraudņi. Pēc importēšanas ikdienas sinhronizācija atjaunina spraudņus atbilstoši izmaiņām repozitorijā.


Spraudņu tirgus sinhronizācija importē spraudņu saturu — tā nesavieno darbvietas dalībnieku kontus un nepiešķir piekļuvi spraudnī iekļautajām lietotnēm.


Ievadu par spraudņiem un tajos iekļautajām lietotnēm skatiet rakstā Spraudņi pakalpojumos ChatGPT un Codex.

Pirms sākat

• Izmantojiet GitHub kontu, kuram ir lasīšanas piekļuve spraudņu tirgus repozitorijam un visiem pārējiem repozitorijiem, uz kuriem tajā ir atsauces. Tiek atbalstīti publiski un privāti repozitoriji vietnē github.com.

• Saņemiet visus nepieciešamos GitHub organizācijas apstiprinājumus, lai importēšanai izmantotais konts varētu piekļūt šiem repozitorijiem.

• Pārskatiet repozitorija saturu. Importēšanas laikā tiek apstrādāti visi derīgie spraudņi bez atsevišķa apstiprinājuma katram no tiem, un turpmākā sinhronizācija var pievienot jaunus spraudņus.

Jauniem spraudņiem sākotnēji ir iestatīta instalēšanas politika Pieejams un autentifikācija instalēšanas laikā. Jauniem spraudņu tirgiem ir iespējota automātiska ikdienas sinhronizācija. Pēc importēšanas pārskatiet katra spraudņa darbvietas iestatījumus un nepieciešamās lietotnes.

Spraudņu tirgus importēšana

1. Dodieties uz administrēšanas konsoli, atlasiet vajadzīgo ChatGPT darbvietu un atveriet sadaļu Spraudņi. Pēc tam atlasiet Pievienot un izvēlieties Importēt spraudņu tirgu.

2. Laukā Avots ievadiet repozitorija URL, piemēram, https://github.com/example/team-plugins. Izmantojiet tikai repozitorija URL, nevis zara vai mapes URL.

3. Ja spraudņu tirgus atrodas apakšdirektorijā, ievadiet šo direktoriju laukā Ceļš. Piemēram, failam team-tools/.agents/plugins/marketplace.json ievadiet team-tools. Repozitorija saknes direktorijai atstājiet lauku Ceļš tukšu. Neievadiet deklarācijas faila nosaukumu.

4. Ja nepieciešams, aizpildiet lauku Zars, tags vai komits. Atstājiet to tukšu, lai izmantotu repozitorija noklusējuma zaru. Izmantojiet zaru, lai saņemtu turpmākos komitus. Norādot konkrētu komitu, versija paliek nemainīga.

5. Atlasiet Importēt spraudņu tirgu un, kad tiek parādīts uzaicinājums, atļaujiet piekļuvi GitHub.

6. Pārskatiet sadaļu Importēšanas rezultāti, pēc tam atveriet katru importēto spraudni, lai konfigurētu tā instalēšanas politiku un nepieciešamās lietotnes.

Ļoti lielu spraudņu tirgu sākotnējā importēšana var ilgt līdz 1 stundai. Turpmākā ikdienas sinhronizācija parasti ilgst dažas minūtes.

Ja spraudni nevar importēt, pārskatā ir sniegts kļūdas skaidrojums. Pārējos derīgos spraudņus joprojām var importēt.

Atbalstītie formāti

Atlasītajā direktorijā jābūt atbalstītai deklarācijai:

• .agents/plugins/marketplace.json — Codex spraudņu tirgum.

• .claude-plugin/marketplace.json — ar Claude saderīgam spraudņu tirgum.

• .claude-plugin/plugin.json — atsevišķam Claude spraudnim, ja nav spraudņu tirgus deklarācijas.

Spraudņu tirgus ierakstos var norādīt atsauces uz spraudņu mapēm tajā pašā repozitorijā vai atbalstītiem GitHub repozitoriju avotiem. Importēšana darbvietā neatbalsta citus Git mitināšanas pakalpojumus un pakotņu reģistru avotus, piemēram, npm.

Informāciju par atbalstītajiem formātiem, JSON piemēriem un avotu laukiem skatiet rakstā Spraudņu pārvaldība.

Piekļuves konfigurēšana darbvietā

GitHub nodrošina spraudņa saturu, savukārt darbvietas iestatījumi nosaka instalēšanu un autentifikāciju. Importēšana un sinhronizācija nepiemēro repozitorijā norādītās politiku vērtības, piemēram, AVAILABLE vai ON_USE. Konfigurējiet šos iestatījumus katram spraudnim savā darbvietā.


Sadaļā Instalēšanas politika katrai atbilstošajai lomai izvēlieties Pieejams vai Instalēts. Jāiespējo arī nepieciešamās lietotnes, un dalībniekiem jābūt piekļuvei pievienotajam pakalpojumam un jāveic nepieciešamā autentifikācija.


Sinhronizējot spraudņa atjauninājumu vai pārceļot esoša spraudņa pārvaldību uz GitHub, tā darbvietas politikas tiek saglabātas. Spraudņa importēšana nepiešķir piekļuvi lietotnēm un nesavieno dalībnieku kontus.


Informāciju par navigāciju darbvietā, piekļuvi lietotnēm un darbvietas vadīklām skatiet rakstā Spraudņu un lietotņu administrēšanas vadīklas, drošība un atbilstība.

Spraudņu atjaunināšana

Jaunos spraudņu tirgos atjauninājumi tiek pārbaudīti katru dienu. Lai pieprasītu atjauninājumu, negaidot automātisko sinhronizāciju:

1. Dodieties uz administrēšanas konsoli, atlasiet vajadzīgo ChatGPT darbvietu un atveriet sadaļu Spraudņi.

2. Atveriet sadaļu Spraudņu tirgi un atlasiet spraudņu tirgu.

3. Atlasiet Sinhronizēt tūlīt.

Sinhronizācija var pievienot jaunus spraudņu tirgus ierakstus un atjaunināt esošos spraudņus. Pirms izmaiņu sapludināšanas repozitorijā pārskatiet tās, jo automātiskā sinhronizācija var importēt jaunus spraudņus bez atsevišķas importēšanas darbības.

Sinhronizācijas rezultātu pārskatīšana

Pēc sinhronizācijas pārskatiet tās statusu un saglabāto pārskatu. Pabeigta — N kļūdas nozīmē, ka sinhronizācija ir pabeigta, taču dažus spraudņus neizdevās apstrādāt.


Ja esoša spraudņa atjauninājums nav derīgs, tiek saglabāta tā pēdējā darbspējīgā versija. Pārējos derīgos atjauninājumus joprojām var pabeigt. Novērsiet norādīto problēmu pakalpojumā GitHub un pēc tam atlasiet Sinhronizēt tūlīt, lai mēģinātu vēlreiz.


Ja administrēšanas skatā atsevišķi importētam spraudnim ir redzama opcija Atsvaidzināt, izmantojiet to, lai atsvaidzinātu šo spraudni. Opcija Atsvaidzināt spraudņu sarakstu tikai pārlādē redzamo sarakstu; tā neveic sinhronizāciju ar GitHub.

Kas jāzina par noņemšanu un dzēšanu

Noņemot ierakstu no repozitorija, tā importētā kopija darbvietā netiek izdzēsta. Spraudnim tiek piešķirta atzīme Avotā vairs nav.


Dzēšot spraudņu tirgu pakalpojumā ChatGPT, tiek izdzēsti visi no tā importētie spraudņi. Nedzēsiet spraudņu tirgu, lai atjaunotu GitHub savienojumu vai mainītu īpašnieku.

GitHub savienojuma atjaunošana vai piekļuves maiņa

Spraudņu tirgus sinhronizācijai tiek izmantots tā administratora GitHub savienojums, kurš to importēja. Šim kontam jāsaglabā piekļuve spraudņu tirgus repozitorijam un visiem tajā norādītajiem repozitorijiem.

Sākotnējā konta atkārtota savienošana

1. Pārliecinieties, ka importēšanai izmantotajam GitHub kontam joprojām ir piekļuve visiem nepieciešamajiem repozitorijiem.

2. Lūdziet administratoram, kurš sākotnēji importēja spraudņu tirgu, atvērt GitHub spraudni pakalpojumā ChatGPT un atkārtoti savienot savu kontu.

Pārvaldības nodošana jaunam administratoram

Jaunais darbvietas administrators var importēt to pašu spraudņu tirgu, izmantojot savu GitHub savienojumu:

1. Dodieties uz administrēšanas konsoli, atlasiet vajadzīgo ChatGPT darbvietu un atveriet sadaļu Spraudņi. Pēc tam atlasiet Pievienot > Importēt spraudņu tirgu.

2. Laukos Avots, Ceļš un Zars, tags vai komits ievadiet tās pašas vērtības, kas izmantotas esošajam spraudņu tirgum.

3. Atlasiet Importēt spraudņu tirgu un, kad tiek parādīts uzaicinājums, atļaujiet piekļuvi GitHub.

Turpmāk sinhronizācijai tiks izmantots jaunā administratora GitHub savienojums. Jaunā administratora kontam jābūt lasīšanas piekļuvei spraudņu tirgus repozitorijam un visiem repozitorijiem, uz kuriem tajā ir atsauces.

Esoša spraudņa pārvaldības pārcelšana uz GitHub

Spraudņu tirgu var izmantot, lai pārvaldītu esošu darbvietas spraudni, kas augšupielādēts kā arhīvs vai vēl netiek pārvaldīts no GitHub avota. Esošajam spraudnim jāatrodas tajā pašā darbvietā, un tā nosaukumam jāsakrīt. Šādi nevar pārņemt spraudni, ko pārvalda no cita GitHub avota.


Lai savā spraudņu tirgū norādītu esošo spraudni:

1. Dodieties uz administrēšanas konsoli, atlasiet vajadzīgo ChatGPT darbvietu un atveriet sadaļu Spraudņi. Atveriet spraudni.

2. Nokopējiet spraudņa ID, kas tā URL atrodas aiz /admin/plugins/.

3. Spraudņu tirgus masīva plugins atbilstošajā ierakstā pievienojiet šo ID kā pluginId līdzās laukiem name un source. Nepievienojiet to spraudņa failam plugin.json.

Spraudnis saglabā savu ID, kopīgošanas iestatījumus un darbvietas politikas. Turpmāko atjauninājumu avots būs GitHub, tāpēc vēlāk augšupielādēti arhīvi nevarēs to aizstāt.


Migrācijas piemēru un prasības skatiet rakstā Spraudņu pārvaldība.

Atsauces pievienošana uz esošu lietotni

Spraudņa saknes direktorijā esošajā failā .app.json var norādīt atsauci uz esošu lietotni. Faila nosaukuma sākumā iekļaujiet punktu un izmantojiet lietotnes ID, nevis spraudņa ID. Vietējam spraudnim faila .codex-plugin/plugin.json laukā apps iestatiet vērtību ./.app.json.


Atsauce neizveido lietotni un nepiešķir papildu atļaujas. Joprojām ir spēkā lietotnes esošie darbvietas piekļuves, autentifikācijas un darbību kontroles iestatījumi, kā arī pievienotā pakalpojuma atļaujas.


Informāciju par JSON formātu skatiet rakstā Spraudņu pārvaldība.

Ko nozīmē atzīme „Tikai datora lietotnē”

Spraudnis ar atzīmi Tikai datora lietotnē nevar darboties ChatGPT tīmekļa versijā. Importēti spraudņi var saņemt šo atzīmi, ja tajos ir deklarēti MCP serveri, piemēram, failā mcp.json vai .mcp.json, pat ja serveris izmanto attālu HTTPS URL.


Atsauces pievienošana failā .app.json pati par sevi nenoņem atzīmi Tikai datora lietotnē. Ikvienai lietotnei, uz kuru ir atsauce, joprojām jābūt pieejamai dalībnieka lomai, un tai ir spēkā parastās piekļuves un autentifikācijas prasības.