Přehled
Tento průvodce použijte, pokud jste správce pracovního prostoru ChatGPT a nastavujete šablonu aplikace Enterprise pro GitHub pro svou organizaci. Šablona není finální aplikace, kterou členové používají. Jde o tok nastavení, který po zadání požadované konfigurace GitHub Enterprise vytvoří koncept aplikace specifický pro pracovní prostor.
U 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 toku nastavení šablony v ChatGPT. Jakmile ChatGPT vytvoří koncept aplikace, můžete ho publikovat a spravovat jako jiné aplikace pracovního prostoru.
Co nastavujete
V ChatGPT vytváříte aplikaci GitHub Enterprise specifickou pro pracovní prostor. Aplikace používá:
Aplikaci GitHub App zaregistrovanou na vašem hostiteli GitHub Enterprise.
ID klienta a tajný klíč klienta aplikace GitHub App pro uživatelskou autorizaci OAuth.
Soukromý klíč aplikace GitHub App, aby ChatGPT mohl vytvářet instalační tokeny pro operace s úložišti.
Tajný klíč webhooku a adresu URL webhooku, aby GitHub Enterprise mohl odesílat události instalace a úložišť zpět do ChatGPT.
Název hostitele GitHub Enterprise, například
github.example.com.
Vytvořte aplikaci GitHub App, ne samostatnou aplikaci GitHub OAuth App. Nastavení šablony 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, který může vytvářet a instalovat aplikace GitHub Apps.
Pouze název hostitele GitHub Enterprise, bez
https://nebo cesty.Rozhodnutí, které akce úložiště má ChatGPT podporovat, například vyhledávání úložišť pouze pro čtení, pracovní postupy žádostí o přijetí změn, pracovní postupy problémů, úpravy souborů, GitHub Actions nebo širší pracovní postupy Codex.
Bezpečné místo pro práci se soukromým klíčem a tajným klíčem klienta aplikace GitHub App.
Ponechte ChatGPT a GitHub Enterprise otevřené na samostatných kartách. Nevymýšlejte adresu URL zpětného volání. Zkopírujte přesnou adresu URL zpětného volání zobrazenou v ChatGPT.
Hodnoty k přípravě
Název hostitele GitHub Enterprise: například
github.example.com.Adresa URL zpětného volání: zkopírujte ji z toku nastavení šablony v ChatGPT.
ID klienta aplikace GitHub App.
Tajný klíč klienta aplikace GitHub App.
Soukromý klíč PEM aplikace GitHub App.
Tajný klíč webhooku vygenerovaný ChatGPT.
Adresa URL webhooku vygenerovaná po vytvoření konceptu aplikace v ChatGPT.
Spusťte 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.
Vyberte Adresář.
Vyhledejte GitHub Enterprise.
Vyberte šablonu aplikace GitHub Enterprise a spusťte nastavení.
Zadejte srozumitelný název a popis aplikace, například GitHub Enterprise nebo GitHub Enterprise - Engineering.
Zadejte název hostitele GitHub Enterprise, například
github.example.com.Zkopírujte adresu URL zpětného volání zobrazenou v ChatGPT. Ponechte tuto kartu 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 ho nenahrazujte obecnou adresou URL ChatGPT.
Vytvořte aplikaci GitHub App v GitHub Enterprise
Otevřete svého hostitele 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 > GitHub Apps.
Vyberte Nová aplikace GitHub App.
Zadejte srozumitelný název aplikace, například ChatGPT GitHub Enterprise Connector.
Zadejte adresu URL domovské stránky. Pokud neexistuje vyhrazená interní stránka, použijte adresu URL organizace GitHub Enterprise.
Do pole Adresa URL zpětného volání vložte přesnou adresu URL zpětného volání zkopírovanou z ChatGPT.
Ponechte zapnutou možnost ukončení platnosti tokenů autorizace uživatele, pokud váš bezpečnostní tým nemá konkrétní důvod ji změnit.
Povolte vyžádání autorizace uživatele během instalace, aby uživatelé mohli aplikaci autorizovat při instalaci nebo připojení.
V části Kde lze tuto aplikaci GitHub App nainstalovat?, vyberte nejužší možnost vhodnou pro vaše zavedení.
Vytvořte aplikaci GitHub App.
Nakonfigurujte oprávnění a události
Vyberte minimální oprávnění potřebná pro akce ChatGPT, které plánujete povolit.
Pro zjišťování úložišť pouze pro čtení a otázky a odpovědi začněte oprávněními ke čtení, například:
Metadata: pouze pro čtení. GitHub vyžaduje metadata pro aplikace GitHub Apps.
Obsah: pouze pro čtení, pro přístup k souborům a obsahu úložišť.
Problémy: pouze pro čtení, pokud je potřeba vyhledávání nebo čtení problémů.
Žádosti o přijetí změn: pouze pro čtení, pokud je potřeba vyhledávání žádostí o přijetí změn nebo kontext pro kontrolu.
Akce: pouze pro čtení, pokud je potřeba stav běhu pracovního postupu, úlohy, protokoly nebo artefakty.
Pro pracovní postupy zápisu přidejte oprávnění k zápisu jen tam, kde jsou potřeba, například Obsah, Žádosti o přijetí změn, Problémy, Akce nebo Pracovní postupy. Použijte nejužší oprávnění, která podporují 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, Repozitáře instalace, Push, Žádost o přijetí změn, Problémy, Komentář k problému, 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ý. Zacházejte s ním jako s přihlašovacím údajem. Pokud dojde k jeho odhalení, 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 nastavení šablony 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.
Ponechte Rozsahy beze změny, pokud vaše organizace záměrně nepotřebuje přepsat výchozí nastavení šablony.
Ověřte, že název hostitele GitHub Enterprise obsahuje pouze hostitele, například
github.example.com.Vložte nebo nahrajte soukromý klíč PEM aplikace GitHub App do pole Soukromý klíč aplikace GitHub App.
Ověřte, že je vygenerovaný tajný klíč webhooku přítomen.
Vytvořte koncept aplikace.
Otevřete podrobnosti vytvořeného konceptu aplikace v ChatGPT a zkopírujte vygenerovanou adresu URL webhooku.
Adresa URL webhooku by měla vypadat takto: 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.
Povolte aktivní webhooky, pokud ještě nejsou povoleny.
Vložte adresu URL webhooku ChatGPT do pole Adresa URL webhooku.
Vložte tajný klíč webhooku ChatGPT do pole Tajný klíč webhooku.
Ponechte ověření 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.
Publikujte a spravujte aplikaci v ChatGPT
Vytvoření konceptu aplikace ji automaticky nezpřístupní členům. Po kontrole konceptu:
Publikujte koncept aplikace.
Ověřte, že se aplikace zobrazuje v části Nastavení pracovního prostoru > Aplikace > Povoleno.
Nakonfigurujte Přístup uživatelů pro role, které ji mají používat.
Zkontrolujte Řízení akcí pro akce čtení a zápisu.
Zkontrolujte Oprávnění aplikace a zvolte, kdy se má ChatGPT členů zeptat před použitím aplikace.
Požádejte povoleného testovacího uživatele, aby otevřel Aplikace v ChatGPT a ověřil, že se aplikace zobrazuje.
Tato oprávnění aplikace platí pro konverzace ChatGPT. Agenti pracovního prostoru používají ovládací prvky pro jednotlivé agenty nastavené tvůrcem agenta k určení, které akce aplikace jsou dostupné a kdy jsou koncoví uživatelé požádáni o jejich schválení. Chování agentů viz: Agenti pracovního prostoru ChatGPT pro Enterprise a Business.
Nainstalujte a otestujte aplikaci GitHub App
V GitHub Enterprise nainstalujte aplikaci GitHub App do organizace nebo účtu.
Vyberte všechna úložiště nebo vybraná úložiště podle zásad pracovního prostoru.
Spusťte tok připojení z ChatGPT jako povolený uživatel.
Na výzvu autorizujte aplikaci GitHub.
Nejprve spusťte malou akci čtení, například výpis dostupných úložišť nebo načtení známé žádosti o přijetí změn.
Pokud jsou povoleny akce zápisu, otestujte je před širším zavedením v úložišti s nízkým rizikem.
Název hostitele a chování OAuth
ChatGPT používá název hostitele k odvození koncových bodů GitHub Enterprise. Zadejte pouze hostitele, například github.example.com nebo octocorp.ghe.com.
Nezadávejte cestu API, cestu úložiště ani github.com, pokud to není přesný hostitel GitHub Enterprise pro tuto aplikaci.
Řešení potíží
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í 403 nebo nedostatečná oprávnění: přidejte chybějící oprávnění aplikace GitHub App a nechte vlastníka instalace schválit aktualizovaná oprávnění, pokud k tomu bude vyzván.
Nezobrazují se žádná úložiště: ověřte, že instalace aplikace zahrnuje očekávaná úložiště a že uživatel autorizující v ChatGPT k nim má přístup.
Doručování webhooků selhává: ověřte, že adresa URL webhooku a tajný klíč webhooku odpovídají hodnotám z ChatGPT, ponechte ověření SSL zapnuté a ujistěte se, že hostitel GitHub Enterprise může dosáhnout na
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.