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

1. V ChatGPT prepnite na pracovný priestor, v ktorom má byť aplikácia dostupná.

2. 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.

3. Vyberte Adresár.

4. Vyhľadajte GitHub Enterprise.

5. Vyberte šablónu aplikácie GitHub Enterprise a spustite nastavenie.

6. Zadajte výstižný názov a opis aplikácie, napríklad GitHub Enterprise alebo GitHub Enterprise – Vývoj.

7. Zadajte názov hostiteľa GitHub Enterprise, napríklad github.example.com.

8. Skopírujte URL spätného volania zobrazenú v ChatGPT. Nechajte túto kartu otvorenú.

9. 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.

Vytvorte aplikáciu GitHub App v GitHub Enterprise

1. Otvorte svojho hostiteľa GitHub Enterprise, napríklad https://github.example.com.

2. Prejdite do organizácie alebo účtu, ktorý má aplikáciu vlastniť.

3. Otvorte Nastavenia > Nastavenia pre vývojárov > Aplikácie GitHub App.

4. Vyberte Nová aplikácia GitHub App.

5. Zadajte výstižný názov aplikácie, napríklad Konektor ChatGPT pre GitHub Enterprise.

6. Zadajte URL domovskej stránky. Ak neexistuje vyhradená interná stránka, použite URL organizácie v GitHub Enterprise.

7. Do poľa URL spätného volania vložte presnú URL spätného volania skopírovanú z ChatGPT.

8. Ponechajte možnosť Ukončiť platnosť autorizačných tokenov používateľa zapnutú, pokiaľ váš bezpečnostný tím nemá konkrétny dôvod ju zmeniť.

9. Zapnite možnosť Vyžiadať autorizáciu používateľa počas inštalácie, aby používatelia mohli aplikáciu autorizovať počas inštalácie alebo pripájania.

10. V časti Kde možno túto aplikáciu GitHub App nainštalovať? vyberte možnosť s najužším rozsahom, ktorá vyhovuje vášmu nasadeniu.

11. Vytvorte aplikáciu GitHub App.

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

1. V nastaveniach aplikácie GitHub App skopírujte ID klienta.

2. Vygenerujte Tajný kľúč klienta a ihneď ho skopírujte.

3. V časti Súkromné kľúče vygenerujte súkromný kľúč.

4. Stiahnite súbor .pem a bezpečne ho uložte.

5. 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

1. Vráťte sa na kartu s nastavením šablóny v ChatGPT.

2. Vložte ID klienta aplikácie GitHub App do poľa ID klienta OAuth.

3. Vložte tajný kľúč klienta aplikácie GitHub App do poľa Tajný kľúč klienta OAuth.

4. Ponechajte Rozsahy bez zmeny, pokiaľ vaša organizácia nemá konkrétny dôvod zmeniť predvolené hodnoty šablóny.

5. Overte, že je zadaný iba samotný názov hostiteľa GitHub Enterprise, napríklad github.example.com.

6. 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.

7. Overte, že je vyplnený vygenerovaný tajný kľúč webhooku.

8. Vytvorte koncept aplikácie.

9. 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

1. Vráťte sa do nastavení aplikácie GitHub App v GitHub Enterprise.

2. Otvorte Všeobecné nastavenia aplikácie GitHub App.

3. Zapnite možnosť Aktívne webhooky, ak ešte nie je zapnutá.

4. Vložte URL webhooku z ChatGPT do poľa URL webhooku.

5. Vložte tajný kľúč webhooku z ChatGPT do poľa Tajný kľúč webhooku.

6. Ponechajte overovanie SSL zapnuté.

7. Overte, že odoberané udalosti webhookov zodpovedajú povoleniam a akciám, ktoré ste povolili.

8. Uložte zmeny.

Publikujte a spravujte aplikáciu v ChatGPT

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

1. Publikujte koncept aplikácie.

2. V Nastaveniach pracovného priestoru otvorte stránku Aplikácie, otvorte Povolené a overte, že sa aplikácia zobrazuje. Stránku Aplikácie môžete otvoriť aj cez Spravovať staršie aplikácie v časti Konzola správcu > Doplnky.

3. Nastavte Prístup používateľov pre roly, ktoré majú aplikáciu používať.

4. Skontrolujte Riadenie akcií pre akcie čítania a zápisu.

5. V časti Povolenia aplikácie nastavte, kedy má ChatGPT pred použitím aplikácie požiadať členov o súhlas.

6. Požiadajte testovacieho používateľa s povoleným prístupom, aby otvoril Aplikácie v ChatGPT a overil, že sa aplikácia zobrazuje.

Tieto povolenia aplikácie sa vzťahujú na konverzácie v ChatGPT. Agenti pracovného priestoru používajú ovládacie prvky nastavené tvorcom každého agenta. Tie 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

1. V GitHub Enterprise nainštalujte aplikáciu GitHub do organizácie alebo účtu.

2. Podľa pravidiel pracovného priestoru zvoľte všetky repozitáre alebo vybrané repozitáre.

3. Ako používateľ s povoleným prístupom spustite v ChatGPT postup pripojenia.

4. Po zobrazení výzvy autorizujte aplikáciu GitHub.

5. Najprv vykonajte jednoduchú akciu čítania, napríklad zobrazenie zoznamu dostupných repozitárov alebo načítanie známeho pull request.

6. 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.

Odkazy

• Dokumentácia GitHub: Registrácia aplikácie GitHub App

• Dokumentácia GitHub: Informácie o URL spätného volania pri autorizácii používateľa

• Dokumentácia GitHub: Výber povolení pre aplikáciu GitHub App

• Dokumentácia GitHub: Používanie webhookov s aplikáciami GitHub App

• Dokumentácia GitHub: Správa súkromných kľúčov aplikácií GitHub App