Преглед

Администраторите на работниот простор можат да увезат пазар за приклучоци од GitHub во каталогот на својот работен простор. Пазарот е JSON-каталог со список на приклучоците за увоз. По увозот, дневната синхронизација ги ажурира приклучоците со промените од репозиториумот.


Синхронизацијата на пазарот ја увезува содржината на приклучоците — не ги поврзува сметките на членовите на работниот простор и не дава пристап до апликациите вклучени во приклучокот.


За вовед во приклучоците и апликациите вклучени во нив, видете: Приклучоци во ChatGPT и Codex.

Пред да започнете

• Користете сметка на GitHub со пристап за читање до репозиториумот на пазарот и до секој друг репозиториум на кој тој упатува. Поддржани се јавни и приватни репозиториуми на github.com.

• Обезбедете ги сите потребни одобренија од организацијата на GitHub за сметката што го врши увозот да има пристап до тие репозиториуми.

• Прегледајте ја содржината на репозиториумот. При увозот се обработуваат сите валидни приклучоци без посебен чекор за одобрување на секој од нив, а идните синхронизации може да додаваат нови приклучоци.

Новите приклучоци првично ја имаат поставката за инсталација Достапен и бараат автентикација при инсталацијата. Кај новите пазари е овозможена автоматска дневна синхронизација. По увозот, прегледајте ги поставките во работниот простор и потребните апликации за секој приклучок.

Увоз на пазар

1. Одете во Администраторската конзола, изберете го саканиот работен простор во ChatGPT и отворете Приклучоци. Потоа изберете Додај, па Увези пазар.

2. Во Извор, внесете ја URL-адресата на репозиториумот, на пример https://github.com/example/team-plugins. Користете ја само URL-адресата на репозиториумот, а не адреса на гранка или папка.

3. Ако пазарот е во поддиректориум, внесете го тој директориум во Патека. На пример, внесете team-tools за team-tools/.agents/plugins/marketplace.json. Оставете го полето Патека празно за основниот директориум на репозиториумот. Не внесувајте го името на датотеката на манифестот.

4. По избор, внесете Гранка, ознака или комит. Оставете го полето празно за да ја користите стандардната гранка на репозиториумот. Користете гранка за да ги добивате идните комити. Ако наведете фиксен комит, верзијата останува непроменета.

5. Изберете Увези пазар и одобрете пристап до GitHub кога ќе биде побарано.

6. Прегледајте ги Резултатите од увозот, а потоа отворете го секој увезен приклучок за да ги конфигурирате неговата политика за инсталација и потребните апликации.

Почетниот увоз може да трае до 1 час за многу големи пазари. Последователните дневни синхронизации обично траат неколку минути.

Ако некој приклучок не може да се увезе, извештајот ја објаснува грешката. Останатите валидни приклучоци сепак може да се увезат.

Поддржани формати

Избраниот директориум мора да содржи поддржан манифест:

• .agents/plugins/marketplace.json за пазар на Codex.

• .claude-plugin/marketplace.json за пазар компатибилен со Claude.

• .claude-plugin/plugin.json за самостоен приклучок за Claude кога нема манифест на пазар.

Записите во пазарот може да упатуваат на папки со приклучоци во истиот репозиториум или на поддржани извори од репозиториуми на GitHub. Увозот во работниот простор не поддржува други платформи за хостирање Git или извори од регистри на пакети, како npm.

За поддржаните формати, примери во JSON и полињата за извори, видете: Управување со приклучоци.

Конфигурирање на пристапот во работниот простор

GitHub ја обезбедува содржината на приклучокот, додека поставките на работниот простор ги контролираат инсталацијата и автентикацијата. При увозот и синхронизацијата не се применуваат вредностите на политиките од репозиториумот, како AVAILABLE или ON_USE. Конфигурирајте ги овие поставки за секој приклучок во вашиот работен простор.


Користете ја Политиката за инсталација за да изберете Достапен или Инсталиран за секоја улога што ги исполнува условите. Потребните апликации исто така мора да бидат овозможени, а членовите мора да имаат пристап до поврзаната услуга и да ја завршат потребната автентикација.


При синхронизација на ажурирање на приклучок или префрлање на постоечки приклучок под управување преку GitHub, неговите политики во работниот простор се зачувуваат. Увозот на приклучок не дава пристап до апликации и не ги поврзува сметките на членовите.


За навигацијата во работниот простор, пристапот до апликации и контролите на работниот простор, видете: Администраторски контроли, безбедност и усогласеност за приклучоци и апликации.

Одржување на приклучоците ажурирани

Новите пазари секојдневно проверуваат дали има ажурирања. За да побарате ажурирање без да чекате автоматска синхронизација:

1. Одете во Администраторската конзола, изберете го саканиот работен простор во ChatGPT и отворете Приклучоци.

2. Отворете Пазари и изберете го пазарот.

3. Изберете Синхронизирај сега.

Синхронизацијата може да додаде нови записи од пазарот и да ги ажурира постоечките приклучоци. Прегледајте ги промените во репозиториумот пред да ги споите, бидејќи автоматската синхронизација може да увезе нови приклучоци без дополнителен чекор за увоз.

Преглед на резултатите од синхронизацијата

По синхронизацијата, прегледајте ги нејзиниот статус и зачуваниот извештај. Завршено — N грешки значи дека синхронизацијата завршила, но некои приклучоци не можеле да се обработат.


Ако ажурирањето на постоечки приклучок е невалидно, се задржува неговата последна исправна верзија. Останатите валидни ажурирања сепак може да се завршат. Поправете го пријавениот проблем во GitHub, па изберете Синхронизирај сега за да се обидете повторно.


Ако во администраторскиот приказ се прикажува Освежи за поединечно увезен приклучок, користете ја таа опција за да го освежите приклучокот. Освежи го списокот со приклучоци само повторно го вчитува прикажаниот список; не врши синхронизација од GitHub.

Што значат отстранувањето и бришењето

Со отстранување на запис од репозиториумот не се брише неговата увезена копија во работниот простор. Приклучокот се означува со Повеќе не е во изворот.


Со бришење на пазарот во ChatGPT се бришат сите приклучоци увезени од него. Не бришете пазар за повторно да го поврзете GitHub или да ја промените сопственоста.

Повторно поврзување или менување на пристапот до GitHub

За синхронизација на пазарот се користи врската со GitHub на администраторот што го увезол. Таа сметка мора и понатаму да има пристап до репозиториумот на пазарот и до сите репозиториуми на кои тој упатува.

Повторно поврзување на првичната сметка

1. Проверете дали сметката на GitHub користена за увозот сѐ уште има пристап до сите потребни репозиториуми.

2. Побарајте од администраторот што првично го увезол пазарот да го отвори приклучокот за GitHub во ChatGPT и повторно да ја поврзе својата сметка.

Пренос на нов администратор

Новиот администратор на работниот простор може да го увезе истиот пазар преку сопствената врска со GitHub:

1. Одете во Администраторската конзола, изберете го саканиот работен простор во ChatGPT и отворете Приклучоци. Потоа изберете Додај > Увези пазар.

2. Внесете ги истите вредности за Извор, Патека и Гранка, ознака или комит што се користат за постоечкиот пазар.

3. Изберете Увези пазар и одобрете пристап до GitHub кога ќе биде побарано.

Идните синхронизации ја користат врската со GitHub на новиот администратор. Сметката на новиот администратор мора да има пристап за читање до репозиториумот на пазарот и до секој репозиториум на кој тој упатува.

Префрлање на постоечки приклучок под управување преку GitHub

Можете да користите пазар за да управувате со постоечки приклучок во работниот простор што е поставен како архива или сѐ уште не се управува преку извор од GitHub. Постоечкиот приклучок мора да биде во истиот работен простор и да го има истото име. На овој начин не може да се преземе управувањето со приклучок што се управува преку друг извор од GitHub.


За да го наведете постоечкиот приклучок во вашиот пазар:

1. Одете во Администраторската конзола, изберете го саканиот работен простор во ChatGPT и отворете Приклучоци. Отворете го приклучокот.

2. Копирајте го ID на приклучокот што се наоѓа по /admin/plugins/ во неговата URL-адреса.

3. Додајте го тоа ID како pluginId покрај name и source во соодветниот запис во низата plugins на пазарот. Не додавајте го во датотеката plugin.json на приклучокот.

Приклучокот ги задржува своето ID, поставките за споделување и политиките во работниот простор. GitHub станува извор за идните ажурирања, па подоцнежното поставување архиви не може да го замени приклучокот.


За пример за миграција и потребните услови, видете: Управување со приклучоци.

Упатување на постоечка апликација

Приклучокот може да упатува на постоечка апликација преку .app.json во основниот директориум на приклучокот. Вклучете ја почетната точка во името на датотеката и користете го ID на апликацијата, а не ID на приклучок. За нативен приклучок, поставете го полето apps во .codex-plugin/plugin.json на ./.app.json.


Упатувањето не создава апликација и не доделува дополнителни дозволи. Постоечките поставки за пристап до апликацијата во работниот простор, автентикација, контроли за дејства и дозволи за поврзаната услуга и понатаму важат.


За форматот JSON, видете: Управување со приклучоци.

Што значи ознаката „Само за десктоп“

Приклучок со ознаката Само за десктоп не може да работи во веб-верзијата на ChatGPT. Увезените приклучоци може да ја добијат оваа ознака кога декларираат MCP-сервери, на пример во mcp.json или .mcp.json, дури и кога серверот користи оддалечена HTTPS URL-адреса.


Додавањето упатување во .app.json само по себе не ја отстранува ознаката Само за десктоп. Секоја апликација на која се упатува и понатаму мора да биде достапна за улогата на членот, а нејзините вообичаени барања за пристап и автентикација остануваат во сила.