Prezentare generală

Administratorii spațiului de lucru pot importa un catalog de pluginuri din GitHub în directorul spațiului de lucru. Un catalog de pluginuri este un catalog JSON care enumeră pluginurile de importat. După import, sincronizarea zilnică menține pluginurile la zi cu modificările din depozit.


Sincronizarea catalogului importă conținutul pluginurilor, dar nu conectează conturile membrilor spațiului de lucru și nu acordă acces la aplicațiile incluse într-un plugin.


Pentru o prezentare a pluginurilor și a aplicațiilor incluse, consultă: Pluginuri în ChatGPT și Codex.

Înainte de a începe

• Folosește un cont GitHub cu acces de citire la depozitul catalogului și la toate celelalte depozite la care acesta face referire. Sunt acceptate depozitele publice și private de pe github.com.

• Obține toate aprobările necesare din partea organizației GitHub pentru ca acel cont folosit la import să poată accesa depozitele respective.

• Verifică conținutul depozitului. Importul procesează toate pluginurile valide fără o etapă separată de aprobare pentru fiecare, iar sincronizările viitoare pot adăuga pluginuri noi.

Pluginurile noi au inițial politica de instalare Disponibil și necesită autentificare la instalare. Cataloagele noi au sincronizarea automată zilnică activată. După import, verifică setările din spațiul de lucru și aplicațiile necesare pentru fiecare plugin.

Importă un catalog de pluginuri

1. Accesează Consola de administrare, selectează spațiul de lucru ChatGPT dorit și deschide Pluginuri. Apoi selectează Adaugă și alege Importă un catalog de pluginuri.

2. În Sursă, introdu adresa URL a depozitului, de exemplu https://github.com/example/team-plugins. Folosește doar adresa URL a depozitului, nu adresa unei ramuri sau a unui folder.

3. Dacă acest catalog se află într-un subdirector, introdu directorul respectiv în Cale. De exemplu, introdu team-tools pentru team-tools/.agents/plugins/marketplace.json. Lasă câmpul Cale necompletat pentru a folosi directorul rădăcină al depozitului. Nu introduce numele fișierului manifest.

4. Opțional, completează câmpul Ramură, etichetă sau commit. Lasă-l necompletat pentru a folosi ramura implicită a depozitului. Folosește o ramură pentru a primi commiturile viitoare. Dacă alegi un commit fix, versiunea rămâne neschimbată.

5. Selectează Importă un catalog de pluginuri și autorizează accesul la GitHub când ți se solicită.

6. Verifică Rezultatele importului, apoi deschide fiecare plugin importat pentru a-i configura politica de instalare și aplicațiile necesare.

Importul inițial poate dura până la o oră pentru cataloagele foarte mari. Sincronizările zilnice ulterioare durează de obicei câteva minute.

Dacă un plugin nu poate fi importat, raportul explică eroarea. Celelalte pluginuri valide pot fi importate în continuare.

Formate acceptate

Directorul selectat trebuie să conțină un manifest acceptat:

• .agents/plugins/marketplace.json pentru un catalog Codex.

• .claude-plugin/marketplace.json pentru un catalog compatibil cu Claude.

• .claude-plugin/plugin.json pentru un plugin Claude de sine stătător, atunci când nu există un manifest de catalog.

Intrările din catalog pot face referire la foldere de pluginuri din același depozit sau la surse acceptate din depozite GitHub. Importul în spațiul de lucru nu acceptă alte servicii de găzduire Git sau surse din registre de pachete, precum npm.

Pentru formatele acceptate, exemple JSON și câmpurile sursei, consultă: Gestionarea pluginurilor.

Configurează accesul în spațiul de lucru

GitHub furnizează conținutul pluginurilor, iar setările spațiului de lucru controlează instalarea și autentificarea. Importul și sincronizarea nu aplică valorile politicilor din depozit, precum AVAILABLE sau ON_USE. Configurează aceste setări pentru fiecare plugin din spațiul tău de lucru.


Folosește Politica de instalare pentru a alege Disponibil sau Instalat pentru fiecare rol eligibil. Aplicațiile necesare trebuie, de asemenea, să fie activate, iar membrii trebuie să aibă acces la serviciul conectat și să parcurgă pașii de autentificare necesari.


Sincronizarea unei actualizări de plugin sau trecerea la gestionarea prin GitHub a unui plugin existent păstrează politicile acestuia din spațiul de lucru. Importarea unui plugin nu acordă acces la aplicații și nu conectează conturile membrilor.


Pentru navigarea în spațiul de lucru, accesul la aplicații și opțiunile de control ale spațiului de lucru, consultă: Opțiuni de control pentru administratori, securitate și conformitate pentru pluginuri și aplicații.

Menține pluginurile la zi

Pentru cataloagele noi se verifică zilnic dacă există actualizări. Pentru a solicita o actualizare fără să aștepți sincronizarea automată:

1. Accesează Consola de administrare, selectează spațiul de lucru ChatGPT dorit și deschide Pluginuri.

2. Deschide Cataloage de pluginuri și selectează catalogul.

3. Selectează Sincronizează acum.

Sincronizarea poate adăuga intrări noi din catalog și poate actualiza pluginurile existente. Verifică modificările din depozit înainte de a le integra, deoarece sincronizarea automată poate importa pluginuri noi fără o etapă suplimentară de import.

Verifică rezultatele sincronizării

După o sincronizare, verifică starea acesteia și raportul salvat. Finalizată — N erori înseamnă că sincronizarea s-a încheiat, dar unele pluginuri nu au putut fi procesate.


Dacă o actualizare a unui plugin existent este nevalidă, se păstrează ultima versiune funcțională a acestuia. Celelalte actualizări valide se pot finaliza în continuare. Remediază problema raportată în GitHub, apoi selectează Sincronizează acum pentru a încerca din nou.


Dacă interfața de administrare afișează Reîmprospătează pentru un plugin importat individual, folosește această opțiune pentru a reîmprospăta pluginul respectiv. Reîmprospătează lista de pluginuri doar reîncarcă lista afișată; nu sincronizează conținutul din GitHub.

Ce trebuie să știi despre eliminare și ștergere

Eliminarea unei intrări din depozit nu șterge copia acesteia importată în spațiul de lucru. Pluginul este marcat cu Nu mai există în sursă.


Ștergerea catalogului în ChatGPT șterge toate pluginurile importate din acesta. Nu șterge un catalog pentru a reconecta GitHub sau pentru a schimba proprietarul.

Reconectează sau modifică accesul la GitHub

Sincronizarea catalogului folosește conexiunea GitHub a administratorului care l-a importat. Contul respectiv trebuie să aibă în continuare acces la depozitul catalogului și la toate depozitele la care acesta face referire.

Reconectează contul inițial

1. Confirmă că acel cont GitHub folosit la import are în continuare acces la toate depozitele necesare.

2. Cere administratorului care a importat inițial catalogul să deschidă pluginul GitHub în ChatGPT și să își reconecteze contul.

Transferă gestionarea către un nou administrator

Noul administrator al spațiului de lucru poate importa același catalog folosind propria conexiune GitHub:

1. Accesează Consola de administrare, selectează spațiul de lucru ChatGPT dorit și deschide Pluginuri. Apoi selectează Adaugă > Importă un catalog de pluginuri.

2. Introdu aceleași valori pentru Sursă, Cale și Ramură, etichetă sau commit ca cele folosite pentru catalogul existent.

3. Selectează Importă un catalog de pluginuri și autorizează accesul la GitHub când ți se solicită.

Sincronizările viitoare vor folosi conexiunea GitHub a noului administrator. Contul noului administrator trebuie să aibă acces de citire la depozitul catalogului și la toate depozitele la care acesta face referire.

Treci la gestionarea prin GitHub a unui plugin existent

Poți folosi un catalog pentru a gestiona un plugin existent în spațiul de lucru, care a fost încărcat ca arhivă sau nu este încă gestionat printr-o sursă GitHub. Pluginul existent trebuie să fie în același spațiu de lucru și să aibă același nume. Un plugin gestionat printr-o altă sursă GitHub nu poate fi preluat în acest mod.


Pentru a identifica pluginul existent în catalogul tău:

1. Accesează Consola de administrare, selectează spațiul de lucru ChatGPT dorit și deschide Pluginuri. Deschide pluginul.

2. Copiază ID-ul pluginului aflat după /admin/plugins/ în adresa sa URL.

3. Adaugă acel ID drept pluginId, lângă name și source, în intrarea corespunzătoare din matricea plugins a catalogului. Nu îl adăuga în fișierul plugin.json al pluginului.

Pluginul își păstrează ID-ul, setările de partajare și politicile din spațiul de lucru. GitHub devine sursa actualizărilor viitoare, astfel că încărcările ulterioare de arhive nu pot înlocui pluginul.


Pentru un exemplu de migrare și cerințele aferente, consultă: Gestionarea pluginurilor.

Adaugă o referință la o aplicație existentă

Un plugin poate face referire la o aplicație existentă în fișierul .app.json din directorul rădăcină al pluginului. Include punctul de la începutul numelui fișierului și folosește ID-ul aplicației, nu un ID de plugin. Pentru un plugin nativ, setează câmpul apps din .codex-plugin/plugin.json la ./.app.json.


Referința nu creează o aplicație și nu acordă permisiuni suplimentare. Se aplică în continuare setările existente ale aplicației privind accesul în spațiul de lucru, autentificarea, controlul acțiunilor și permisiunile pentru serviciul conectat.


Pentru formatul JSON, consultă: Gestionarea pluginurilor.

Ce înseamnă eticheta „Doar pe desktop”

Un plugin marcat cu Doar pe desktop nu poate rula în versiunea web a ChatGPT. Pluginurile importate pot primi această etichetă atunci când declară servere MCP, de exemplu în mcp.json sau .mcp.json, chiar și atunci când un server folosește o adresă URL HTTPS la distanță.


Simpla adăugare a unei referințe în .app.json nu elimină eticheta Doar pe desktop. Orice aplicație la care se face referire trebuie să fie în continuare disponibilă pentru rolul membrului, iar cerințele sale obișnuite de acces și autentificare se aplică.