Oversigt

Administratorer af arbejdsområder kan importere en plugin-markedsplads fra GitHub til arbejdsområdets katalog. En markedsplads er et JSON-katalog med de plugins, der skal importeres. Efter importen holder daglig synkronisering pluginerne opdateret med ændringer fra lageret.


Synkronisering af markedspladsen importerer plugin-indhold – den forbinder ikke arbejdsområdets medlemmers konti og giver ikke adgang til de apps, der indgår i et plugin.


Du kan få en introduktion til plugins og de apps, der indgår i dem, i: Plugins i ChatGPT og Codex.

Før du begynder

• Brug en GitHub-konto med læseadgang til markedspladsens lager og alle andre lagre, som den henviser til. Offentlige og private lagre på github.com understøttes.

• Sørg for at få eventuel påkrævet godkendelse fra GitHub-organisationen, så den konto, der bruges til importen, kan få adgang til disse lagre.

• Gennemgå lagerets indhold. Importen behandler alle gyldige plugins uden et særskilt godkendelsestrin for hvert enkelt, og fremtidige synkroniseringer kan tilføje nye plugins.

Nye plugins starter med installationspolitikken Tilgængelig og godkendelse ved installation. Nye markedspladser har automatisk daglig synkronisering aktiveret. Efter importen skal du gennemgå hvert plugins indstillinger i arbejdsområdet og dets påkrævede apps.

Importér en markedsplads

1. Gå til administrationskonsollen, vælg det ønskede ChatGPT-arbejdsområde, og åbn Plugins. Vælg derefter Tilføj, og vælg Importér markedsplads.

2. Indtast lagerets URL i Kilde, f.eks. https://github.com/example/team-plugins. Brug kun lagerets URL, ikke en URL til en gren eller mappe.

3. Hvis markedspladsen ligger i en undermappe, skal du angive den mappe i Sti. Angiv f.eks. team-tools for team-tools/.agents/plugins/marketplace.json. Lad Sti være tom for at bruge lagerets rodmappe. Angiv ikke manifest-filens navn.

4. Angiv eventuelt en Gren, tag eller commit. Lad feltet være tomt for at bruge lagerets standardgren. Brug en gren for at modtage fremtidige commits. En fast commit forbliver på den pågældende revision.

5. Vælg Importér markedsplads, og giv adgang til GitHub, når du bliver bedt om det.

6. Gennemgå Importresultater, og åbn derefter hvert importeret plugin for at konfigurere dets installationspolitik og eventuelle påkrævede apps.

Den første import kan tage op til 1 time for meget store markedspladser. Efterfølgende daglige synkroniseringer tager typisk et par minutter.

Hvis et plugin ikke kan importeres, forklarer rapporten fejlen. Andre gyldige plugins kan stadig importeres.

Understøttede formater

Den valgte mappe skal indeholde et understøttet manifest:

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

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

• .claude-plugin/plugin.json for et selvstændigt Claude-plugin, når der ikke findes et markedspladsmanifest.

Poster i markedspladsen kan henvise til plugin-mapper i samme lager eller til understøttede GitHub-lagre som kilder. Import til arbejdsområder understøtter ikke andre Git-værter eller kilder fra pakkeregistre som npm.

Læs om understøttede formater, JSON-eksempler og kildefelter i: Administration af plugins.

Konfigurer adgang i arbejdsområdet

GitHub leverer plugin-indholdet, mens arbejdsområdets indstillinger styrer installation og godkendelse. Import og synkronisering anvender ikke politikværdier fra lageret, såsom AVAILABLE eller ON_USE. Konfigurer disse indstillinger for hvert plugin i dit arbejdsområde.


Brug Installationspolitik til at vælge Tilgængelig eller Installeret for hver relevant rolle. Påkrævede apps skal også være aktiveret, og medlemmer skal have adgang til den tilsluttede tjeneste og gennemføre eventuel påkrævet godkendelse.


Når du synkroniserer en plugin-opdatering eller overgår til at administrere et eksisterende plugin via GitHub, bevares dets politikker i arbejdsområdet. Import af et plugin giver ikke adgang til apps og forbinder ikke medlemmernes konti.


Læs om navigation i arbejdsområdet, adgang til apps og arbejdsområdets kontroller i: Administratorkontroller, sikkerhed og compliance for plugins og apps.

Hold plugins opdateret

Nye markedspladser søger efter opdateringer dagligt. Sådan anmoder du om en opdatering uden at vente på automatisk synkronisering:

1. Gå til administrationskonsollen, vælg det ønskede ChatGPT-arbejdsområde, og åbn Plugins.

2. Åbn Markedspladser, og vælg markedspladsen.

3. Vælg Synkroniser nu.

Synkronisering kan tilføje nye poster fra markedspladsen og opdatere eksisterende plugins. Gennemgå ændringer i lageret, før du fletter dem, da automatisk synkronisering kan importere nye plugins uden et ekstra importtrin.

Gennemgå synkroniseringsresultater

Efter en synkronisering skal du gennemgå dens status og den gemte rapport. Fuldført – N fejl betyder, at synkroniseringen er afsluttet, men at nogle plugins ikke kunne behandles.


Hvis en opdatering af et eksisterende plugin er ugyldig, bevares den seneste fungerende version. Andre gyldige opdateringer kan stadig fuldføres. Ret det rapporterede problem i GitHub, og vælg derefter Synkroniser nu for at prøve igen.


Hvis din administratorvisning viser Opdater for et individuelt importeret plugin, skal du bruge den mulighed til at opdatere pluginet. Opdater plugin-liste genindlæser kun den viste liste og synkroniserer ikke fra GitHub.

Forstå fjernelse og sletning

Når du fjerner en post fra lageret, slettes den importerede kopi i arbejdsområdet ikke. Pluginet markeres som Ikke længere i kilden.


Hvis du sletter markedspladsen i ChatGPT, slettes alle plugins, der er importeret fra den. Slet ikke en markedsplads for at genoprette forbindelsen til GitHub eller skifte ejer.

Genopret eller skift GitHub-adgang

Synkronisering af markedspladsen bruger GitHub-forbindelsen for den administrator, der importerede den. Den konto skal fortsat have adgang til markedspladsens lager og alle lagre, som den henviser til.

Genopret forbindelsen til den oprindelige konto

1. Kontrollér, at den GitHub-konto, der blev brugt til importen, stadig har adgang til alle påkrævede lagre.

2. Bed den administrator, der oprindeligt importerede markedspladsen, om at åbne GitHub-pluginet i ChatGPT og genoprette forbindelsen til sin konto.

Overfør til en ny administrator

Den nye administrator af arbejdsområdet kan importere den samme markedsplads via sin egen GitHub-forbindelse:

1. Gå til administrationskonsollen, vælg det ønskede ChatGPT-arbejdsområde, og åbn Plugins. Vælg derefter Tilføj > Importér markedsplads.

2. Angiv de samme værdier for Kilde, Sti og Gren, tag eller commit, som blev brugt til den eksisterende markedsplads.

3. Vælg Importér markedsplads, og giv adgang til GitHub, når du bliver bedt om det.

Fremtidige synkroniseringer bruger den nye administrators GitHub-forbindelse. Den nye administrators konto skal have læseadgang til markedspladsens lager og alle lagre, som den henviser til.

Overgå til at administrere et eksisterende plugin via GitHub

Du kan bruge en markedsplads til at administrere et eksisterende plugin i arbejdsområdet, som blev uploadet som et arkiv, eller som endnu ikke administreres via en GitHub-kilde. Det eksisterende plugin skal være i samme arbejdsområde og have samme plugin-navn. Et plugin, der administreres via en anden GitHub-kilde, kan ikke overtages på denne måde.


Sådan identificerer du det eksisterende plugin i din markedsplads:

1. Gå til administrationskonsollen, vælg det ønskede ChatGPT-arbejdsområde, og åbn Plugins. Åbn pluginet.

2. Kopiér plugin-id'et efter /admin/plugins/ i dets URL.

3. Tilføj dette id som pluginId ved siden af name og source i den tilsvarende post i markedspladsens plugins-array. Tilføj det ikke i pluginets plugin.json-fil.

Pluginet beholder sit id, sine delingsindstillinger og sine politikker i arbejdsområdet. GitHub bliver kilden til fremtidige opdateringer, så senere arkivuploads kan ikke erstatte pluginet.


Se et eksempel på migrering og kravene i: Administration af plugins.

Henvis til en eksisterende app

Et plugin kan henvise til en eksisterende app i .app.json i pluginets rodmappe. Medtag punktummet i starten af filnavnet, og brug appens id frem for et plugin-id. For et plugin i det native format skal du sætte feltet apps i .codex-plugin/plugin.json til ./.app.json.


Henvisningen opretter ikke en app og giver ikke yderligere tilladelser. Appens eksisterende adgang i arbejdsområdet, godkendelse, handlingskontroller og tilladelser til tilsluttede tjenester gælder stadig.


Læs om JSON-formatet i: Administration af plugins.

Forstå mærkningen Kun på computer

Et plugin, der er markeret med Kun på computer, kan ikke køre i ChatGPT på nettet. Importerede plugins kan få denne mærkning, når de angiver MCP-servere, f.eks. i mcp.json eller .mcp.json, også når en server bruger en ekstern HTTPS-URL.


Tilføjelse af en .app.json-henvisning fjerner ikke i sig selv mærkningen Kun på computer. Enhver app, der henvises til, skal stadig være tilgængelig for medlemmets rolle, og appens normale krav til adgang og godkendelse gælder.