Zistite, ako môžu správcovia pracovného priestoru nakonfigurovať šablónu aplikácie GitHub Enterprise v ChatGPT pomocou vlastnej aplikácie GitHub App svojej organizácie.

Prehľad

Tento návod je určený správcom pracovného priestoru ChatGPT, ktorí nastavujú šablónu aplikácie GitHub Enterprise pre svoju organizáciu. Šablóna nie je finálna aplikácia, ktorú používajú členovia. Ide o postup nastavenia, ktorý po zadaní požadovanej konfigurácie GitHub Enterprise vytvorí koncept aplikácie pre konkrétny pracovný priestor.

V prípade GitHub Enterprise nastavenie prepojí ChatGPT s hostiteľom GitHub Enterprise vašej organizácie. Vytvoríte aplikáciu GitHub App, zaregistrujete URL spätného volania ChatGPT, vygenerujete prihlasovacie údaje a potom tieto hodnoty vložíte do nastavenia šablóny v ChatGPT. Keď ChatGPT vytvorí koncept aplikácie, môžete ho publikovať a spravovať rovnako ako ostatné aplikácie pracovného priestoru.

Informácie o navigácii v pracovnom priestore a prístupe k aplikáciám nájdete v článku: Ovládacie prvky správcu, zabezpečenie a súlad s predpismi pre doplnky a aplikácie.

Čo nastavujete

V ChatGPT vytvárate aplikáciu GitHub Enterprise pre konkrétny pracovný priestor. Aplikácia používa:

Aplikáciu GitHub App zaregistrovanú na vašom hostiteľovi GitHub Enterprise.
ID klienta a tajný kľúč klienta aplikácie GitHub App na autorizáciu používateľa cez OAuth.
Súkromný kľúč aplikácie GitHub App, aby ChatGPT mohlo vytvárať inštalačné tokeny na operácie s repozitármi.
Tajný kľúč webhooku a URL webhooku, aby GitHub Enterprise mohlo odosielať udalosti inštalácie a repozitárov späť do ChatGPT.
Názov vášho hostiteľa GitHub Enterprise, napríklad github.example.com.

Vytvorte aplikáciu GitHub App, nie samostatnú aplikáciu GitHub OAuth App. Nastavenie šablóny v ChatGPT vyžaduje prihlasovacie údaje aplikácie GitHub App, súkromný kľúč a nastavenia webhooku.

Skôr než začnete

Potrebujete:

Prístup správcu alebo vlastníka pracovného priestoru ChatGPT.
Prístup správcu GitHub Enterprise alebo vlastníka organizácie s oprávnením vytvárať a inštalovať aplikácie GitHub App.
Samotný názov hostiteľa GitHub Enterprise bez https:// alebo cesty.
Rozhodnutie, ktoré akcie s repozitármi má ChatGPT podporovať, napríklad vyhľadávanie v repozitároch iba na čítanie, pracovné postupy s pull request, pracovné postupy s hláseniami, úpravy súborov, GitHub Actions alebo širšie pracovné postupy s Codex.
Bezpečné miesto na prácu so súkromným kľúčom a tajným kľúčom klienta aplikácie GitHub App.

Nechajte ChatGPT a GitHub Enterprise otvorené na samostatných kartách. Nevymýšľajte si URL spätného volania. Skopírujte presnú URL spätného volania zobrazenú v ChatGPT.

Hodnoty, ktoré si treba pripraviť

Názov hostiteľa GitHub Enterprise: napríklad github.example.com.
URL spätného volania: skopírujte ju z nastavenia šablóny v ChatGPT.
ID klienta aplikácie GitHub App.
Tajný kľúč klienta aplikácie GitHub App.
Súkromný kľúč aplikácie GitHub App vo formáte PEM.
Tajný kľúč webhooku vygenerovaný v ChatGPT.
URL webhooku vygenerovaná po vytvorení konceptu aplikácie v ChatGPT.

Začnite nastavovať šablónu v ChatGPT

V ChatGPT prepnite na pracovný priestor, v ktorom má byť aplikácia dostupná.
Otvorte Nastavenia pracovného priestoru > Aplikácie. Môžete tiež prejsť do Konzoly správcu, vybrať požadovaný pracovný priestor ChatGPT a otvoriť Doplnky. Výberom položky Spravovať staršie aplikácie otvorte pôvodnú stránku Aplikácie.
Vyberte Adresár.
Vyhľadajte GitHub Enterprise.
Vyberte šablónu aplikácie GitHub Enterprise a spustite nastavenie.
Zadajte výstižný názov a opis aplikácie, napríklad GitHub Enterprise alebo GitHub Enterprise – Vývoj.
Zadajte názov hostiteľa GitHub Enterprise, napríklad github.example.com.
Skopírujte URL spätného volania zobrazenú v ChatGPT. Nechajte túto kartu otvorenú.
Ak sa počas nastavenia zobrazí vygenerovaný tajný kľúč webhooku, skopírujte ho.

Príklad URL spätného volania: https://chatgpt.com/connector/oauth/<callback_id>

Neodstraňujte ID spätného volania, nepridávajte lomku na koniec ani nenahrádzajte túto adresu všeobecnou URL ChatGPT.

Vytvorenie aplikácie GitHub v GitHub Enterprise

Otvorte svoj server GitHub Enterprise, napríklad https://github.example.com.
Prejdite do organizácie alebo účtu, ktorý má aplikáciu vlastniť.
Otvorte Nastavenia > Nastavenia pre vývojárov > Aplikácie GitHub.
Vyberte Nová aplikácia GitHub.
Zadajte výstižný názov aplikácie, napríklad ChatGPT GitHub Enterprise.
Zadajte URL adresu domovskej stránky. Ak neexistuje vyhradená interná stránka, použite URL adresu organizácie v GitHub Enterprise.
Do poľa URL adresa spätného volania vložte presnú URL adresu spätného volania skopírovanú z ChatGPT.
Možnosť Ukončiť platnosť autorizačných tokenov používateľov ponechajte zapnutú, pokiaľ váš bezpečnostný tím nemá konkrétny dôvod na jej zmenu.
Zapnite možnosť Vyžiadať autorizáciu používateľa počas inštalácie, aby používatelia mohli aplikáciu autorizovať pri inštalácii alebo pripájaní.
V časti „Kde sa môže táto aplikácia GitHub nainštalovať?“ vyberte možnosť s najužším rozsahom, ktorá vyhovuje vášmu nasadeniu.
Vytvorte aplikáciu GitHub.

Nastavte povolenia a udalosti

Vyberte minimálne povolenia potrebné pre akcie ChatGPT, ktoré plánujete povoliť.

Na vyhľadávanie repozitárov a zodpovedanie otázok bez zápisu začnite s povoleniami na čítanie, napríklad:

Metaúdaje: iba na čítanie. GitHub vyžaduje pre aplikácie GitHub App prístup k metaúdajom.
Obsah: iba na čítanie, na prístup k obsahu súborov a repozitárov.
Hlásenia: iba na čítanie, ak je potrebné vyhľadávať alebo čítať hlásenia.
Pull requests: iba na čítanie, ak je potrebné vyhľadávať pull request alebo získať kontext na kontrolu.
Akcie: iba na čítanie, ak sú potrebné stavy behov pracovných postupov, úlohy, protokoly alebo artefakty.

Pri pracovných postupoch so zápisom pridajte povolenia na zápis iba tam, kde sú potrebné, napríklad pre Obsah, Pull requests, Hlásenia, Akcie alebo Pracovné postupy. Použite čo najužší rozsah povolení, ktorý umožňuje zamýšľané akcie ChatGPT.

Udalosti webhookov by mali zodpovedať pracovným postupom, ktoré podporujete. Medzi bežné udalosti patria Inštalácia, Repozitáre inštalácie, Odoslanie zmien, Pull request, Hlásenia, Komentár k hláseniu, Beh pracovného postupu a Úloha pracovného postupu.

Vygenerujte a skopírujte prihlasovacie údaje aplikácie GitHub App

V nastaveniach aplikácie GitHub App skopírujte ID klienta.
Vygenerujte Tajný kľúč klienta a ihneď ho skopírujte.
V časti Súkromné kľúče vygenerujte súkromný kľúč.
Stiahnite súbor .pem a bezpečne ho uložte.
Otvorte súbor .pem lokálne a skopírujte celý text PEM vrátane úvodného a záverečného riadka.

Súkromný kľúč je citlivý údaj. Zaobchádzajte s ním ako s prihlasovacími údajmi. Ak dôjde k jeho úniku, vygenerujte nový súkromný kľúč, aktualizujte nastavenie aplikácie v ChatGPT a odstráňte kompromitovaný kľúč v GitHub Enterprise.

Dokončite nastavenie v ChatGPT

Vráťte sa na kartu s nastavením šablóny v ChatGPT.
Vložte ID klienta aplikácie GitHub App do poľa ID klienta OAuth.
Vložte tajný kľúč klienta aplikácie GitHub App do poľa Tajný kľúč klienta OAuth.
Ponechajte Rozsahy bez zmeny, pokiaľ vaša organizácia nemá konkrétny dôvod zmeniť predvolené hodnoty šablóny.
Overte, že je zadaný iba samotný názov hostiteľa GitHub Enterprise, napríklad github.example.com.
Vložte alebo nahrajte súkromný kľúč aplikácie GitHub App vo formáte PEM do poľa Súkromný kľúč aplikácie GitHub App.
Overte, že je vyplnený vygenerovaný tajný kľúč webhooku.
Vytvorte koncept aplikácie.
V ChatGPT otvorte podrobnosti vytvoreného konceptu aplikácie a skopírujte vygenerovanú URL webhooku.

URL webhooku by mala vyzerať takto: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Dokončite nastavenie webhooku v GitHub Enterprise

Vráťte sa do nastavení aplikácie GitHub App v GitHub Enterprise.
Otvorte Všeobecné nastavenia aplikácie GitHub App.
Zapnite možnosť Aktívne webhooky, ak ešte nie je zapnutá.
Vložte URL webhooku z ChatGPT do poľa URL webhooku.
Vložte tajný kľúč webhooku z ChatGPT do poľa Tajný kľúč webhooku.
Ponechajte overovanie SSL zapnuté.
Overte, že odoberané udalosti webhookov zodpovedajú povoleniam a akciám, ktoré ste povolili.
Uložte zmeny.

Publikovanie a správa aplikácie v ChatGPT

Vytvorením konceptu aplikácie sa aplikácia automaticky nesprístupní členom. Po kontrole konceptu:

Publikujte koncept aplikácie.
V nastaveniach pracovného priestoru otvorte stránku Aplikácie, prejdite do časti Povolené a overte, či sa aplikácia zobrazuje. Stránku Aplikácie môžete otvoriť aj pomocou možnosti Spravovať staršie aplikácie v časti Konzola správcu > Doplnky.
V plánoch Enterprise a Edu vyberte v časti Prístup používateľov roly, ktoré môžu aplikáciu používať. V pláne Business spravujte dostupnosť aplikácie pre celý pracovný priestor.
Skontrolujte nastavenia v časti Ovládanie akcií pre akcie čítania a zápisu.
V časti Povolenia aplikácie nastavte, kedy má ChatGPT pred použitím aplikácie požiadať členov o súhlas.
Požiadajte testovacieho používateľa s povoleným prístupom, aby otvoril Aplikácie v ChatGPT a overil, či sa aplikácia zobrazuje.

Tieto povolenia aplikácie sa vzťahujú na konverzácie v ChatGPT. Agenti pracovného priestoru používajú individuálne nastavenia, ktoré určuje tvorca každého agenta. Tieto nastavenia určujú, ktoré akcie aplikácie sú dostupné a kedy sa od koncových používateľov vyžaduje ich schválenie. Informácie o správaní agentov nájdete v článku: Agenti pracovného priestoru ChatGPT pre Enterprise a Business.

Nainštalujte a otestujte aplikáciu GitHub App

V GitHub Enterprise nainštalujte aplikáciu GitHub do organizácie alebo účtu.
Podľa pravidiel pracovného priestoru zvoľte všetky repozitáre alebo vybrané repozitáre.
Ako používateľ s povoleným prístupom spustite v ChatGPT postup pripojenia.
Po zobrazení výzvy autorizujte aplikáciu GitHub.
Najprv vykonajte jednoduchú akciu čítania, napríklad zobrazenie zoznamu dostupných repozitárov alebo načítanie známeho pull request.
Ak sú povolené akcie zápisu, pred širším nasadením ich otestujte na repozitári s nízkym rizikom.

Názov hostiteľa a fungovanie OAuth

ChatGPT odvodzuje koncové body GitHub Enterprise z názvu hostiteľa. Zadajte iba názov hostiteľa, napríklad github.example.com alebo octocorp.ghe.com.

Nezadávajte cestu API, cestu k repozitáru ani github.com, pokiaľ nejde o presný názov hostiteľa GitHub Enterprise pre túto aplikáciu.

Riešenie problémov

Nezhoda URI presmerovania: overte, že URL spätného volania aplikácie GitHub App sa presne zhoduje s URL spätného volania zobrazenou v ChatGPT.
ChatGPT nedokáže vytvoriť alebo uložiť koncept aplikácie: overte, že sú vyplnené všetky povinné polia vrátane názvu hostiteľa, ID klienta OAuth, Tajného kľúča klienta OAuth, súkromného kľúča a tajného kľúča webhooku.
Overenie totožnosti prebehne úspešne, ale volania repozitára zlyhajú: overte, že aplikácia GitHub App je nainštalovaná a má prístup k repozitáru.
API vráti chybu 403 alebo hlási nedostatočné povolenia: pridajte chýbajúce povolenie aplikácie GitHub App a v prípade výzvy požiadajte vlastníka inštalácie o schválenie aktualizovaných povolení.
Nezobrazujú sa žiadne repozitáre: overte, že inštalácia aplikácie zahŕňa očakávané repozitáre a že používateľ vykonávajúci autorizáciu v ChatGPT má k nim prístup.
Doručovanie webhookov zlyháva: overte, že URL a tajný kľúč webhooku sa zhodujú s hodnotami z ChatGPT, ponechajte overovanie SSL zapnuté a uistite sa, že hostiteľ GitHub Enterprise má prístup k connectors.api.openai.org.
Chyby súkromného kľúča: overte, že bol skopírovaný celý obsah PEM vrátane úvodného a záverečného riadka.

Nastavenie šablóny aplikácie GitHub Enterprise v ChatGPT