Общ преглед
Използвайте това ръководство, ако сте администратор на работно пространство в ChatGPT и настройвате GitHub шаблона за приложение Enterprise за вашата организация. Шаблонът не е крайното приложение, което членовете използват. Това е поток за настройка, който създава чернова на приложение за конкретното работно пространство, след като предоставите необходимата конфигурация на GitHub Enterprise.
За GitHub Enterprise настройката свързва ChatGPT с хоста на GitHub Enterprise на вашата организация. Създавате GitHub App, регистрирате URL адреса за обратно извикване на ChatGPT, генерирате идентификационни данни и след това поставяте тези стойности в потока за настройка на шаблона в ChatGPT. След като ChatGPT създаде черновата на приложението, можете да я публикувате и управлявате като другите приложения в работното пространство.
Какво настройвате
Създавате приложение GitHub Enterprise в ChatGPT, специфично за работното пространство. Приложението използва:
GitHub App, регистрирано на вашия хост на GitHub Enterprise.
Client ID и client secret на GitHub App за OAuth упълномощаване на потребители.
Частния ключ на GitHub App, за да може ChatGPT да издава токени за инсталация за операции с хранилища.
Тайна за webhook и URL адрес за webhook, за да може GitHub Enterprise да изпраща събития за инсталации и хранилища обратно към ChatGPT.
Името на хоста на GitHub Enterprise, например
github.example.com.
Създайте GitHub App, а не самостоятелно GitHub OAuth App. Настройката на шаблона в ChatGPT изисква идентификационни данни за GitHub App, частен ключ и настройки за webhook.
Преди да започнете
Необходими са ви:
Администраторски или собственически достъп до работното пространство на ChatGPT.
Администраторски достъп до GitHub Enterprise или достъп на собственик на организация, който може да създава и инсталира GitHub Apps.
Само името на хоста на GitHub Enterprise, без
https://или път.Решение кои действия с хранилища трябва да поддържа ChatGPT, например търсене в хранилища само за четене, работни потоци за искания за предложения, работни потоци за проблеми, редакции на файлове, GitHub Actions или по-широки работни потоци на Codex.
Сигурно място за обработване на частния ключ и client secret на GitHub App.
Дръжте ChatGPT и GitHub Enterprise отворени в отделни раздели. Не измисляйте URL адреса за обратно извикване. Копирайте точния URL адрес за обратно извикване, показан в ChatGPT.
Стойности за подготовка
Име на хост на GitHub Enterprise: например
github.example.com.URL адрес за обратно извикване: копирайте го от потока за настройка на шаблона в ChatGPT.
Client ID на GitHub App.
Client secret на GitHub App.
Частен ключ PEM на GitHub App.
Тайна за webhook, генерирана от ChatGPT.
URL адрес за webhook, генериран след създаването на черновата на приложението в ChatGPT.
Започнете настройката на шаблона в ChatGPT
В ChatGPT превключете към работното пространство, където приложението трябва да е налично.
Отворете Настройки на работното пространство > Приложения.
Изберете Каталог.
Потърсете GitHub Enterprise.
Изберете шаблона за приложението GitHub Enterprise и започнете настройката.
Въведете ясно име и описание на приложението, например GitHub Enterprise или GitHub Enterprise - Engineering.
Въведете името на хоста на 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.Отидете в организацията или акаунта, който трябва да притежава приложението.
Отворете Settings > Developer settings > GitHub Apps.
Изберете New GitHub App.
Въведете ясно име на приложението, например ChatGPT GitHub Enterprise Connector.
Въведете URL адрес на начална страница. Ако няма специална вътрешна страница, използвайте URL адреса на организацията в GitHub Enterprise.
В Callback URL поставете точния URL адрес за обратно извикване, копиран от ChatGPT.
Оставете Expire user authorization tokens активирано, освен ако екипът ви по сигурността няма конкретна причина да го промени.
Активирайте Request user authorization during installation, за да могат потребителите да упълномощят приложението по време на инсталиране или свързване.
Под Where can this GitHub App be installed?, изберете най-тясната опция, която отговаря на внедряването ви.
Създайте GitHub App.
Конфигуриране на разрешения и събития
Изберете минималните разрешения, необходими за действията на ChatGPT, които планирате да активирате.
За откриване на хранилища и въпроси и отговори само за четене започнете с разрешения за четене, като например:
Метаданни: само за четене. GitHub изисква метаданни за GitHub Apps.
Съдържание: само за четене, за достъп до файлове и съдържание на хранилища.
Проблеми: само за четене, ако е необходимо търсене или четене на проблеми.
Искания за предложения: само за четене, ако е необходим контекст за търсене или преглед на искания за предложения.
Действия: само за четене, ако са необходими състояние на изпълнение на работен поток, задачи, регистрационни файлове или артефакти.
За работни потоци с писане добавете разрешения за писане само където е нужно, например Contents, Pull requests, Issues, Actions или Workflows. Използвайте най-тесните разрешения, които поддържат предвидените действия на ChatGPT.
Webhook събитията трябва да съответстват на работните потоци, които поддържате. Често срещаните събития включват Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run и Workflow job.
Генериране и копиране на идентификационните данни за GitHub App
В настройките на GitHub App копирайте Client ID.
Генерирайте Client secret и го копирайте веднага.
Под Private keys генерирайте частен ключ.
Изтеглете .pem файла и го съхранете сигурно.
Отворете .pem файла локално и копирайте пълния PEM текст, включително началния и крайния ред.
Частният ключ е чувствителен. Отнасяйте се към него като към идентификационни данни. Ако бъде изложен на риск, генерирайте нов частен ключ, актуализирайте настройката на приложението в ChatGPT и изтрийте компрометирания ключ в GitHub Enterprise.
Завършете настройката в ChatGPT
Върнете се в раздела за настройка на шаблона в ChatGPT.
Поставете Client ID на GitHub App в OAuth client ID.
Поставете Client secret на GitHub App в OAuth client secret.
Оставете Scopes без промяна, освен ако организацията ви умишлено не трябва да замени настройките по подразбиране на шаблона.
Потвърдете, че името на хоста на GitHub Enterprise съдържа само хоста, например
github.example.com.Поставете или качете частния ключ PEM на GitHub App в GitHub App private key.
Потвърдете, че генерираната тайна за webhook е налична.
Създайте черновата на приложението.
Отворете подробностите за създадената чернова на приложение в ChatGPT и копирайте генерирания URL адрес за webhook.
URL адресът за webhook трябва да изглежда така: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Завършете настройката на webhook в GitHub Enterprise
Върнете се в настройките на GitHub App в GitHub Enterprise.
Отворете общите настройки на GitHub App.
Активирайте Active webhooks, ако още не са активирани.
Поставете URL адреса за webhook от ChatGPT в Webhook URL.
Поставете тайната за webhook от ChatGPT в Webhook secret.
Оставете SSL проверката активирана.
Потвърдете, че абонираните webhook събития съответстват на разрешенията и действията, които сте активирали.
Запазете промените.
Публикуване и управление на приложението в ChatGPT
Създаването на чернова на приложение не я прави автоматично достъпна за членовете. След като прегледате черновата:
Публикувайте черновата на приложението.
Потвърдете, че приложението се показва в Настройки на работното пространство > Приложения > Активирани.
Конфигурирайте Потребителски достъп за ролите, които трябва да го използват.
Прегледайте Контрол на действията за действия за четене и писане.
Прегледайте Разрешения за приложението, за да изберете кога ChatGPT да пита членовете, преди да използва приложението.
Помолете разрешен тестов потребител да отвори Приложения в ChatGPT и да потвърди, че приложението се показва.
Тези разрешения за приложения се прилагат за разговорите в ChatGPT. Агентите в работното пространство използват контроли за всеки Агент, зададени от създателя на Агента, за да определят кои действия на приложения са налични и кога крайните потребители трябва да ги одобрят. За поведението на Агент вижте: Агенти в работното пространство ChatGPT за Enterprise и Business.
Инсталиране и тестване на GitHub App
В GitHub Enterprise инсталирайте приложението GitHub в организацията или акаунта.
Изберете всички хранилища или избрани хранилища според политиката на работното пространство.
Стартирайте потока за свързване от ChatGPT като разрешен потребител.
Упълномощете приложението GitHub, когато бъдете подканени.
Първо изпълнете малко действие за четене, например изброяване на достъпни хранилища или извличане на известно искане за предложения.
Ако действията за писане са активирани, тествайте с нискорисково хранилище преди по-широко внедряване.
Поведение на име на хост и OAuth
ChatGPT използва името на хоста, за да извежда крайните точки на GitHub Enterprise. Въведете само хоста, например github.example.com или octocorp.ghe.com.
Не въвеждайте API път, път към хранилище или github.com, освен ако това не е точният хост на GitHub Enterprise за това приложение.
Отстраняване на неизправности
Несъответствие на URI за пренасочване: потвърдете, че URL адресът за обратно извикване на GitHub App точно съвпада с URL адреса за обратно извикване, показан в ChatGPT.
ChatGPT не може да създаде или запази черновата на приложението: потвърдете, че всички задължителни полета са налични, включително име на хост, OAuth client ID, OAuth client secret, частен ключ и тайна за webhook.
Удостоверяването е успешно, но извикванията към хранилището са неуспешни: потвърдете, че GitHub App е инсталирано и има достъп до хранилището.
API връща 403 или недостатъчни разрешения: добавете липсващото разрешение за GitHub App и поискайте собственикът на инсталацията да одобри актуализираните разрешения, ако бъде подканен.
Не се показват хранилища: потвърдете, че инсталацията на приложението включва очакваните хранилища и че потребителят, който упълномощава в ChatGPT, има достъп до тях.
Доставките на webhook са неуспешни: потвърдете, че URL адресът за webhook и тайната за webhook съвпадат със стойностите от ChatGPT, оставете SSL проверката активирана и се уверете, че хостът на GitHub Enterprise може да достигне
connectors.api.openai.org.Грешки с частния ключ: потвърдете, че е копирано пълното PEM съдържание, включително началният и крайният ред.