OpenAI
Оваа страница беше машински преведена. Погледнете ја оригиналната статија на англиски јазик.

Поставете го шаблонот за апликацијата GitHub Enterprise во ChatGPT

Дознајте како администраторите на работен простор можат да го конфигурираат шаблонот за апликацијата GitHub Enterprise во ChatGPT со сопствената GitHub App на нивната организација.

Ажурирано: 2 months ago

Преглед

Користете го овој водич ако сте администратор на работен простор во 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 да може да издава инсталациски токени за операции со репозиториуми.

  • Webhook-тајна и webhook URL-адреса за 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.

  • Безбедно место за ракување со приватниот клуч и тајната на клиентот за GitHub App.

Држете ги ChatGPT и GitHub Enterprise отворени во одделни јазичиња. Не измислувајте ја URL-адресата за повратен повик. Копирајте ја точната URL-адреса за повратен повик прикажана во ChatGPT.

Вредности за подготовка

  • Име на хост за GitHub Enterprise: на пример, github.example.com.

  • URL-адреса за повратен повик: копирајте ја од текот за поставување на шаблонот во ChatGPT.

  • ID на клиент за GitHub App.

  • Тајна на клиент за GitHub App.

  • Приватен клуч PEM за GitHub App.

  • Webhook-тајна генерирана од ChatGPT.

  • Webhook URL-адреса генерирана откако нацрт-апликацијата ќе се создаде во ChatGPT.

Започнете го поставувањето на шаблонот во ChatGPT

  1. Во ChatGPT, префрлете се на работниот простор каде што апликацијата треба да биде достапна.

  2. Отворете Поставки на работниот простор > Апликации.

  3. Изберете Директориум.

  4. Пребарајте GitHub Enterprise.

  5. Изберете го шаблонот за апликацијата GitHub Enterprise и започнете го поставувањето.

  6. Внесете јасно име и опис на апликацијата, како GitHub Enterprise или GitHub Enterprise - Engineering.

  7. Внесете го името на хостот за GitHub Enterprise, како github.example.com.

  8. Копирајте ја URL-адресата за повратен повик прикажана во ChatGPT. Оставете го ова јазиче отворено.

  9. Копирајте ја генерираната webhook-тајна ако е прикажана за време на поставувањето.

Пример URL-адреса за повратен повик: https://chatgpt.com/connector/oauth/<callback_id>

Не отстранувајте го ID-то за повратен повик, не додавајте коса црта на крај и не заменувајте го со генеричка ChatGPT URL-адреса.

Создајте ја GitHub App во GitHub Enterprise

  1. Отворете го вашиот GitHub Enterprise хост, како https://github.example.com.

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

  3. Отворете Поставки > Поставки за програмери > GitHub Apps.

  4. Изберете Нова GitHub App.

  5. Внесете јасно име на апликацијата, како ChatGPT GitHub Enterprise Connector.

  6. Внесете URL-адреса на почетна страница. Ако нема посебна внатрешна страница, користете ја URL-адресата на организацијата GitHub Enterprise.

  7. Во URL-адреса за повратен повик, залепете ја точната URL-адреса за повратен повик копирана од ChatGPT.

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

  9. Овозможете барање корисничка авторизација при инсталација за корисниците да можат да ја авторизираат апликацијата за време на текот за инсталирање или поврзување.

  10. Под „Каде може да се инсталира оваа GitHub App?“, изберете ја најтесната опција што одговара на вашето воведување.

  11. Создајте ја GitHub App.

Конфигурирајте дозволи и настани

Изберете ги минималните дозволи потребни за дејствата на ChatGPT што планирате да ги овозможите.

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

  • Метаподатоци: само за читање. GitHub бара метаподатоци за GitHub Apps.

  • Содржина: само за читање, за пристап до содржина на датотеки и репозиториуми.

  • Проблеми: само за читање, ако е потребно пребарување или читање проблеми.

  • Барања за повлекување: само за читање, ако е потребно пребарување барања за повлекување или контекст за преглед.

  • Дејства: само за читање, ако се потребни статус на извршување работен тек, задачи, дневници или артефакти.

За работни текови со запишување, додајте дозволи за запишување само каде што е потребно, како Содржина, Барања за повлекување, Проблеми, Дејства или Работни текови. Користете ги најтесните дозволи што ги поддржуваат планираните дејства на ChatGPT.

Webhook-настаните треба да одговараат на работните текови што ги поддржувате. Вообичаени настани се Инсталација, Репозиториуми за инсталација, Push, Барање за повлекување, Проблеми, Коментар на проблем, Извршување работен тек и Задача на работен тек.

Генерирајте и копирајте акредитиви за GitHub App

  1. Во поставките за GitHub App, копирајте го ID на клиент.

  2. Генерирајте тајна на клиент и веднаш копирајте ја.

  3. Под Приватни клучеви, генерирајте приватен клуч.

  4. Преземете ја .pem-датотеката и чувајте ја безбедно.

  5. Отворете ја .pem-датотеката локално и копирајте го целиот PEM-текст, вклучувајќи ги почетните и завршните линии.

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

Завршете го поставувањето во ChatGPT

  1. Вратете се на јазичето за поставување на шаблонот во ChatGPT.

  2. Залепете го ID-то на клиентот за GitHub App во ID на OAuth клиент.

  3. Залепете ја тајната на клиентот за GitHub App во тајна на OAuth клиент.

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

  5. Потврдете дека името на хостот за GitHub Enterprise е само име на хост, како github.example.com.

  6. Залепете или прикачете го приватниот клуч PEM за GitHub App во приватен клуч за GitHub App.

  7. Потврдете дека генерираната webhook-тајна е присутна.

  8. Создајте ја нацрт-апликацијата.

  9. Отворете ги деталите за создадената нацрт-апликација во ChatGPT и копирајте ја генерираната webhook URL-адреса.

Webhook URL-адресата треба да изгледа вака: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Завршете го поставувањето на webhook во GitHub Enterprise

  1. Вратете се во поставките за GitHub App во GitHub Enterprise.

  2. Отворете ги Општите поставки за GitHub App.

  3. Овозможете Активни webhooks ако веќе не се овозможени.

  4. Залепете ја ChatGPT webhook URL-адресата во Webhook URL.

  5. Залепете ја ChatGPT webhook-тајната во Webhook secret.

  6. Оставете ја SSL-проверката овозможена.

  7. Потврдете дека претплатените webhook-настани одговараат на дозволите и дејствата што ги овозможивте.

  8. Зачувајте ги промените.

Објавете ја и управувајте со апликацијата во ChatGPT

Создавањето нацрт-апликација не ја прави автоматски достапна за членовите. По прегледот на нацртот:

  1. Објавете ја нацрт-апликацијата.

  2. Потврдете дека апликацијата се појавува во Поставки на работниот простор > Апликации > Овозможени.

  3. Конфигурирајте Кориснички пристап за улогите што треба да ја користат.

  4. Прегледајте Контрола на дејства за дејства за читање и запишување.

  5. Прегледајте Дозволи за апликација за да изберете кога ChatGPT да ги прашува членовите пред да ја користи апликацијата.

  6. Побарајте од дозволен тест-корисник да отвори Апликации во ChatGPT и да потврди дека апликацијата се појавува.

Овие дозволи за апликација се однесуваат на разговорите во ChatGPT. Агентите на работниот простор користат контроли по агент поставени од градителот на агентот за да одредат кои дејства на апликацијата се достапни и кога од крајните корисници се бара да ги одобрат. За однесување на агент, видете: ChatGPT Workspace Agents за Enterprise и Business.

Инсталирајте ја и тестирајте ја GitHub App

  1. Во GitHub Enterprise, инсталирајте ја GitHub app во организацијата или сметката.

  2. Изберете ги сите репозиториуми или избрани репозиториуми според политиката на работниот простор.

  3. Започнете го текот за поврзување од ChatGPT како дозволен корисник.

  4. Авторизирајте ја GitHub app кога ќе биде побарано.

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

  6. Ако се овозможени дејства за запишување, тестирајте со репозиториум со низок ризик пред пошироко воведување.

Име на хост и OAuth однесување

ChatGPT го користи името на хостот за да изведе крајни точки на GitHub Enterprise. Внесете го само хостот, како github.example.com или octocorp.ghe.com.

Не внесувајте API-патека, патека до репозиториум или github.com, освен ако тоа не е точниот GitHub Enterprise хост за оваа апликација.

Решавање проблеми

  • Несовпаѓање на URI за пренасочување: потврдете дека URL-адресата за повратен повик на GitHub App точно се совпаѓа со URL-адресата за повратен повик прикажана во ChatGPT.

  • ChatGPT не може да ја создаде или зачува нацрт-апликацијата: потврдете дека сите потребни полиња се присутни, вклучувајќи име на хост, ID на OAuth клиент, тајна на OAuth клиент, приватен клуч и webhook-тајна.

  • Автентикацијата успева, но повиците до репозиториумот не успеваат: потврдете дека GitHub App е инсталирана и има пристап до репозиториумот.

  • API враќа 403 или недоволни дозволи: додајте ја дозволата што недостасува за GitHub App и побарајте сопственикот на инсталацијата да ги одобри ажурираните дозволи ако биде побарано.

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

  • Webhook-испораките не успеваат: потврдете дека webhook URL-адресата и webhook-тајната се совпаѓаат со вредностите од ChatGPT, оставете ја SSL-проверката овозможена и осигурете се дека GitHub Enterprise хостот може да пристапи до connectors.api.openai.org.

  • Грешки со приватен клуч: потврдете дека е копирана целата PEM-содржина, вклучувајќи ги почетните и завршните линии.

Референци

Дали оваа статија ви беше корисна?