Sužinokite, kaip importuoti įskiepių prekyvietę iš „GitHub“, valdyti prieigą darbo erdvėje ir atnaujinti įskiepius.

Apžvalga

Darbo erdvės administratoriai gali importuoti įskiepių prekyvietę iš „GitHub“ į savo darbo erdvės katalogą. Prekyvietė – tai JSON katalogas, kuriame išvardyti importuotini įskiepiai. Po importavimo kasdienis sinchronizavimas atnaujina įskiepius pagal saugykloje atliktus pakeitimus.

Sinchronizuojant prekyvietę importuojamas įskiepių turinys – darbo erdvės narių paskyros neprijungiamos ir prieiga prie įskiepį sudarančių programėlių nesuteikiama.

Įvadinės informacijos apie įskiepius ir juos sudarančias programėles rasite straipsnyje Įskiepiai „ChatGPT“ ir „Codex“.

Prieš pradedant

Naudokite „GitHub“ paskyrą, turinčią skaitymo prieigą prie prekyvietės saugyklos ir visų kitų joje nurodytų saugyklų. Palaikomos viešosios ir privačios saugyklos svetainėje github.com.
Gaukite visus reikiamus „GitHub“ organizacijos patvirtinimus, kad importavimui naudojama paskyra galėtų pasiekti šias saugyklas.
Peržiūrėkite saugyklos turinį. Importuojant apdorojami visi tinkami įskiepiai be atskiro kiekvieno patvirtinimo, o vėliau sinchronizuojant gali būti pridėta naujų įskiepių.

Naujiems įskiepiams iš pradžių taikoma diegimo nuostata Prieinamas ir autentifikavimas diegimo metu. Naujoms prekyvietėms įjungtas automatinis kasdienis sinchronizavimas. Po importavimo peržiūrėkite kiekvieno įskiepio darbo erdvės nustatymus ir reikiamas programėles.

Prekyvietės importavimas

Eikite į administravimo konsolę, pasirinkite norimą „ChatGPT“ darbo erdvę ir atverkite Įskiepiai. Tada pasirinkite Pridėti ir Importuoti prekyvietę.
Lauke Šaltinis įveskite saugyklos URL, pavyzdžiui, https://github.com/example/team-plugins. Naudokite tik saugyklos URL, o ne šakos ar aplanko URL.
Jei prekyvietė yra pakatalogyje, įveskite jį lauke Kelias. Pavyzdžiui, jei kelias yra team-tools/.agents/plugins/marketplace.json, įveskite team-tools. Jei naudojate saugyklos šakninį katalogą, lauką Kelias palikite tuščią. Neįveskite manifesto failo pavadinimo.
Jei norite, užpildykite lauką Šaka, žyma arba pakeitimų patvirtinimas. Palikite jį tuščią, jei norite naudoti numatytąją saugyklos šaką. Norėdami gauti būsimus patvirtintus pakeitimus, naudokite šaką. Pasirinkus konkretų pakeitimų patvirtinimą, versija nesikeičia.
Pasirinkite Importuoti prekyvietę ir, kai būsite paraginti, suteikite prieigą prie „GitHub“.
Peržiūrėkite Importavimo rezultatus, tada atverkite kiekvieną importuotą įskiepį ir sukonfigūruokite jo diegimo taisykles bei reikiamas programėles.

Labai didelės prekyvietės pradinis importavimas gali užtrukti iki 1 valandos. Vėlesnis kasdienis sinchronizavimas paprastai trunka kelias minutes.

Jei įskiepio importuoti nepavyksta, ataskaitoje paaiškinama klaida. Kitus tinkamus įskiepius vis tiek galima importuoti.

Palaikomi formatai

Pasirinktame kataloge turi būti palaikomo formato manifestas:

.agents/plugins/marketplace.json – „Codex“ prekyvietei.
.claude-plugin/marketplace.json – su „Claude“ suderinamai prekyvietei.
.claude-plugin/plugin.json – atskiram „Claude“ įskiepiui, kai nėra prekyvietės manifesto.

Prekyvietės įrašai gali nurodyti įskiepių aplankus toje pačioje saugykloje arba palaikomus „GitHub“ saugyklų šaltinius. Importuojant į darbo erdvę, kitos „Git“ prieglobos paslaugos ir paketų registrų šaltiniai, tokie kaip npm, nepalaikomi.

Informacijos apie palaikomus formatus, JSON pavyzdžius ir šaltinio laukus rasite dokumente Įskiepių valdymas.

Prieigos darbo erdvėje konfigūravimas

Įskiepio turinys gaunamas iš „GitHub“, o diegimas ir autentifikavimas valdomi darbo erdvės nustatymais. Importuojant ir sinchronizuojant saugyklos taisyklių reikšmės, tokios kaip AVAILABLE ar ON_USE, netaikomos. Sukonfigūruokite šiuos nustatymus kiekvienam darbo erdvės įskiepiui.

Skiltyje Diegimo taisyklės kiekvienam tinkamam vaidmeniui pasirinkite Prieinamas arba Įdiegtas. Reikiamos programėlės taip pat turi būti įjungtos, o nariai turi turėti prieigą prie prijungtos paslaugos ir atlikti visus reikiamus autentifikavimo veiksmus.

Sinchronizuojant įskiepio naujinimą ar perkeliant esamą įskiepį į valdymą per „GitHub“, jo darbo erdvės taisyklės išsaugomos. Importavus įskiepį, prieiga prie programėlių nesuteikiama ir narių paskyros neprijungiamos.

Informacijos apie naršymą darbo erdvėje, prieigą prie programėlių ir darbo erdvės valdymą rasite straipsnyje Įskiepių ir programėlių administravimo priemonės, saugumas ir atitiktis.

Įskiepių atnaujinimas

Naujų prekyviečių naujinimų tikrinama kasdien. Norėdami inicijuoti atnaujinimą nelaukdami automatinio sinchronizavimo:

Eikite į administravimo konsolę, pasirinkite norimą „ChatGPT“ darbo erdvę ir atverkite Įskiepiai.
Atverkite Prekyvietės ir pasirinkite prekyvietę.
Pasirinkite Sinchronizuoti dabar.

Sinchronizuojant galima pridėti naujų prekyvietės įrašų ir atnaujinti esamus įskiepius. Prieš sujungdami saugyklos pakeitimus, juos peržiūrėkite, nes automatinis sinchronizavimas gali importuoti naujus įskiepius be papildomo importavimo veiksmo.

Sinchronizavimo rezultatų peržiūra

Po sinchronizavimo peržiūrėkite jo būseną ir išsaugotą ataskaitą. Būsena Baigta — N klaidų reiškia, kad sinchronizavimas baigtas, tačiau kai kurių įskiepių nepavyko apdoroti.

Jei esamo įskiepio naujinimas netinkamas, paliekama paskutinė veikianti jo versija. Kitus tinkamus naujinimus vis tiek galima sėkmingai pritaikyti. Ištaisykite nurodytą problemą „GitHub“, tada pasirinkite Sinchronizuoti dabar, kad bandytumėte dar kartą.

Jei administravimo rodinyje prie atskirai importuoto įskiepio matote Atnaujinti, naudokite šią parinktį tam įskiepiui atnaujinti. Parinktis Atnaujinti įskiepių sąrašą tik iš naujo įkelia rodomą sąrašą, bet nesinchronizuoja su „GitHub“.

Ką svarbu žinoti apie pašalinimą ir ištrynimą

Pašalinus įrašą iš saugyklos, jo importuota kopija darbo erdvėje neištrinama. Įskiepis pažymimas žyma Šaltinyje nebėra.

Ištrynus prekyvietę „ChatGPT“, ištrinami visi iš jos importuoti įskiepiai. Norėdami iš naujo prijungti „GitHub“ ar pakeisti savininką, prekyvietės netrinkite.

Pakartotinis „GitHub“ prijungimas arba prieigos keitimas

Prekyvietei sinchronizuoti naudojamas ją importavusio administratoriaus ryšys su „GitHub“. Ši paskyra turi nuolat turėti prieigą prie prekyvietės saugyklos ir visų joje nurodytų saugyklų.

Pradinės paskyros prijungimas iš naujo

Įsitikinkite, kad importavimui naudota „GitHub“ paskyra vis dar turi prieigą prie visų reikiamų saugyklų.
Paprašykite prekyvietę iš pradžių importavusio administratoriaus atverti „GitHub“ įskiepį „ChatGPT“ ir iš naujo prijungti savo paskyrą.

Perdavimas naujam administratoriui

Naujasis darbo erdvės administratorius gali importuoti tą pačią prekyvietę naudodamas savo ryšį su „GitHub“:

Eikite į administravimo konsolę, pasirinkite norimą „ChatGPT“ darbo erdvę ir atverkite Įskiepiai. Tada pasirinkite Pridėti > Importuoti prekyvietę.
Laukuose Šaltinis, Kelias ir Šaka, žyma arba pakeitimų patvirtinimas įveskite tas pačias reikšmes, kurios naudotos esamai prekyvietei.
Pasirinkite Importuoti prekyvietę ir, kai būsite paraginti, suteikite prieigą prie „GitHub“.

Vėliau sinchronizuojant bus naudojamas naujojo administratoriaus ryšys su „GitHub“. Naujojo administratoriaus paskyra turi turėti skaitymo prieigą prie prekyvietės saugyklos ir visų joje nurodytų saugyklų.

Esamo įskiepio perkėlimas į valdymą per „GitHub“

Prekyvietėje galite valdyti esamą darbo erdvės įskiepį, kuris buvo įkeltas kaip archyvas arba dar nėra valdomas iš „GitHub“ šaltinio. Esamas įskiepis turi būti toje pačioje darbo erdvėje ir turėti tą patį įskiepio pavadinimą. Taip perimti įskiepio, valdomo iš kito „GitHub“ šaltinio, negalima.

Norėdami prekyvietėje nurodyti esamą įskiepį:

Eikite į administravimo konsolę, pasirinkite norimą „ChatGPT“ darbo erdvę ir atverkite Įskiepiai. Atverkite įskiepį.
Nukopijuokite įskiepio ID, esantį jo URL po /admin/plugins/.
Atitinkamame prekyvietės plugins masyvo įraše šalia name ir source pridėkite šį ID kaip pluginId. Nepridėkite jo į įskiepio failą plugin.json.

Įskiepio ID, bendrinimo nustatymai ir darbo erdvės taisyklės išlieka nepakitę. „GitHub“ tampa būsimų naujinimų šaltiniu, todėl vėliau įkeliami archyvai nebegali pakeisti įskiepio.

Perkėlimo pavyzdį ir reikalavimus rasite dokumente Įskiepių valdymas.

Nuorodos į esamą programėlę pridėjimas

Įskiepio šakniniame kataloge esančiame faile .app.json galima nurodyti esamą programėlę. Failo pavadinimo pradžioje palikite tašką ir naudokite programėlės, o ne įskiepio ID. Jei tai savasis įskiepis, failo .codex-plugin/plugin.json lauke apps nustatykite reikšmę ./.app.json.

Ši nuoroda nesukuria programėlės ir nesuteikia papildomų leidimų. Toliau taikomi esami programėlės prieigos darbo erdvėje, autentifikavimo ir veiksmų valdymo nustatymai bei prijungtos paslaugos leidimai.

Informacijos apie JSON formatą rasite dokumente Įskiepių valdymas.

Ką reiškia žyma „Tik kompiuterio programoje“

Įskiepis, pažymėtas Tik kompiuterio programoje, negali veikti „ChatGPT“ žiniatinklio versijoje. Importuoti įskiepiai gali gauti šią žymą, jei juose deklaruoti MCP serveriai, pavyzdžiui, faile mcp.json ar .mcp.json, net jei serveris naudoja nuotolinį HTTPS URL.

Vien pridėjus .app.json nuorodą, žyma Tik kompiuterio programoje nepašalinama. Bet kuri nurodyta programėlė vis tiek turi būti prieinama nario vaidmeniui; jai taikomi įprasti prieigos ir autentifikavimo reikalavimai.

Įskiepių prekyviečių importavimas iš „GitHub“ ir sinchronizavimas