Преглед
Користете го ова упатство ако сте администратор на работен простор во ChatGPT и го поставувате шаблонот за апликацијата GitHub Enterprise за вашата организација. Шаблонот не е конечната апликација што ја користат членовите. Тој е постапка за поставување што создава нацрт-апликација за конкретен работен простор откако ќе ја внесете потребната конфигурација за GitHub Enterprise.
Кај GitHub Enterprise, поставувањето го поврзува ChatGPT со хостот на GitHub Enterprise на вашата организација. Создавате GitHub App, ја регистрирате URL-адресата за повратен повик на ChatGPT, генерирате акредитиви, а потоа ги залепувате тие вредности во постапката за поставување на шаблонот во ChatGPT. Откако ChatGPT ќе ја создаде нацрт-апликацијата, може да ја објавите и да управувате со неа како со другите апликации во работниот простор.
За навигација низ работниот простор и пристап до апликациите, видете: Администраторски контроли, безбедност и усогласеност за приклучоци и апликации.
Што поставувате
Создавате апликација GitHub Enterprise во ChatGPT за конкретен работен простор. Апликацијата користи:
GitHub App регистрирана на вашиот хост на GitHub Enterprise.
ID и тајна на клиентот за GitHub App за корисничка авторизација преку OAuth.
Приватниот клуч за GitHub App, за ChatGPT да може да издава инсталациски токени за операции со репозиториуми.
Тајна и URL-адреса за webhook, за GitHub Enterprise да може да испраќа настани за инсталации и репозиториуми назад до ChatGPT.
Името на вашиот хост на GitHub Enterprise, на пример
github.example.com.
Создајте GitHub App, а не самостојна GitHub OAuth App. За поставување на шаблонот во ChatGPT се потребни акредитиви за GitHub App, приватен клуч и поставки за webhook.
Пред да започнете
Ви требаат:
Пристап како администратор или сопственик на работен простор во ChatGPT.
Пристап како администратор на GitHub Enterprise или сопственик на организација, со можност за создавање и инсталирање апликации GitHub App.
Само името на хостот на GitHub Enterprise, без
https://или патека.Одлука за тоа кои дејства со репозиториуми треба да ги поддржува ChatGPT, како што се пребарување репозиториуми само за читање, работни текови за pull request, работни текови за пријавени проблеми, уредување датотеки, GitHub Actions или пошироки работни текови со Codex.
Безбедно место за ракување со приватниот клуч и тајната на клиентот за GitHub App.
Оставете ги ChatGPT и GitHub Enterprise отворени во посебни картички. Не измислувајте URL-адреса за повратен повик. Копирајте ја точната URL-адреса за повратен повик прикажана во ChatGPT.
Вредности што треба да ги подготвите
Име на хостот на GitHub Enterprise: на пример,
github.example.com.URL-адреса за повратен повик: копирајте ја од постапката за поставување на шаблонот во ChatGPT.
ID на клиентот за GitHub App.
Тајна на клиентот за GitHub App.
Приватен клуч за GitHub App во формат PEM.
Тајна за webhook генерирана од ChatGPT.
URL-адреса за webhook генерирана по создавањето на нацрт-апликацијата во ChatGPT.
Започнете со поставување на шаблонот во ChatGPT
Во ChatGPT, префрлете се во работниот простор во кој треба да биде достапна апликацијата.
Отворете Поставки за работниот простор > Апликации. Може и да отидете во Администраторската конзола, да го изберете соодветниот работен простор во ChatGPT и да отворите Приклучоци. Изберете Управување со стари апликации за да ја отворите задржаната страница Апликации.
Изберете Каталог.
Пребарајте GitHub Enterprise.
Изберете го шаблонот за апликацијата GitHub Enterprise и започнете со поставувањето.
Внесете јасно име и опис на апликацијата, на пример GitHub Enterprise или GitHub Enterprise - Инженерство.
Внесете го името на хостот на GitHub Enterprise, на пример
github.example.com.Копирајте ја URL-адресата за повратен повик прикажана во ChatGPT. Оставете ја оваа картичка отворена.
Копирајте ја генерираната тајна за webhook ако се прикаже при поставувањето.
Пример за URL-адреса за повратен повик: https://chatgpt.com/connector/oauth/<callback_id>
Не отстранувајте го ID-то на повратниот повик, не додавајте коса црта на крајот и не заменувајте ја адресата со општа URL-адреса на ChatGPT.
Создајте ја GitHub App во GitHub Enterprise
Отворете го вашиот хост на GitHub Enterprise, на пример
https://github.example.com.Одете во организацијата или сметката што треба да биде сопственик на апликацијата.
Отворете Поставки > Поставки за програмери > Апликации GitHub App.
Изберете Нова GitHub App.
Внесете јасно име на апликацијата, на пример Конектор за ChatGPT и GitHub Enterprise.
Внесете URL-адреса на почетната страница. Ако нема посебна внатрешна страница, користете ја URL-адресата на организацијата во GitHub Enterprise.
Во полето URL-адреса за повратен повик, залепете ја точната URL-адреса за повратен повик копирана од ChatGPT.
Оставете ја опцијата Истекување на токените за корисничка авторизација вклучена, освен ако вашиот тим за безбедност има конкретна причина да ја промени.
Вклучете ја опцијата Барај корисничка авторизација при инсталација, за корисниците да можат да ѝ одобрат пристап на апликацијата при инсталирањето или поврзувањето.
Во делот „Каде може да се инсталира оваа GitHub App?“, изберете ја најограничената опција што одговара на планираниот опсег на употреба.
Создајте ја GitHub App.
Конфигурирајте ги дозволите и настаните
Изберете ги минималните дозволи потребни за дејствата во ChatGPT што планирате да ги овозможите.
За пронаоѓање репозиториуми и прашања и одговори со пристап само за читање, започнете со дозволи за читање како што се:
Метаподатоци: само за читање. GitHub бара пристап до метаподатоци за апликациите GitHub App.
Содржина: само за читање, за пристап до содржината на датотеките и репозиториумите.
Проблеми: само за читање, ако е потребно пребарување или читање на пријавени проблеми.
Pull requests: само за читање, ако е потребно пребарување на pull request или контекст за преглед.
Дејства: само за читање, ако се потребни статусот на извршување на работните текови, задачите, дневниците или артефактите.
За работни текови што запишуваат податоци, додајте дозволи за запишување само каде што е потребно, на пример за Содржина, Pull requests, Проблеми, Дејства или Работни текови. Користете ги најограничените дозволи што ги поддржуваат предвидените дејства во ChatGPT.
Настаните за webhook треба да одговараат на работните текови што ги поддржувате. Вообичаени настани се Инсталација, Репозиториуми на инсталацијата, Испраќање промени, Pull request, Проблеми, Коментар на проблем, Извршување на работен тек и Задача во работен тек.
Генерирајте ги и копирајте ги акредитивите за GitHub App
Во поставките за GitHub App, копирајте го ID-то на клиентот.
Генерирајте Тајна на клиентот и веднаш копирајте ја.
Во делот Приватни клучеви, генерирајте приватен клуч.
Преземете ја датотеката .pem и зачувајте ја на безбедно место.
Отворете ја датотеката .pem локално и копирајте го целиот текст во формат PEM, вклучувајќи ги почетниот и завршниот ред.
Приватниот клуч е доверлив. Постапувајте со него како со акредитив. Ако биде откриен, генерирајте нов приватен клуч, ажурирајте ги поставките на апликацијата во ChatGPT и избришете го компромитираниот клуч во GitHub Enterprise.
Завршете го поставувањето во ChatGPT
Вратете се во картичката за поставување на шаблонот во ChatGPT.
Залепете го ID-то на клиентот за GitHub App во ID на клиентот за OAuth.
Залепете ја тајната на клиентот за GitHub App во Тајна на клиентот за OAuth.
Оставете го полето Опсези непроменето, освен ако вашата организација има конкретна потреба да ги замени стандардните вредности од шаблонот.
Проверете дали е внесено само името на хостот на GitHub Enterprise, на пример
github.example.com.Залепете го или прикачете го приватниот клуч за GitHub App во формат PEM во полето Приватен клуч за GitHub App.
Проверете дали е внесена генерираната тајна за webhook.
Создајте ја нацрт-апликацијата.
Отворете ги деталите за создадената нацрт-апликација во ChatGPT и копирајте ја генерираната URL-адреса за webhook.
URL-адресата за webhook треба да изгледа вака: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Завршете го поставувањето на webhook во GitHub Enterprise
Вратете се во поставките за GitHub App во GitHub Enterprise.
Отворете ги Општите поставки за GitHub App.
Вклучете ја опцијата Активни webhooks ако веќе не е вклучена.
Залепете ја URL-адресата за webhook од ChatGPT во полето URL-адреса за webhook.
Залепете ја тајната за webhook од ChatGPT во полето Тајна за webhook.
Оставете ја проверката на SSL вклучена.
Проверете дали настаните за webhook на кои сте претплатени одговараат на дозволите и дејствата што ги овозможивте.
Зачувајте ги промените.
Објавете ја апликацијата и управувајте со неа во ChatGPT
Создавањето на нацрт-апликацијата не ја прави автоматски достапна за членовите. Откако ќе го прегледате нацртот:
Објавете ја нацрт-апликацијата.
Во Поставки за работниот простор, отворете ја страницата Апликации, отворете Овозможени и проверете дали се прикажува апликацијата. Страницата Апликации може да ја отворите и преку Управување со стари апликации во Администраторска конзола > Приклучоци.
Конфигурирајте го Корисничкиот пристап за улогите што треба да ја користат.
Прегледајте ја Контролата на дејства за дејствата за читање и запишување.
Прегледајте ги Дозволите за апликацијата за да изберете кога ChatGPT ќе бара одобрение од членовите пред да ја користи апликацијата.
Побарајте од тест-корисник со дозволен пристап да отвори Апликации во ChatGPT и да потврди дека апликацијата се прикажува.
Овие дозволи за апликацијата важат за разговорите во ChatGPT. Агентите во работниот простор користат контроли за секој агент поединечно, поставени од неговиот создавач. Тие одредуваат кои дејства на апликациите се достапни и кога од крајните корисници се бара да ги одобрат. За однесувањето на агентите, видете: Агенти во работниот простор на ChatGPT за Enterprise и Business.
Инсталирајте ја и тестирајте ја GitHub App
Во GitHub Enterprise, инсталирајте ја апликацијата GitHub на организацијата или сметката.
Изберете ги сите репозиториуми или само одредени репозиториуми, според правилата на работниот простор.
Започнете ја постапката за поврзување од ChatGPT како корисник со дозволен пристап.
Одобрете ѝ пристап на апликацијата GitHub кога ќе се побара тоа.
Прво извршете едноставно дејство за читање, како што е прикажување список на достапни репозиториуми или преземање познат pull request.
Ако се овозможени дејства за запишување, тестирајте ги на репозиториум со низок ризик пред да ја проширите употребата.
Име на хостот и функционирање на OAuth
ChatGPT го користи името на хостот за да ги одреди крајните точки на GitHub Enterprise. Внесете го само името на хостот, на пример github.example.com или octocorp.ghe.com.
Не внесувајте патека до API, патека до репозиториум или github.com, освен ако токму тоа е хостот на GitHub Enterprise за оваа апликација.
Решавање проблеми
Несовпаѓање на URI-адресата за пренасочување: проверете дали URL-адресата за повратен повик на GitHub App целосно се совпаѓа со онаа прикажана во ChatGPT.
ChatGPT не може да ја создаде или зачува нацрт-апликацијата: проверете дали се пополнети сите задолжителни полиња, вклучувајќи ги името на хостот, ID на клиентот за OAuth, Тајна на клиентот за OAuth, приватниот клуч и тајната за webhook.
Автентикацијата е успешна, но повиците до репозиториумот се неуспешни: проверете дали GitHub App е инсталирана и има пристап до репозиториумот.
API враќа 403 или известување за недоволни дозволи: додајте ја дозволата што недостасува за GitHub App и побарајте од сопственикот на инсталацијата да ги одобри ажурираните дозволи ако се побара тоа.
Не се прикажуваат репозиториуми: проверете дали инсталацијата на апликацијата ги опфаќа очекуваните репозиториуми и дали корисникот што ја одобрува во ChatGPT има пристап до нив.
Испораките преку webhook се неуспешни: проверете дали URL-адресата и тајната за webhook се совпаѓаат со вредностите од ChatGPT, оставете ја проверката на SSL вклучена и уверете се дека хостот на GitHub Enterprise може да пристапи до
connectors.api.openai.org.Грешки со приватниот клуч: проверете дали е копирана целата содржина на PEM, вклучувајќи ги почетниот и завршниот ред.