Oversikt

Administratorer for arbeidsområdet kan importere en plugin-markedsplass fra GitHub til arbeidsområdets katalog. En markedsplass er en JSON-katalog som viser hvilke pluginer som skal importeres. Etter import holder daglig synkronisering pluginene oppdatert med endringer fra lageret.


Synkronisering av markedsplassen importerer plugin-innhold – den kobler ikke til kontoene til medlemmer i arbeidsområdet og gir ikke tilgang til appene i en plugin.


Du finner en innføring i pluginer og appene som følger med, i Pluginer i ChatGPT og Codex.

Før du begynner

• Bruk en GitHub-konto som har lesetilgang til markedsplassens lager og alle andre lagre det refererer til. Offentlige og private lagre på github.com støttes.

• Sørg for nødvendig godkjenning fra GitHub-organisasjonen, slik at kontoen som brukes til import, får tilgang til disse lagrene.

• Se gjennom innholdet i lageret. Importen behandler alle gyldige pluginer uten et eget godkjenningstrinn for hver av dem, og fremtidige synkroniseringer kan legge til nye pluginer.

Nye pluginer starter med installasjonspolicyen Tilgjengelig og autentisering ved installasjon. Nye markedsplasser har automatisk daglig synkronisering aktivert. Etter import bør du se gjennom innstillingene for arbeidsområdet og de påkrevde appene for hver plugin.

Importer en markedsplass

1. Gå til administrasjonskonsollen, velg ønsket ChatGPT-arbeidsområde og åpne Pluginer. Velg deretter Legg til og så Importer markedsplass.

2. I Kilde angir du lagerets URL, for eksempel https://github.com/example/team-plugins. Bruk bare URL-en til lageret, ikke til en gren eller mappe.

3. Hvis markedsplassen ligger i en undermappe, angir du mappen i Sti. Angi for eksempel team-tools for team-tools/.agents/plugins/marketplace.json. La Sti stå tomt for å bruke lagerets rotmappe. Ikke angi filnavnet til manifestet.

4. Du kan også angi en Gren, tagg eller commit. La feltet stå tomt for å bruke lagerets standardgren. Bruk en gren for å motta fremtidige commiter. Hvis du velger en bestemt commit, blir versjonen stående på den revisjonen.

5. Velg Importer markedsplass og godkjenn GitHub-tilgang når du blir bedt om det.

6. Se gjennom Importresultater, og åpne deretter hver importerte plugin for å konfigurere installasjonspolicyen og eventuelle påkrevde apper.

Den første importen kan ta opptil 1 time for svært store markedsplasser. Senere daglige synkroniseringer tar vanligvis noen få minutter.

Hvis en plugin ikke kan importeres, forklarer rapporten feilen. Andre gyldige pluginer kan fortsatt importeres.

Støttede formater

Den valgte mappen må inneholde et manifest som støttes:

• .agents/plugins/marketplace.json for en Codex-markedsplass.

• .claude-plugin/marketplace.json for en Claude-kompatibel markedsplass.

• .claude-plugin/plugin.json for en frittstående Claude-plugin når det ikke finnes noe markedsplassmanifest.

Markedsplassoppføringer kan referere til plugin-mapper i samme lager eller støttede GitHub-lagerkilder. Import til arbeidsområdet støtter ikke andre Git-vertstjenester eller kilder fra pakkeregistre, som npm.

Du finner støttede formater, JSON-eksempler og kildefelt i Administrasjon av pluginer.

Konfigurer tilgang i arbeidsområdet

GitHub leverer plugin-innholdet, mens innstillingene for arbeidsområdet styrer installasjon og autentisering. Import og synkronisering tar ikke i bruk policyverdier fra lageret, som AVAILABLE eller ON_USE. Konfigurer disse innstillingene for hver plugin i arbeidsområdet.


Bruk Installasjonspolicy for å velge Tilgjengelig eller Installert for hver kvalifiserte rolle. Påkrevde apper må også være aktivert, og medlemmene må ha tilgang til den tilkoblede tjenesten og fullføre eventuell påkrevd autentisering.


Når du synkroniserer en plugin-oppdatering eller flytter administrasjonen av en eksisterende plugin til GitHub, beholdes pluginens policyer for arbeidsområdet. Import av en plugin gir ikke tilgang til apper og kobler ikke til medlemmenes kontoer.


Du finner informasjon om navigering i arbeidsområdet, apptilgang og kontroller for arbeidsområdet i Administratorkontroller, sikkerhet og samsvar for pluginer og apper.

Hold pluginer oppdatert

Nye markedsplasser ser etter oppdateringer daglig. Slik ber du om en oppdatering uten å vente på automatisk synkronisering:

1. Gå til administrasjonskonsollen, velg ønsket ChatGPT-arbeidsområde og åpne Pluginer.

2. Åpne Markedsplasser og velg markedsplassen.

3. Velg Synkroniser nå.

Synkronisering kan legge til nye markedsplassoppføringer og oppdatere eksisterende pluginer. Se gjennom endringer i lageret før du fletter dem inn, siden automatisk synkronisering kan importere nye pluginer uten et nytt importtrinn.

Se gjennom synkroniseringsresultater

Etter en synkronisering bør du se gjennom statusen og den lagrede rapporten. Fullført – N feil betyr at synkroniseringen er ferdig, men at noen pluginer ikke kunne behandles.


Hvis en oppdatering av en eksisterende plugin er ugyldig, beholdes den siste fungerende versjonen. Andre gyldige oppdateringer kan fortsatt fullføres. Rett det rapporterte problemet i GitHub, og velg deretter Synkroniser nå for å prøve på nytt.


Hvis administratorvisningen viser Oppdater for en plugin som er importert enkeltvis, bruker du dette valget til å oppdatere pluginen. Oppdater plugin-listen laster bare inn listen som vises, på nytt. Det synkroniserer ikke fra GitHub.

Forstå forskjellen på fjerning og sletting

Hvis du fjerner en oppføring fra lageret, slettes ikke den importerte kopien i arbeidsområdet. Pluginen merkes som Ikke lenger i kilden.


Hvis du sletter markedsplassen i ChatGPT, slettes alle pluginer som er importert fra den. Ikke slett en markedsplass for å koble til GitHub på nytt eller bytte eier.

Koble til GitHub på nytt eller endre tilgangen

Synkronisering av markedsplassen bruker GitHub-tilkoblingen til administratoren som importerte den. Denne kontoen må fortsatt ha tilgang til markedsplassens lager og alle lagre det refereres til.

Koble til den opprinnelige kontoen på nytt

1. Kontroller at GitHub-kontoen som ble brukt til importen, fortsatt har tilgang til alle nødvendige lagre.

2. Be administratoren som opprinnelig importerte markedsplassen, om å åpne GitHub-pluginen i ChatGPT og koble til kontoen sin på nytt.

Overfør til en ny administrator

Den nye administratoren for arbeidsområdet kan importere den samme markedsplassen med sin egen GitHub-tilkobling:

1. Gå til administrasjonskonsollen, velg ønsket ChatGPT-arbeidsområde og åpne Pluginer. Velg deretter Legg til > Importer markedsplass.

2. Angi de samme verdiene for Kilde, Sti og Gren, tagg eller commit som ble brukt for den eksisterende markedsplassen.

3. Velg Importer markedsplass og godkjenn GitHub-tilgang når du blir bedt om det.

Fremtidige synkroniseringer bruker den nye administratorens GitHub-tilkobling. Den nye administratorens konto må ha lesetilgang til markedsplassens lager og alle lagre det refererer til.

Flytt administrasjonen av en eksisterende plugin til GitHub

Du kan bruke en markedsplass til å administrere en eksisterende plugin i arbeidsområdet som ble lastet opp som en arkivfil, eller som ennå ikke administreres via en GitHub-kilde. Den eksisterende pluginen må være i samme arbeidsområde og ha samme plugin-navn. Du kan ikke overta administrasjonen av en plugin på denne måten hvis den administreres via en annen GitHub-kilde.


Slik identifiserer du den eksisterende pluginen i markedsplassen:

1. Gå til administrasjonskonsollen, velg ønsket ChatGPT-arbeidsområde og åpne Pluginer. Åpne pluginen.

2. Kopier plugin-ID-en etter /admin/plugins/ i URL-en.

3. Legg til ID-en som pluginId ved siden av name og source i den tilsvarende oppføringen i markedsplassens plugins-array. Ikke legg den til i pluginens plugin.json-fil.

Pluginen beholder ID-en, delingsinnstillingene og policyene for arbeidsområdet. GitHub blir kilden for fremtidige oppdateringer, så senere opplastinger av arkivfiler kan ikke erstatte pluginen.


Du finner et migreringseksempel og krav i Administrasjon av pluginer.

Referer til en eksisterende app

En plugin kan referere til en eksisterende app i .app.json i pluginens rotmappe. Ta med punktumet først i filnavnet, og bruk appens ID i stedet for en plugin-ID. For en plugin i eget format setter du feltet apps i .codex-plugin/plugin.json til ./.app.json.


Referansen oppretter ikke en app og gir ingen ekstra tillatelser. Appens eksisterende tilgang i arbeidsområdet, autentisering, handlingskontroller og tillatelser for tilkoblede tjenester gjelder fortsatt.


Du finner informasjon om JSON-formatet i Administrasjon av pluginer.

Forstå merket «Kun i skrivebordsappen»

En plugin merket Kun i skrivebordsappen kan ikke kjøres i ChatGPT på nettet. Importerte pluginer kan få dette merket når de deklarerer MCP-servere, for eksempel i mcp.json eller .mcp.json, selv når en server bruker en ekstern HTTPS-URL.


Det å legge til en .app.json-referanse fjerner ikke i seg selv merket Kun i skrivebordsappen. Alle apper det refereres til, må fortsatt være tilgjengelige for medlemmets rolle, og de vanlige kravene til tilgang og autentisering gjelder.