Översikt
Använd den här guiden om du är administratör för en ChatGPT-arbetsyta och ska konfigurera appmallen för GitHub Enterprise för din organisation. En mall är inte den färdiga app som medlemmarna använder. Det är ett konfigurationsflöde som skapar ett apputkast för en viss arbetsyta när du har angett de GitHub Enterprise-inställningar som krävs.
För GitHub Enterprise ansluter konfigurationen ChatGPT till organisationens GitHub Enterprise-värd. Du skapar en GitHub App, registrerar ChatGPT:s återanrops-URL, genererar autentiseringsuppgifter och klistrar sedan in dessa värden i flödet för mallkonfiguration i ChatGPT. När ChatGPT har skapat apputkastet kan du publicera och hantera det precis som andra appar i arbetsytan.
Information om navigering i arbetsytan och appåtkomst finns i: Administratörskontroller, säkerhet och efterlevnad för pluginprogram och appar.
Det här konfigurerar du
Du skapar en GitHub Enterprise-app för en viss arbetsyta i ChatGPT. Appen använder:
En GitHub App som är registrerad på din GitHub Enterprise-värd.
GitHub-appens klient-ID och klienthemlighet för användarauktorisering via OAuth.
GitHub-appens privata nyckel så att ChatGPT kan utfärda installationstoken för åtgärder i förvar.
En webhook-hemlighet och en webhook-URL så att GitHub Enterprise kan skicka installations- och förvarshändelser tillbaka till ChatGPT.
Ditt GitHub Enterprise-värdnamn, till exempel
github.example.com.
Skapa en GitHub App, inte en fristående GitHub OAuth App. Mallkonfigurationen i ChatGPT kräver autentiseringsuppgifter för en GitHub App, en privat nyckel och webhook-inställningar.
Innan du börjar
Du behöver:
Administratörs- eller ägaråtkomst till ChatGPT-arbetsytan.
Åtkomst som GitHub Enterprise-administratör eller organisationsägare med behörighet att skapa och installera GitHub Apps.
Enbart värdnamnet för GitHub Enterprise, utan
https://eller någon sökväg.Ett beslut om vilka förvarsåtgärder ChatGPT ska stödja, till exempel förvarssökning med enbart läsåtkomst, arbetsflöden för pull requests och ärenden, filredigering, GitHub Actions eller mer omfattande Codex-arbetsflöden.
En säker plats för att hantera GitHub-appens privata nyckel och klienthemlighet.
Ha ChatGPT och GitHub Enterprise öppna i separata flikar. Hitta inte på en egen återanrops-URL. Kopiera exakt den återanrops-URL som visas i ChatGPT.
Värden att förbereda
GitHub Enterprise-värdnamn: till exempel
github.example.com.Återanrops-URL: kopiera den från flödet för mallkonfiguration i ChatGPT.
GitHub-appens klient-ID.
GitHub-appens klienthemlighet.
GitHub-appens privata nyckel i PEM-format.
Webhook-hemlighet som genereras av ChatGPT.
Webhook-URL som genereras när apputkastet har skapats i ChatGPT.
Börja konfigurera mallen i ChatGPT
Byt till den arbetsyta i ChatGPT där appen ska vara tillgänglig.
Öppna Inställningar för arbetsytan > Appar. Du kan också gå till Administratörskonsolen, välja den avsedda ChatGPT-arbetsytan och öppna Pluginprogram. Välj Hantera äldre appar för att öppna den äldre sidan Appar som finns kvar.
Välj Katalog.
Sök efter GitHub Enterprise.
Välj appmallen för GitHub Enterprise och starta konfigurationen.
Ange ett tydligt appnamn och en beskrivning, till exempel GitHub Enterprise eller GitHub Enterprise – Utveckling.
Ange värdnamnet för GitHub Enterprise, till exempel
github.example.com.Kopiera den återanrops-URL som visas i ChatGPT. Låt den här fliken vara öppen.
Kopiera den genererade webhook-hemligheten om den visas under konfigurationen.
Exempel på återanrops-URL: https://chatgpt.com/connector/oauth/<callback_id>
Ta inte bort återanrops-ID:t, lägg inte till ett avslutande snedstreck och ersätt inte adressen med en generell ChatGPT-URL.
Skapa GitHub-appen i GitHub Enterprise
Öppna din GitHub Enterprise-server, till exempel
https://github.example.com.Gå till organisationen eller kontot som ska äga appen.
Öppna Inställningar > Utvecklarinställningar > GitHub-appar.
Välj Ny GitHub-app.
Ange ett tydligt appnamn, till exempel ChatGPT GitHub Enterprise.
Ange en URL till en startsida. Om det inte finns någon särskild intern sida använder du organisationens URL i GitHub Enterprise.
Klistra in den callback-URL som du kopierade från ChatGPT i fältet Callback-URL, utan att ändra den.
Låt inställningen Låt användarnas auktoriseringstoken löpa ut vara aktiverad, om inte ditt säkerhetsteam har ett särskilt skäl att ändra den.
Aktivera Begär användarauktorisering under installationen så att användarna kan auktorisera appen när de installerar eller ansluter den.
Under Var kan den här GitHub-appen installeras?, väljer du det mest begränsade alternativet som passar din utrullning.
Skapa GitHub-appen.
Konfigurera behörigheter och händelser
Välj endast de behörigheter som krävs för de ChatGPT-åtgärder du planerar att aktivera.
För att hitta förvar och besvara frågor utan att göra ändringar kan du börja med läsbehörigheter som:
Metadata: endast läsning. GitHub kräver metadataåtkomst för GitHub Apps.
Innehåll: endast läsning, för åtkomst till filer och förvarsinnehåll.
Ärenden: endast läsning, om det behövs stöd för att söka efter eller läsa ärenden.
Pull requests: endast läsning, om det behövs stöd för att söka efter pull requests eller hämta granskningsunderlag.
Åtgärder: endast läsning, om status för arbetsflödeskörningar, jobb, loggar eller artefakter behövs.
För arbetsflöden som gör ändringar lägger du bara till skrivbehörigheter där de behövs, till exempel för Innehåll, Pull requests, Ärenden, Åtgärder eller Arbetsflöden. Använd så begränsade behörigheter som möjligt för de avsedda ChatGPT-åtgärderna.
Webhook-händelserna ska motsvara de arbetsflöden som stöds. Vanliga händelser är Installation, Installationsförvar, Push, Pull request, Ärenden, Ärendekommentar, Arbetsflödeskörning och Arbetsflödesjobb.
Generera och kopiera GitHub-appens autentiseringsuppgifter
Kopiera Klient-ID i GitHub-appens inställningar.
Generera en Klienthemlighet och kopiera den direkt.
Generera en privat nyckel under Privata nycklar.
Ladda ner .pem-filen och förvara den säkert.
Öppna .pem-filen lokalt och kopiera hela PEM-texten, inklusive start- och slutraderna.
Den privata nyckeln är känslig information. Hantera den som en autentiseringsuppgift. Om den röjs ska du generera en ny privat nyckel, uppdatera appkonfigurationen i ChatGPT och radera den röjda nyckeln i GitHub Enterprise.
Slutför konfigurationen i ChatGPT
Gå tillbaka till fliken där du konfigurerar mallen i ChatGPT.
Klistra in GitHub-appens klient-ID i OAuth-klient-ID.
Klistra in GitHub-appens klienthemlighet i OAuth-klienthemlighet.
Låt Omfattningar vara oförändrade om inte organisationen har ett uttryckligt behov av att åsidosätta mallens standardvärden.
Kontrollera att värdnamnet för GitHub Enterprise endast innehåller själva värdnamnet, till exempel
github.example.com.Klistra in eller ladda upp GitHub-appens privata nyckel i PEM-format i Privat nyckel för GitHub App.
Kontrollera att den genererade webhook-hemligheten finns med.
Skapa apputkastet.
Öppna informationen om det skapade apputkastet i ChatGPT och kopiera den genererade webhook-URL:en.
Webhook-URL:en ska se ut så här: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Slutför webhook-konfigurationen i GitHub Enterprise
Gå tillbaka till GitHub-appens inställningar i GitHub Enterprise.
Öppna GitHub-appens allmänna inställningar.
Aktivera Aktiva webhooks om de inte redan är aktiverade.
Klistra in webhook-URL:en från ChatGPT i Webhook-URL.
Klistra in webhook-hemligheten från ChatGPT i Webhook-hemlighet.
Låt SSL-verifiering vara aktiverad.
Kontrollera att de webhook-händelser som prenumerationen omfattar motsvarar de behörigheter och åtgärder du har aktiverat.
Spara ändringarna.
Publicera och hantera appen i ChatGPT
Att skapa ett apputkast gör inte automatiskt appen tillgänglig för medlemmarna. När du har granskat utkastet:
Publicera apputkastet.
Öppna sidan Appar i arbetsytans inställningar, öppna Aktiverade och kontrollera att appen visas. Du kan också öppna sidan Appar via Hantera äldre appar i Administrationskonsolen > Insticksprogram.
I Enterprise och Edu använder du Användaråtkomst för att välja vilka roller som får använda appen. I Business hanterar du appens tillgänglighet för hela arbetsytan.
Granska Åtgärdskontroll för läs- och skrivåtgärder.
Granska Appbehörigheter för att välja när ChatGPT ska fråga medlemmarna innan appen används.
Be en testanvändare med åtkomst att öppna Appar i ChatGPT och kontrollera att appen visas.
Dessa appbehörigheter gäller för ChatGPT-konversationer. Arbetsyteagenter använder agentspecifika inställningar som anges av agentens skapare för att styra vilka appåtgärder som är tillgängliga och när slutanvändare ombeds att godkänna dem. Läs mer om hur agenter fungerar i Arbetsyteagenter i ChatGPT för Enterprise och Business.
Installera och testa GitHub-appen
Installera GitHub-appen för organisationen eller kontot i GitHub Enterprise.
Välj alla förvar eller utvalda förvar enligt arbetsytans policy.
Starta anslutningsflödet från ChatGPT som en användare med åtkomst.
Auktorisera GitHub-appen när du blir ombedd.
Börja med en enkel läsåtgärd, till exempel att lista tillgängliga förvar eller hämta en känd pull request.
Om skrivåtgärder är aktiverade bör du testa i ett förvar där risken är låg innan appen införs i större skala.
Värdnamn och hur OAuth fungerar
ChatGPT använder värdnamnet för att härleda GitHub Enterprise-slutpunkter. Ange endast värdnamnet, till exempel github.example.com eller octocorp.ghe.com.
Ange inte en API-sökväg, en förvarssökväg eller github.com om det inte är den exakta GitHub Enterprise-värden för den här appen.
Felsökning
Omdirigerings-URI:n stämmer inte: kontrollera att GitHub-appens återanrops-URL exakt matchar den återanrops-URL som visas i ChatGPT.
ChatGPT kan inte skapa eller spara apputkastet: kontrollera att alla obligatoriska fält är ifyllda, inklusive värdnamn, OAuth-klient-ID, OAuth-klienthemlighet, privat nyckel och webhook-hemlighet.
Autentiseringen lyckas men anrop till förvar misslyckas: kontrollera att GitHub-appen är installerad och har åtkomst till förvaret.
API:et returnerar 403 eller otillräckliga behörigheter: lägg till den GitHub App-behörighet som saknas och låt installationens ägare godkänna de uppdaterade behörigheterna om detta efterfrågas.
Inga förvar visas: kontrollera att appinstallationen omfattar de förväntade förvaren och att användaren som auktoriserar appen i ChatGPT har åtkomst till dem.
Webhook-leveranser misslyckas: kontrollera att webhook-URL:en och webhook-hemligheten matchar värdena från ChatGPT, låt SSL-verifiering vara aktiverad och se till att GitHub Enterprise-värden kan nå
connectors.api.openai.org.Fel med privat nyckel: kontrollera att hela PEM-innehållet kopierades, inklusive start- och slutraderna.