Pangkalahatang-ideya

Maaaring mag-import ang mga admin ng workspace ng marketplace ng mga plugin mula sa GitHub papunta sa directory ng kanilang workspace. Ang marketplace ay isang JSON catalog na naglilista ng mga plugin na ii-import. Pagkatapos ng pag-import, pinananatiling napapanahon ng araw-araw na pag-sync ang mga plugin ayon sa mga pagbabago sa repository.


Ini-import ng pag-sync ng marketplace ang nilalaman ng plugin — hindi nito ikinokonekta ang mga account ng mga miyembro ng workspace o binibigyan sila ng access sa mga app na kasama sa isang plugin.


Para sa pagpapakilala sa mga plugin at sa mga app na kasama sa mga ito, tingnan ang: Mga plugin sa ChatGPT at Codex.

Bago ka magsimula

• Gumamit ng GitHub account na may pahintulot na magbasa sa repository ng marketplace at sa lahat ng iba pang repository na tinutukoy nito. Sinusuportahan ang mga pampubliko at pribadong repository sa github.com.

• Kunin ang anumang kinakailangang pag-apruba ng organisasyon sa GitHub para ma-access ng account na gagamitin sa pag-import ang mga repository na iyon.

• Suriin ang nilalaman ng repository. Pinoproseso ng pag-import ang lahat ng valid na plugin nang walang hiwalay na pag-apruba para sa bawat isa, at maaaring magdagdag ng mga bagong plugin ang mga susunod na pag-sync.

Ang mga bagong plugin ay may paunang setting na Available para sa pag-install at nangangailangan ng authentication kapag ini-install. Naka-enable ang awtomatikong araw-araw na pag-sync sa mga bagong marketplace. Pagkatapos mag-import, suriin ang mga setting sa workspace at mga kinakailangang app ng bawat plugin.

Mag-import ng marketplace

1. Pumunta sa Console ng Admin, piliin ang nais na workspace sa ChatGPT, at buksan ang Mga Plugin. Pagkatapos, piliin ang Magdagdag at ang Mag-import ng marketplace.

2. Sa Pinagmulan, ilagay ang URL ng repository, gaya ng https://github.com/example/team-plugins. Gamitin lang ang URL ng repository, hindi ang URL ng branch o folder.

3. Kung nasa isang subdirectory ang marketplace, ilagay ang directory na iyon sa Path. Halimbawa, ilagay ang team-tools para sa team-tools/.agents/plugins/marketplace.json. Iwang blangko ang Path para sa root ng repository. Huwag ilagay ang filename ng manifest.

4. Maaari ka ring maglagay ng Branch, tag, o commit. Iwan itong blangko para gamitin ang default na branch ng repository. Gumamit ng branch para matanggap ang mga susunod na commit. Kung isang partikular na commit ang pipiliin, mananatili ito sa rebisyong iyon.

5. Piliin ang Mag-import ng marketplace at pahintulutan ang access sa GitHub kapag hiniling.

6. Suriin ang Mga resulta ng pag-import, pagkatapos ay buksan ang bawat na-import na plugin para i-configure ang patakaran sa pag-install nito at anumang kinakailangang app.

Maaaring abutin ng hanggang 1 oras ang paunang pag-import para sa napakalalaking marketplace. Karaniwang ilang minuto lang ang mga kasunod na araw-araw na pag-sync.

Kung hindi ma-import ang isang plugin, ipapaliwanag sa ulat ang error. Maaari pa ring ma-import ang iba pang valid na plugin.

Mga sinusuportahang format

Dapat may sinusuportahang manifest ang napiling directory:

• .agents/plugins/marketplace.json para sa isang marketplace ng Codex.

• .claude-plugin/marketplace.json para sa isang marketplace na compatible sa Claude.

• .claude-plugin/plugin.json para sa isang standalone na plugin ng Claude kapag walang manifest ng marketplace.

Maaaring tumukoy ang mga entry sa marketplace sa mga folder ng plugin sa parehong repository o sa mga sinusuportahang repository sa GitHub bilang pinagmulan. Hindi sinusuportahan ng pag-import sa workspace ang iba pang Git host at mga pinagmulan sa package registry, gaya ng npm.

Para sa mga sinusuportahang format, mga halimbawa ng JSON, at mga field ng pinagmulan, tingnan ang: Pamamahala ng mga Plugin.

I-configure ang access sa workspace

GitHub ang nagbibigay ng nilalaman ng plugin, habang ang mga setting ng workspace ang kumokontrol sa pag-install at authentication. Hindi inilalapat ng pag-import at pag-sync ang mga value ng patakaran sa repository, gaya ng AVAILABLE o ON_USE. I-configure ang mga setting na ito para sa bawat plugin sa iyong workspace.


Gamitin ang Patakaran sa pag-install para piliin ang Available o Naka-install para sa bawat kwalipikadong tungkulin. Dapat ding naka-enable ang mga kinakailangang app, at dapat may access ang mga miyembro sa konektadong serbisyo at makumpleto nila ang anumang kinakailangang authentication.


Napapanatili ang mga patakaran sa workspace ng plugin kapag nag-sync ng update nito o inilipat sa GitHub ang pamamahala sa isang kasalukuyang plugin. Hindi nagbibigay ng access sa app o nagkokonekta sa mga account ng mga miyembro ang pag-import ng plugin.


Para sa pag-navigate sa workspace, access sa app, at mga kontrol sa workspace, tingnan ang: Mga kontrol ng admin, seguridad, at pagsunod para sa mga plugin at app.

Panatilihing napapanahon ang mga plugin

Araw-araw na tumitingin ng mga update ang mga bagong marketplace. Para humiling ng update nang hindi naghihintay sa awtomatikong pag-sync:

1. Pumunta sa Console ng Admin, piliin ang nais na workspace sa ChatGPT, at buksan ang Mga Plugin.

2. Buksan ang Mga Marketplace at piliin ang marketplace.

3. Piliin ang I-sync ngayon.

Maaaring magdagdag ng mga bagong entry sa marketplace at mag-update ng mga kasalukuyang plugin ang pag-sync. Suriin ang mga pagbabago sa repository bago i-merge ang mga ito, dahil maaaring mag-import ng mga bagong plugin ang awtomatikong pag-sync nang hindi na kailangang mag-import muli nang hiwalay.

Suriin ang mga resulta ng pag-sync

Pagkatapos mag-sync, suriin ang status nito at ang naka-save na ulat. Ang Nakumpleto — N error ay nangangahulugang natapos ang pag-sync, pero may ilang plugin na hindi naproseso.


Kung hindi valid ang update sa isang kasalukuyang plugin, pananatilihin ang huling gumaganang bersyon nito. Maaari pa ring makumpleto ang iba pang valid na update. Ayusin ang iniulat na problema sa GitHub, pagkatapos ay piliin ang I-sync ngayon para subukang muli.


Kung may I-refresh sa iyong admin view para sa isang plugin na na-import nang paisa-isa, gamitin ito para i-refresh ang plugin na iyon. Nilo-load lang muli ng I-refresh ang listahan ng mga plugin ang ipinapakitang listahan; hindi ito nagsi-sync mula sa GitHub.

Unawain ang pag-alis at pagtanggal

Hindi natatanggal ang na-import na kopya sa workspace kapag inalis ang entry nito sa repository. Lalagyan ang plugin ng markang Wala na sa pinagmulan.


Kapag tinanggal ang marketplace sa ChatGPT, matatanggal ang lahat ng plugin na na-import mula rito. Huwag magtanggal ng marketplace para muling ikonekta ang GitHub o magpalit ng may-ari.

Muling ikonekta o baguhin ang access sa GitHub

Ginagamit ng pag-sync ng marketplace ang koneksyon sa GitHub ng admin na nag-import nito. Kailangang patuloy na may access ang account na iyon sa repository ng marketplace at sa anumang repository na tinutukoy nito.

Muling ikonekta ang orihinal na account

1. Tiyaking may access pa rin sa lahat ng kinakailangang repository ang GitHub account na ginamit sa pag-import.

2. Hilingin sa admin na orihinal na nag-import ng marketplace na buksan ang GitHub plugin sa ChatGPT at muling ikonekta ang kanyang account.

Ilipat sa bagong admin

Maaaring i-import ng bagong admin ng workspace ang parehong marketplace gamit ang sarili niyang koneksyon sa GitHub:

1. Pumunta sa Console ng Admin, piliin ang nais na workspace sa ChatGPT, at buksan ang Mga Plugin. Pagkatapos, piliin ang Magdagdag > Mag-import ng marketplace.

2. Ilagay ang parehong mga value ng Pinagmulan, Path, at Branch, tag, o commit na ginamit para sa kasalukuyang marketplace.

3. Piliin ang Mag-import ng marketplace at pahintulutan ang access sa GitHub kapag hiniling.

Gagamitin ng mga susunod na pag-sync ang koneksyon sa GitHub ng bagong admin. Dapat may pahintulot ang account ng bagong admin na magbasa sa repository ng marketplace at sa bawat repository na tinutukoy nito.

Ilipat sa GitHub ang pamamahala ng isang kasalukuyang plugin

Maaari kang gumamit ng marketplace para pamahalaan ang isang kasalukuyang plugin sa workspace na na-upload bilang archive o hindi pa pinamamahalaan mula sa GitHub. Dapat nasa parehong workspace ang kasalukuyang plugin at pareho ang pangalan nito. Hindi maaaring kunin sa ganitong paraan ang pamamahala sa isang plugin na pinamamahalaan mula sa ibang pinagmulan sa GitHub.


Para tukuyin ang kasalukuyang plugin sa iyong marketplace:

1. Pumunta sa Console ng Admin, piliin ang nais na workspace sa ChatGPT, at buksan ang Mga Plugin. Buksan ang plugin.

2. Kopyahin ang ID ng plugin na kasunod ng /admin/plugins/ sa URL nito.

3. Idagdag ang ID na iyon bilang pluginId sa tabi ng name at source sa katugmang entry sa array na plugins ng marketplace. Huwag itong idagdag sa file na plugin.json ng plugin.

Mapapanatili ng plugin ang ID, mga setting ng pagbabahagi, at mga patakaran sa workspace nito. GitHub na ang magiging pinagmulan ng mga susunod na update, kaya hindi na mapapalitan ang plugin ng mga archive na ia-upload sa hinaharap.


Para sa isang halimbawa ng paglilipat at mga kinakailangan, tingnan ang: Pamamahala ng mga Plugin.

Tumukoy sa isang kasalukuyang app

Maaaring tumukoy ang isang plugin sa isang kasalukuyang app sa .app.json sa root ng plugin. Isama ang tuldok sa simula ng filename, at gamitin ang ID ng app sa halip na ID ng plugin. Para sa isang native na plugin, itakda ang field na apps sa .codex-plugin/plugin.json sa ./.app.json.


Hindi lumilikha ng app o nagbibigay ng karagdagang mga pahintulot ang pagtukoy na ito. Nalalapat pa rin ang kasalukuyang access sa workspace, authentication, mga kontrol sa pagkilos, at mga pahintulot sa konektadong serbisyo ng app.


Para sa JSON format, tingnan ang: Pamamahala ng mga Plugin.

Unawain ang label na Sa desktop lang

Hindi maaaring gumana sa ChatGPT sa web ang isang plugin na may markang Sa desktop lang. Maaaring magkaroon ng ganitong label ang mga na-import na plugin kapag may idineklara silang mga MCP server, halimbawa sa mcp.json o .mcp.json, kahit gumagamit ang isang server ng remote na HTTPS URL.


Hindi sapat ang pagdaragdag ng reference sa .app.json para maalis ang label na Sa desktop lang. Dapat pa ring available sa tungkulin ng miyembro ang anumang tinutukoy na app, at nalalapat ang karaniwang mga kinakailangan nito sa access at authentication.