Přehled
Tento návod je určen správcům pracovních prostorů ChatGPT, kteří nastavují šablonu aplikace GitHub Enterprise pro svou organizaci. Šablona není hotová aplikace, kterou členové používají. Jde o průvodce nastavením, který po zadání požadované konfigurace GitHub Enterprise vytvoří koncept aplikace pro konkrétní pracovní prostor.
V případě GitHub Enterprise nastavení propojí ChatGPT s hostitelem GitHub Enterprise vaší organizace. Vytvoříte aplikaci GitHub App, zaregistrujete adresu URL zpětného volání ChatGPT, vygenerujete přihlašovací údaje a poté tyto hodnoty vložíte do průvodce nastavením šablony v ChatGPT. Jakmile ChatGPT vytvoří koncept aplikace, můžete ho publikovat a spravovat stejně jako ostatní aplikace pracovního prostoru.
Informace o navigaci v pracovním prostoru a přístupu k aplikacím najdete v článku Nástroje pro správu, zabezpečení a dodržování předpisů pro pluginy a aplikace.
Co nastavujete
V ChatGPT vytváříte aplikaci GitHub Enterprise pro konkrétní pracovní prostor. Aplikace využívá:
Aplikaci GitHub App zaregistrovanou na vašem hostiteli GitHub Enterprise.
ID klienta a tajný klíč klienta aplikace GitHub App pro autorizaci uživatele přes OAuth.
Soukromý klíč aplikace GitHub App, aby ChatGPT mohl vytvářet instalační tokeny pro operace s úložišti.
Tajný klíč a adresu URL webhooku, aby GitHub Enterprise mohl odesílat události instalací a úložišť zpět do ChatGPT.
Název vašeho hostitele GitHub Enterprise, například
github.example.com.
Vytvořte aplikaci GitHub App, nikoli samostatnou aplikaci GitHub OAuth App. Nastavení šablony v ChatGPT vyžaduje přihlašovací údaje aplikace GitHub App, soukromý klíč a nastavení webhooku.
Než začnete
Potřebujete:
Přístup správce nebo vlastníka pracovního prostoru ChatGPT.
Přístup správce GitHub Enterprise nebo vlastníka organizace s oprávněním vytvářet a instalovat aplikace GitHub App.
Pouze název hostitele GitHub Enterprise, bez
https://a bez cesty.Mít rozhodnuto, které akce s úložišti má ChatGPT podporovat, například vyhledávání v úložištích pouze pro čtení, pracovní postupy s pull request, pracovní postupy s úlohami, úpravy souborů, GitHub Actions nebo širší pracovní postupy s Codex.
Bezpečné místo pro práci se soukromým klíčem a tajným klíčem klienta aplikace GitHub App.
ChatGPT a GitHub Enterprise nechte otevřené na samostatných kartách. Adresu URL zpětného volání nevymýšlejte. Zkopírujte přesnou adresu URL zpětného volání zobrazenou v ChatGPT.
Hodnoty, které si připravte
Název hostitele GitHub Enterprise: například
github.example.com.Adresa URL zpětného volání: zkopírujte ji z průvodce nastavením šablony v ChatGPT.
ID klienta aplikace GitHub App.
Tajný klíč klienta aplikace GitHub App.
Soukromý klíč aplikace GitHub App ve formátu PEM.
Tajný klíč webhooku vygenerovaný v ChatGPT.
Adresa URL webhooku vygenerovaná po vytvoření konceptu aplikace v ChatGPT.
Zahajte nastavení šablony v ChatGPT
V ChatGPT přepněte do pracovního prostoru, ve kterém má být aplikace dostupná.
Otevřete Nastavení pracovního prostoru > Aplikace. Můžete také přejít do Konzole pro správu, vybrat požadovaný pracovní prostor ChatGPT a otevřít Pluginy. Výběrem možnosti Spravovat starší aplikace otevřete původní stránku Aplikace.
Vyberte Adresář.
Vyhledejte GitHub Enterprise.
Vyberte šablonu aplikace GitHub Enterprise a zahajte nastavení.
Zadejte výstižný název a popis aplikace, například GitHub Enterprise nebo GitHub Enterprise – Vývoj.
Zadejte název hostitele GitHub Enterprise, například
github.example.com.Zkopírujte adresu URL zpětného volání zobrazenou v ChatGPT. Tuto kartu nechte otevřenou.
Pokud se během nastavení zobrazí vygenerovaný tajný klíč webhooku, zkopírujte ho.
Příklad adresy URL zpětného volání: https://chatgpt.com/connector/oauth/<callback_id>
Neodstraňujte ID zpětného volání, nepřidávejte koncové lomítko ani adresu nenahrazujte obecnou adresou URL ChatGPT.
Vytvoření aplikace GitHub v GitHub Enterprise
Otevřete svou instanci GitHub Enterprise, například
https://github.example.com.Přejděte do organizace nebo účtu, který má aplikaci vlastnit.
Otevřete Nastavení > Nastavení pro vývojáře > Aplikace GitHub.
Vyberte Nová aplikace GitHub.
Zadejte výstižný název aplikace, například ChatGPT GitHub Enterprise.
Zadejte URL domovské stránky. Pokud pro aplikaci nemáte vyhrazenou interní stránku, použijte URL organizace v GitHub Enterprise.
Do pole URL zpětného volání vložte přesnou URL zpětného volání zkopírovanou z ChatGPT.
Ponechte možnost Ukončovat platnost autorizačních tokenů uživatelů zapnutou, pokud váš bezpečnostní tým nemá konkrétní důvod toto nastavení změnit.
Zapněte možnost Vyžadovat autorizaci uživatele při instalaci, aby uživatelé mohli aplikaci autorizovat během instalace nebo připojování.
V části „Kam lze tuto aplikaci GitHub nainstalovat?“ vyberte možnost s nejužším rozsahem, která vyhovuje vašemu plánovanému nasazení.
Vytvořte aplikaci GitHub.
Nastavte oprávnění a události
Vyberte minimální oprávnění potřebná pro akce ChatGPT, které plánujete povolit.
Pro vyhledávání úložišť a odpovídání na otázky bez možnosti zápisu začněte oprávněními ke čtení, například:
Metadata: pouze ke čtení. GitHub vyžaduje pro aplikace GitHub App přístup k metadatům.
Obsah: pouze ke čtení, pro přístup k souborům a obsahu úložišť.
Úlohy: pouze ke čtení, pokud potřebujete vyhledávat nebo číst úlohy.
Pull requests: pouze ke čtení, pokud potřebujete vyhledávat pull request nebo získávat kontext pro kontrolu změn.
Akce: pouze ke čtení, pokud potřebujete stav běhu pracovních postupů, úlohy, protokoly nebo artefakty.
U pracovních postupů se zápisem přidejte oprávnění k zápisu pouze tam, kde jsou potřeba, například pro Obsah, Pull requests, Úlohy, Akce nebo Pracovní postupy. Použijte co nejužší oprávnění, která umožňují zamýšlené akce ChatGPT.
Události webhooku by měly odpovídat pracovním postupům, které podporujete. Mezi běžné události patří Instalace, Úložiště instalace, Odeslání změn, Pull request, Úlohy, Komentář k úloze, Běh pracovního postupu a Úloha pracovního postupu.
Vygenerujte a zkopírujte přihlašovací údaje aplikace GitHub App
V nastavení aplikace GitHub App zkopírujte ID klienta.
Vygenerujte tajný klíč klienta a ihned ho zkopírujte.
V části Soukromé klíče vygenerujte soukromý klíč.
Stáhněte soubor .pem a bezpečně ho uložte.
Otevřete soubor .pem místně a zkopírujte celý text PEM včetně počátečního a koncového řádku.
Soukromý klíč je citlivý údaj. Zacházejte s ním stejně jako s přihlašovacími údaji. Pokud dojde k jeho vyzrazení, vygenerujte nový soukromý klíč, aktualizujte nastavení aplikace v ChatGPT a odstraňte kompromitovaný klíč v GitHub Enterprise.
Dokončete nastavení v ChatGPT
Vraťte se na kartu s nastavením šablony v ChatGPT.
Vložte ID klienta aplikace GitHub App do pole ID klienta OAuth.
Vložte tajný klíč klienta aplikace GitHub App do pole Tajný klíč klienta OAuth.
Pole Rozsahy oprávnění ponechte beze změny, pokud vaše organizace nemá konkrétní důvod změnit výchozí nastavení šablony.
Ověřte, že název hostitele GitHub Enterprise obsahuje pouze samotný název hostitele, například
github.example.com.Vložte nebo nahrajte soukromý klíč aplikace GitHub App ve formátu PEM do pole Soukromý klíč aplikace GitHub App.
Ověřte, že je vyplněný vygenerovaný tajný klíč webhooku.
Vytvořte koncept aplikace.
V ChatGPT otevřete podrobnosti vytvořeného konceptu aplikace a zkopírujte vygenerovanou adresu URL webhooku.
Adresa URL webhooku by měla mít tento tvar: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Dokončete nastavení webhooku v GitHub Enterprise
Vraťte se do nastavení aplikace GitHub App v GitHub Enterprise.
Otevřete Obecná nastavení aplikace GitHub App.
Zapněte možnost Aktivní webhooky, pokud ještě není zapnutá.
Vložte adresu URL webhooku z ChatGPT do pole Adresa URL webhooku.
Vložte tajný klíč webhooku z ChatGPT do pole Tajný klíč webhooku.
Ponechte ověřování SSL zapnuté.
Ověřte, že odebírané události webhooku odpovídají oprávněním a akcím, které jste povolili.
Uložte změny.
Publikování a správa aplikace v ChatGPT
Vytvořením konceptu aplikace se aplikace automaticky nezpřístupní členům. Po kontrole konceptu:
Publikujte koncept aplikace.
V nastavení pracovního prostoru otevřete stránku Aplikace, přejděte do části Povolené a ověřte, že se aplikace zobrazuje. Stránku Aplikace můžete otevřít také pomocí možnosti Spravovat starší aplikace v Konzoli správce > Pluginy.
V tarifech Enterprise a Edu pomocí nastavení Přístup uživatelů vyberte, které role mohou aplikaci používat. V tarifu Business spravujte dostupnost aplikace v celém pracovním prostoru.
Zkontrolujte nastavení Řízení akcí pro akce čtení a zápisu.
V nastavení Oprávnění aplikace určete, kdy má ChatGPT před použitím aplikace požádat členy o souhlas.
Požádejte testovacího uživatele s povoleným přístupem, aby otevřel Aplikace v ChatGPT a ověřil, že se aplikace zobrazuje.
Tato oprávnění aplikace platí pro konverzace v ChatGPT. Agenti pracovního prostoru používají nastavení, která pro každého agenta určuje jeho tvůrce. Ta určují, které akce aplikace jsou dostupné a kdy jsou koncoví uživatelé požádáni o jejich schválení. Informace o chování agentů najdete v článku Agenti pracovního prostoru ChatGPT pro Enterprise a Business.
Nainstalujte a otestujte aplikaci GitHub App
V GitHub Enterprise nainstalujte aplikaci GitHub App pro danou organizaci nebo účet.
Podle zásad pracovního prostoru zvolte všechna úložiště nebo jen vybraná úložiště.
Jako uživatel s povoleným přístupem spusťte v ChatGPT proces připojení.
Po zobrazení výzvy autorizujte aplikaci GitHub App.
Nejprve spusťte jednoduchou akci čtení, například výpis dostupných úložišť nebo načtení známého pull request.
Pokud jsou povolené akce zápisu, před širším nasazením je otestujte v úložišti s nízkým rizikem.
Název hostitele a fungování OAuth
ChatGPT používá název hostitele k odvození koncových bodů GitHub Enterprise. Zadejte pouze název hostitele, například github.example.com nebo octocorp.ghe.com.
Nezadávejte cestu k API ani cestu k úložišti. Nezadávejte ani github.com, pokud to není přesný název hostitele GitHub Enterprise pro tuto aplikaci.
Řešení problémů
Neshoda URI přesměrování: ověřte, že adresa URL zpětného volání aplikace GitHub App přesně odpovídá adrese URL zpětného volání zobrazené v ChatGPT.
ChatGPT nemůže vytvořit nebo uložit koncept aplikace: ověřte, že jsou vyplněna všechna povinná pole včetně názvu hostitele, ID klienta OAuth, tajného klíče klienta OAuth, soukromého klíče a tajného klíče webhooku.
Ověření proběhne úspěšně, ale volání úložiště selhávají: ověřte, že je aplikace GitHub App nainstalovaná a má přístup k úložišti.
API vrací chybu 403 nebo hlásí nedostatečná oprávnění: přidejte chybějící oprávnění aplikace GitHub App a v případě výzvy požádejte vlastníka instalace, aby aktualizovaná oprávnění schválil.
Nezobrazují se žádná úložiště: ověřte, že instalace aplikace zahrnuje očekávaná úložiště a že k nim má přístup uživatel, který aplikaci autorizuje v ChatGPT.
Doručování webhooků selhává: ověřte, že adresa URL a tajný klíč webhooku odpovídají hodnotám z ChatGPT, ponechte zapnuté ověřování SSL a ujistěte se, že hostitel GitHub Enterprise má přístup k
connectors.api.openai.org.Chyby soukromého klíče: ověřte, že byl zkopírován celý obsah PEM včetně počátečního a koncového řádku.