Yleiskatsaus

Työtilan ylläpitäjät voivat tuoda lisäosien markkinapaikan GitHubista työtilansa hakemistoon. Markkinapaikka on JSON-luettelo, joka sisältää tuotavat lisäosat. Tuonnin jälkeen päivittäinen synkronointi pitää lisäosat ajan tasalla repositorion muutosten kanssa.


Markkinapaikan synkronointi tuo lisäosien sisällön. Se ei yhdistä työtilan jäsenten tilejä eikä anna käyttöoikeutta lisäosaan sisältyviin sovelluksiin.


Lisäosat ja niihin sisältyvät sovellukset esitellään artikkelissa Lisäosat ChatGPT:ssä ja Codexissa.

Ennen aloittamista

• Käytä GitHub-tiliä, jolla on lukuoikeus markkinapaikan repositorioon ja kaikkiin muihin repositorioihin, joihin se viittaa. github.com-palvelun julkisia ja yksityisiä repositorioita tuetaan.

• Hanki tarvittavat GitHub-organisaation hyväksynnät, jotta tuontiin käytettävä tili pääsee kyseisiin repositorioihin.

• Tarkista repositorion sisältö. Tuonti käsittelee kaikki kelvolliset lisäosat ilman erillistä lisäosakohtaista hyväksyntää, ja tulevat synkronoinnit voivat lisätä uusia lisäosia.

Uusien lisäosien asennuskäytäntö on aluksi Saatavilla, ja todennus tehdään asennuksen yhteydessä. Uusissa markkinapaikoissa automaattinen päivittäinen synkronointi on käytössä. Tarkista tuonnin jälkeen kunkin lisäosan työtila-asetukset ja tarvittavat sovellukset.

Tuo markkinapaikka

1. Siirry hallintakonsoliin, valitse haluamasi ChatGPT-työtila ja avaa Lisäosat. Valitse sitten Lisää ja Tuo markkinapaikka.

2. Kirjoita Lähde-kenttään repositorion URL-osoite, esimerkiksi https://github.com/example/team-plugins. Käytä pelkkää repositorion URL-osoitetta, älä haaran tai kansion URL-osoitetta.

3. Jos markkinapaikka on alihakemistossa, kirjoita kyseinen hakemisto Polku-kenttään. Jos tiedoston polku on esimerkiksi team-tools/.agents/plugins/marketplace.json, kirjoita team-tools. Jos käytät repositorion juurihakemistoa, jätä Polku tyhjäksi. Älä kirjoita kokoonpanotietojen tiedostonimeä.

4. Voit halutessasi täyttää kentän Haara, tunniste tai commit. Jätä se tyhjäksi, jos haluat käyttää repositorion oletushaaraa. Käytä haaraa, jos haluat vastaanottaa tulevat commitit. Jos määrität tietyn commitin, versio pysyy siinä.

5. Valitse Tuo markkinapaikka ja anna pyydettäessä GitHub-käyttöoikeus.

6. Tarkista Tuonnin tulokset ja avaa sitten kukin tuotu lisäosa määrittääksesi sen asennuskäytännön ja tarvittavat sovellukset.

Erittäin suurten markkinapaikkojen ensimmäinen tuonti voi kestää jopa tunnin. Seuraavat päivittäiset synkronoinnit kestävät yleensä muutaman minuutin.

Jos lisäosaa ei voi tuoda, raportissa kerrotaan virheen syy. Muut kelvolliset lisäosat voidaan silti tuoda.

Tuetut muodot

Valitun hakemiston on sisällettävä kokoonpanotiedot tuetussa muodossa:

• .agents/plugins/marketplace.json Codex-markkinapaikalle.

• .claude-plugin/marketplace.json Claude-yhteensopivalle markkinapaikalle.

• .claude-plugin/plugin.json erilliselle Claude-lisäosalle, kun markkinapaikan kokoonpanotietoja ei ole.

Markkinapaikan tietueet voivat viitata saman repositorion lisäosakansioihin tai tuettuihin GitHub-repositoriolähteisiin. Työtilaan tuonti ei tue muita Git-palveluja eikä pakettirekisterilähteitä, kuten npm:ää.

Tuetut muodot, JSON-esimerkit ja lähdekentät löytyvät ohjeesta Lisäosien hallinta.

Määritä työtilan käyttöoikeudet

Lisäosien sisältö tulee GitHubista, mutta asennusta ja todennusta hallitaan työtilan asetuksilla. Tuonti ja synkronointi eivät ota käyttöön repositorion käytäntöarvoja, kuten AVAILABLE tai ON_USE. Määritä nämä asetukset työtilan jokaiselle lisäosalle.


Valitse Asennuskäytäntö-asetuksella Saatavilla tai Asennettu kullekin soveltuvalle roolille. Myös tarvittavat sovellukset on otettava käyttöön. Jäsenillä on oltava käyttöoikeus yhdistettyyn palveluun, ja heidän on suoritettava tarvittava todennus.


Lisäosan päivityksen synkronointi tai olemassa olevan lisäosan siirtäminen hallittavaksi GitHubissa säilyttää lisäosan työtilakäytännöt. Lisäosan tuonti ei anna käyttöoikeutta sovelluksiin eikä yhdistä jäsenten tilejä.


Lisätietoja työtilassa siirtymisestä, sovellusten käyttöoikeuksista ja työtilan hallinta-asetuksista on artikkelissa Lisäosien ja sovellusten ylläpitoasetukset, tietoturva ja vaatimustenmukaisuus.

Pidä lisäosat ajan tasalla

Uusien markkinapaikkojen päivitykset tarkistetaan päivittäin. Voit pyytää päivitystä odottamatta automaattista synkronointia näin:

1. Siirry hallintakonsoliin, valitse haluamasi ChatGPT-työtila ja avaa Lisäosat.

2. Avaa Markkinapaikat ja valitse markkinapaikka.

3. Valitse Synkronoi nyt.

Synkronointi voi lisätä markkinapaikan uusia tietueita ja päivittää olemassa olevia lisäosia. Tarkista repositorion muutokset ennen niiden yhdistämistä, sillä automaattinen synkronointi voi tuoda uusia lisäosia ilman erillistä tuontivaihetta.

Tarkista synkronoinnin tulokset

Tarkista synkronoinnin jälkeen sen tila ja tallennettu raportti. Valmis – N virhettä tarkoittaa, että synkronointi valmistui, mutta joitakin lisäosia ei voitu käsitellä.


Jos olemassa olevan lisäosan päivitys on virheellinen, sen viimeisin toimiva versio säilytetään. Muut kelvolliset päivitykset voivat silti valmistua. Korjaa raportoitu ongelma GitHubissa ja yritä sitten uudelleen valitsemalla Synkronoi nyt.


Jos ylläpitonäkymässä näkyy Päivitä erikseen tuodun lisäosan kohdalla, päivitä kyseinen lisäosa sillä. Päivitä lisäosaluettelo lataa vain näytettävän luettelon uudelleen. Se ei synkronoi tietoja GitHubista.

Poistamisen vaikutukset

Tietueen poistaminen repositoriosta ei poista sen työtilaan tuotua kopiota. Lisäosaan tulee merkintä Ei enää lähteessä.


Markkinapaikan poistaminen ChatGPT:ssä poistaa kaikki siitä tuodut lisäosat. Älä poista markkinapaikkaa, jos haluat yhdistää GitHubin uudelleen tai vaihtaa omistajaa.

Yhdistä GitHub uudelleen tai vaihda käytettävää tiliä

Markkinapaikan synkronointi käyttää sen tuoneen ylläpitäjän GitHub-yhteyttä. Kyseisellä tilillä on oltava jatkuvasti käyttöoikeus markkinapaikan repositorioon ja kaikkiin repositorioihin, joihin se viittaa.

Yhdistä alkuperäinen tili uudelleen

1. Varmista, että tuontiin käytetyllä GitHub-tilillä on edelleen käyttöoikeus kaikkiin tarvittaviin repositorioihin.

2. Pyydä markkinapaikan alun perin tuonutta ylläpitäjää avaamaan GitHub-lisäosa ChatGPT:ssä ja yhdistämään tilinsä uudelleen.

Siirrä uudelle ylläpitäjälle

Työtilan uusi ylläpitäjä voi tuoda saman markkinapaikan omalla GitHub-yhteydellään:

1. Siirry hallintakonsoliin, valitse haluamasi ChatGPT-työtila ja avaa Lisäosat. Valitse sitten Lisää > Tuo markkinapaikka.

2. Kirjoita kenttiin Lähde, Polku ja Haara, tunniste tai commit samat arvot kuin olemassa olevalla markkinapaikalla.

3. Valitse Tuo markkinapaikka ja anna pyydettäessä GitHub-käyttöoikeus.

Tulevat synkronoinnit käyttävät uuden ylläpitäjän GitHub-yhteyttä. Uuden ylläpitäjän tilillä on oltava lukuoikeus markkinapaikan repositorioon ja kaikkiin repositorioihin, joihin se viittaa.

Siirrä olemassa oleva lisäosa hallittavaksi GitHubissa

Voit hallita markkinapaikan kautta työtilan olemassa olevaa lisäosaa, joka on ladattu arkistotiedostona tai jota ei vielä hallita GitHub-lähteen kautta. Olemassa olevan lisäosan on oltava samassa työtilassa, ja sillä on oltava sama lisäosan nimi. Toisen GitHub-lähteen hallitsemaa lisäosaa ei voi ottaa hallintaan tällä tavalla.


Määritä olemassa oleva lisäosa markkinapaikassasi näin:

1. Siirry hallintakonsoliin, valitse haluamasi ChatGPT-työtila ja avaa Lisäosat. Avaa lisäosa.

2. Kopioi lisäosan tunnus sen URL-osoitteesta kohdan /admin/plugins/ jälkeen.

3. Lisää tunnus pluginId-kenttään name- ja source-kenttien rinnalle markkinapaikan plugins-taulukon vastaavaan tietueeseen. Älä lisää sitä lisäosan plugin.json-tiedostoon.

Lisäosan tunnus, jakoasetukset ja työtilan käytännöt säilyvät. GitHubista tulee tulevien päivitysten lähde, joten lisäosaa ei voi enää korvata lataamalla arkistotiedostoa.


Esimerkki siirrosta ja sen vaatimukset ovat ohjeessa Lisäosien hallinta.

Viittaa olemassa olevaan sovellukseen

Lisäosa voi viitata olemassa olevaan sovellukseen lisäosan juurihakemiston .app.json-tiedostossa. Sisällytä tiedostonimen alkuun piste ja käytä sovelluksen tunnusta lisäosan tunnuksen sijaan. Jos kyseessä on natiivi lisäosa, aseta .codex-plugin/plugin.json-tiedoston apps-kentän arvoksi ./.app.json.


Viittaus ei luo sovellusta eikä anna lisäoikeuksia. Sovelluksen nykyiset työtilan käyttöoikeudet, todennus, toimintojen hallinta-asetukset ja yhdistettyjen palvelujen käyttöoikeudet ovat edelleen voimassa.


Lisätietoja JSON-muodosta on ohjeessa Lisäosien hallinta.

Mitä Vain työpöytäsovelluksessa -merkintä tarkoittaa

Lisäosaa, jossa on merkintä Vain työpöytäsovelluksessa, ei voi käyttää ChatGPT:n verkkoversiossa. Tuodut lisäosat voivat saada tämän merkinnän, jos ne määrittelevät MCP-palvelimia esimerkiksi mcp.json- tai .mcp.json-tiedostossa, vaikka palvelin käyttäisi HTTPS-etäosoitetta.



.app.json-viittauksen lisääminen ei yksin poista Vain työpöytäsovelluksessa -merkintää. Viitatun sovelluksen on edelleen oltava jäsenen roolin käytettävissä, ja sovelluksen normaalit käyttöoikeus- ja todennusvaatimukset ovat voimassa.