Общ преглед
Използвайте това ръководство, ако сте администратор на работно пространство в ChatGPT и настройвате шаблона за приложението GitHub Enterprise за вашата организация. Шаблонът не е завършеното приложение, което членовете използват. Той представлява процес на настройване, който създава чернова на приложение за конкретното работно пространство, след като предоставите необходимата конфигурация на GitHub Enterprise.
При GitHub Enterprise настройването свързва ChatGPT с хоста на GitHub Enterprise на вашата организация. Създавате GitHub App, регистрирате URL адреса за обратно извикване от ChatGPT, генерирате идентификационни данни и след това поставяте тези стойности в процеса на настройване на шаблона в ChatGPT. След като ChatGPT създаде черновата на приложението, можете да я публикувате и да управлявате приложението като останалите приложения в работното пространство.
За навигацията в работното пространство и достъпа до приложения вижте: Администраторски контроли, сигурност и съответствие за приставки и приложения.
Какво настройвате
Създавате приложение GitHub Enterprise в ChatGPT за конкретно работно пространство. Приложението използва:
GitHub App, регистрирано на вашия хост на GitHub Enterprise.
Клиентския идентификатор и тайния ключ на клиента на GitHub App за упълномощаване на потребители чрез OAuth.
Частния ключ на GitHub App, за да може ChatGPT да издава токени за инсталацията за операции с хранилища.
Таен ключ и URL адрес за уебхук, за да може GitHub Enterprise да изпраща обратно към ChatGPT събития, свързани с инсталацията и хранилищата.
Името на вашия хост на GitHub Enterprise, например
github.example.com.
Създайте GitHub App, а не самостоятелно GitHub OAuth App. Настройването на шаблона в ChatGPT изисква идентификационни данни за GitHub App, частен ключ и настройки за уебхук.
Преди да започнете
Необходими са ви:
Достъп като администратор или собственик на работното пространство в ChatGPT.
Достъп като администратор на GitHub Enterprise или собственик на организация с права за създаване и инсталиране на GitHub Apps.
Само името на хоста на GitHub Enterprise, без
https://или път.Решение кои действия с хранилища трябва да поддържа ChatGPT, например търсене в хранилища само с достъп за четене, работни процеси с pull request, работни процеси за докладвани проблеми, редактиране на файлове, GitHub Actions или по-широки работни процеси с Codex.
Сигурно място за работа с частния ключ и тайния ключ на клиента на GitHub App.
Дръжте ChatGPT и GitHub Enterprise отворени в отделни раздели. Не измисляйте URL адреса за обратно извикване. Копирайте точния URL адрес за обратно извикване, показан в ChatGPT.
Стойности, които да подготвите
Име на хоста на GitHub Enterprise: например
github.example.com.URL адрес за обратно извикване: копирайте го от процеса на настройване на шаблона в ChatGPT.
Клиентски идентификатор на GitHub App.
Таен ключ на клиента на GitHub App.
Частен ключ на GitHub App във формат PEM.
Таен ключ за уебхук, генериран от ChatGPT.
URL адрес на уебхук, генериран след създаването на черновата на приложението в ChatGPT.
Започнете настройването на шаблона в ChatGPT
В ChatGPT превключете към работното пространство, в което приложението трябва да е достъпно.
Отворете Настройки на работното пространство > Приложения. Можете също да отидете в Администраторската конзола, да изберете съответното работно пространство в ChatGPT и да отворите Приставки. Изберете Управление на наследени приложения, за да отворите запазената страница Приложения.
Изберете Каталог.
Потърсете GitHub Enterprise.
Изберете шаблона за приложението GitHub Enterprise и започнете настройването.
Въведете ясно име и описание на приложението, например GitHub Enterprise или GitHub Enterprise – Разработка.
Въведете името на хоста на GitHub Enterprise, например
github.example.com.Копирайте URL адреса за обратно извикване, показан в ChatGPT. Оставете този раздел отворен.
Копирайте генерирания таен ключ за уебхука, ако се показва по време на настройването.
Примерен URL адрес за обратно извикване: https://chatgpt.com/connector/oauth/<callback_id>
Не премахвайте идентификатора за обратно извикване, не добавяйте наклонена черта в края и не заменяйте адреса с общ URL адрес на ChatGPT.
Създайте GitHub App в GitHub Enterprise
Отворете вашия хост на GitHub Enterprise, например
https://github.example.com.Отидете в организацията или акаунта, които трябва да притежават приложението.
Отворете Настройки > Настройки за разработчици > GitHub Apps.
Изберете Ново GitHub App.
Въведете ясно име на приложението, например Конектор на ChatGPT за GitHub Enterprise.
Въведете URL адрес на началната страница. Ако няма специална вътрешна страница, използвайте URL адреса на организацията в GitHub Enterprise.
В „URL адрес за обратно извикване“ поставете точния URL адрес за обратно извикване, копиран от ChatGPT.
Оставете „Изтичане на токените за упълномощаване на потребители“ включено, освен ако екипът ви по сигурността няма конкретна причина да промени настройката.
Включете „Искане на упълномощаване от потребителя при инсталиране“, за да могат потребителите да упълномощават приложението при инсталиране или свързване.
В „Къде може да се инсталира това GitHub App?“ изберете най-ограничената опция, която отговаря на планираното внедряване.
Създайте GitHub App.
Настройте разрешенията и събитията
Изберете минималните разрешения, необходими за действията в ChatGPT, които планирате да активирате.
За откриване на хранилища и въпроси и отговори с достъп само за четене започнете с разрешения за четене като:
Метаданни: само за четене. GitHub изисква достъп до метаданни за GitHub Apps.
Съдържание: само за четене, за достъп до съдържанието на файлове и хранилища.
Проблеми: само за четене, ако е необходимо търсене или четене на докладвани проблеми.
Pull requests: само за четене, ако е необходимо търсене на pull request или контекст за преглед.
Действия: само за четене, ако са необходими статусът на изпълнение на работни процеси, задачи, журнали или артефакти.
За работни процеси със запис добавяйте разрешения за запис само където е необходимо, например за Съдържание, Pull requests, Проблеми, Действия или Работни процеси. Използвайте възможно най-ограничените разрешения, които позволяват предвидените действия в ChatGPT.
Събитията за уебхука трябва да съответстват на работните процеси, които поддържате. Често използвани събития са Инсталация, Хранилища на инсталацията, Изпращане на промени, Pull request, Проблеми, Коментар към проблем, Изпълнение на работен процес и Задача от работен процес.
Генерирайте и копирайте идентификационните данни за GitHub App
В настройките на GitHub App копирайте Идентификатор на клиента.
Генерирайте Таен ключ на клиента и го копирайте веднага.
В Частни ключове генерирайте частен ключ.
Изтеглете .pem файла и го съхранявайте на сигурно място.
Отворете .pem файла локално и копирайте целия PEM текст, включително началния и крайния ред.
Частният ключ е поверителна информация. Защитавайте го като идентификационни данни. Ако бъде разкрит, генерирайте нов частен ключ, актуализирайте настройките на приложението в ChatGPT и изтрийте компрометирания ключ в GitHub Enterprise.
Завършете настройването в ChatGPT
Върнете се в раздела за настройване на шаблона в ChatGPT.
Поставете клиентския идентификатор на GitHub App в Идентификатор на OAuth клиента.
Поставете тайния ключ на клиента на GitHub App в Таен ключ на OAuth клиента.
Оставете Обхвати без промяна, освен ако организацията ви изрично не се нуждае от промяна на настройките по подразбиране на шаблона.
Проверете дали за GitHub Enterprise е въведено само името на хоста, например
github.example.com.Поставете или качете частния ключ на GitHub App във формат PEM в полето „Частен ключ на GitHub App“.
Проверете дали генерираният таен ключ за уебхука е попълнен.
Създайте черновата на приложението.
Отворете подробностите за създадената чернова на приложението в ChatGPT и копирайте генерирания URL адрес на уебхука.
URL адресът на уебхука трябва да изглежда така: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Завършете настройването на уебхука в GitHub Enterprise
Върнете се в настройките на GitHub App в GitHub Enterprise.
Отворете Общи настройки на GitHub App.
Включете „Активни уебхукове“, ако още не са включени.
Поставете URL адреса на уебхука от ChatGPT в „URL адрес на уебхук“.
Поставете тайния ключ за уебхука от ChatGPT в „Таен ключ за уебхук“.
Оставете SSL проверката включена.
Проверете дали събитията, за които е абониран уебхукът, съответстват на разрешенията и действията, които сте активирали.
Запазете промените.
Публикувайте и управлявайте приложението в 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 не може да създаде или запази черновата на приложението: проверете дали са попълнени всички задължителни полета, включително името на хоста, Идентификатор на OAuth клиента, Таен ключ на OAuth клиента, частният ключ и тайният ключ за уебхука.
Удостоверяването е успешно, но заявките към хранилището са неуспешни: проверете дали GitHub App е инсталирано и има достъп до хранилището.
API връща 403 или грешка за недостатъчни разрешения: добавете липсващото разрешение за GitHub App и помолете собственика на инсталацията да одобри актуализираните разрешения, ако бъде поискано.
Не се показват хранилища: проверете дали инсталацията на приложението включва очакваните хранилища и дали потребителят, който дава разрешение в ChatGPT, има достъп до тях.
Доставянето чрез уебхук е неуспешно: проверете дали URL адресът и тайният ключ на уебхука съвпадат със стойностите от ChatGPT, оставете SSL проверката включена и се уверете, че хостът на GitHub Enterprise има достъп до
connectors.api.openai.org.Грешки с частния ключ: проверете дали е копирано цялото PEM съдържание, включително началният и крайният ред.