OpenAI
Ova stranica je mašinski prevedena. Pogledaj originalni članak na engleskom jeziku.

Postavite predložak GitHub Enterprise aplikacije u ChatGPT-u

Saznajte kako administratori radnog prostora mogu konfigurisati predložak GitHub Enterprise aplikacije u ChatGPT-u pomoću GitHub App svoje organizacije.

Ažurirano: 6 days ago

Pregled

Koristite ovaj vodič ako ste administrator ChatGPT radnog prostora i postavljate GitHub predložak Enterprise aplikacije za svoju organizaciju. Predložak nije konačna aplikacija koju članovi koriste. To je tok postavljanja koji kreira nacrtnu aplikaciju specifičnu za radni prostor nakon što unesete potrebnu GitHub Enterprise konfiguraciju.

Za GitHub Enterprise, postavljanje povezuje ChatGPT s GitHub Enterprise hostom vaše organizacije. Kreirate GitHub App, registrujete ChatGPT URL za povratni poziv, generišete akreditive, a zatim zalijepite te vrijednosti u tok postavljanja ChatGPT predloška. Nakon što ChatGPT kreira nacrtnu aplikaciju, možete je objaviti i upravljati njome kao drugim aplikacijama radnog prostora.

Šta postavljate

Kreirate GitHub Enterprise aplikaciju specifičnu za radni prostor u ChatGPT-u. Aplikacija koristi:

  • GitHub App registrovanu na vašem GitHub Enterprise hostu.

  • ID klijenta i tajnu klijenta za GitHub App za OAuth autorizaciju korisnika.

  • Privatni ključ za GitHub App kako bi ChatGPT mogao izdavati instalacijske tokene za operacije s repozitorijima.

  • Tajnu webhooka i URL webhooka kako bi GitHub Enterprise mogao slati događaje instalacije i repozitorija nazad u ChatGPT.

  • Naziv hosta za GitHub Enterprise, kao što je github.example.com.

Kreirajte GitHub App, a ne samostalnu GitHub OAuth aplikaciju. Postavljanje ChatGPT predloška zahtijeva akreditive za GitHub App, privatni ključ i postavke webhooka.

Prije nego što počnete

Potrebno vam je:

  • Administratorski ili vlasnički pristup ChatGPT radnom prostoru.

  • Administratorski ili vlasnički pristup GitHub Enterprise organizaciji koji može kreirati i instalirati GitHub Apps.

  • Samo naziv hosta za GitHub Enterprise, bez https:// ili putanje.

  • Odluka o tome koje radnje repozitorija ChatGPT treba podržavati, kao što su pretraga repozitorija samo za čitanje, tokovi rada zahtjeva za spajanje, tokovi rada problema, uređivanje datoteka, GitHub Actions ili širi Codex tokovi rada.

  • Sigurno mjesto za rukovanje privatnim ključem i tajnom klijenta za GitHub App.

Držite ChatGPT i GitHub Enterprise otvorene u odvojenim karticama. Nemojte izmišljati URL za povratni poziv. Kopirajte tačan URL za povratni poziv prikazan u ChatGPT-u.

Vrijednosti za pripremu

  • Naziv hosta za GitHub Enterprise: na primjer, github.example.com.

  • URL za povratni poziv: kopirajte ga iz toka postavljanja ChatGPT predloška.

  • ID klijenta za GitHub App.

  • Tajna klijenta za GitHub App.

  • PEM privatnog ključa za GitHub App.

  • Tajna webhooka koju generiše ChatGPT.

  • URL webhooka generisan nakon kreiranja nacrtne aplikacije u ChatGPT-u.

Pokrenite postavljanje predloška u ChatGPT-u

  1. U ChatGPT-u se prebacite na radni prostor u kojem aplikacija treba biti dostupna.

  2. Otvorite Postavke radnog prostora > Aplikacije.

  3. Odaberite Direktorij.

  4. Potražite GitHub Enterprise.

  5. Odaberite predložak aplikacije GitHub Enterprise i pokrenite postavljanje.

  6. Unesite jasan naziv i opis aplikacije, kao što je GitHub Enterprise ili GitHub Enterprise - Engineering.

  7. Unesite naziv hosta za GitHub Enterprise, kao što je github.example.com.

  8. Kopirajte URL za povratni poziv prikazan u ChatGPT-u. Ostavite ovu karticu otvorenom.

  9. Kopirajte generisanu tajnu webhooka ako je prikazana tokom postavljanja.

Primjer URL-a za povratni poziv: https://chatgpt.com/connector/oauth/<callback_id>

Nemojte uklanjati ID povratnog poziva, dodavati završnu kosu crtu niti ga zamijeniti generičkim ChatGPT URL-om.

Kreirajte GitHub App u GitHub Enterpriseu

  1. Otvorite svoj GitHub Enterprise host, kao što je https://github.example.com.

  2. Idite na organizaciju ili račun koji treba biti vlasnik aplikacije.

  3. Otvorite Postavke > Postavke za programere > GitHub Apps.

  4. Odaberite Nova GitHub App.

  5. Unesite jasan naziv aplikacije, kao što je ChatGPT GitHub Enterprise Connector.

  6. Unesite URL početne stranice. Ako ne postoji posebna interna stranica, koristite URL GitHub Enterprise organizacije.

  7. U polje URL za povratni poziv zalijepite tačan URL za povratni poziv kopiran iz ChatGPT-a.

  8. Ostavite opciju isteka tokena za autorizaciju korisnika omogućenom, osim ako vaš sigurnosni tim ima konkretan razlog da je promijeni.

  9. Omogućite traženje autorizacije korisnika tokom instalacije kako bi korisnici mogli autorizovati aplikaciju tokom instalacije ili toka povezivanja.

  10. Pod opcijom Gdje se ova GitHub App može instalirati?, odaberite najužu opciju koja odgovara vašem uvođenju.

  11. Kreirajte GitHub App.

Konfigurišite dozvole i događaje

Odaberite minimalne dozvole potrebne za ChatGPT radnje koje planirate omogućiti.

Za otkrivanje repozitorija samo za čitanje i pitanja i odgovore počnite s dozvolama za čitanje kao što su:

  • Metapodaci: samo za čitanje. GitHub zahtijeva metapodatke za GitHub Apps.

  • Sadržaj: samo za čitanje, za pristup sadržaju datoteka i repozitorija.

  • Problemi: samo za čitanje, ako je potrebno pretraživanje ili čitanje problema.

  • Zahtjevi za spajanje: samo za čitanje, ako je potrebno pretraživanje zahtjeva za spajanje ili kontekst pregleda.

  • Radnje: samo za čitanje, ako su potrebni statusi pokretanja tokova rada, poslovi, zapisnici ili artefakti.

Za tokove rada s pisanjem dodajte dozvole za pisanje samo gdje je potrebno, kao što su Sadržaj, Zahtjevi za spajanje, Problemi, Radnje ili Tokovi rada. Koristite najuže dozvole koje podržavaju predviđene ChatGPT radnje.

Događaji webhooka trebaju odgovarati tokovima rada koje podržavate. Uobičajeni događaji uključuju instalaciju, instalacijske repozitorije, push, zahtjev za spajanje, probleme, komentar na problem, pokretanje toka rada i posao toka rada.

Generišite i kopirajte akreditive za GitHub App

  1. U postavkama GitHub App kopirajte ID klijenta.

  2. Generišite tajnu klijenta i odmah je kopirajte.

  3. Pod Privatni ključevi generišite privatni ključ.

  4. Preuzmite .pem datoteku i sigurno je pohranite.

  5. Otvorite .pem datoteku lokalno i kopirajte cijeli PEM tekst, uključujući početne i završne redove.

Privatni ključ je osjetljiv. Tretirajte ga kao akreditiv. Ako bude izložen, generišite novi privatni ključ, ažurirajte postavljanje aplikacije u ChatGPT-u i izbrišite kompromitovani ključ u GitHub Enterpriseu.

Završite postavljanje u ChatGPT-u

  1. Vratite se na karticu za postavljanje ChatGPT predloška.

  2. Zalijepite ID klijenta za GitHub App u ID OAuth klijenta.

  3. Zalijepite tajnu klijenta za GitHub App u Tajna OAuth klijenta.

  4. Ostavite Opsege nepromijenjenim, osim ako vaša organizacija namjerno mora nadjačati zadane vrijednosti predloška.

  5. Potvrdite da je naziv hosta za GitHub Enterprise samo naziv hosta, kao što je github.example.com.

  6. Zalijepite ili otpremite PEM privatnog ključa za GitHub App u privatni ključ za GitHub App.

  7. Potvrdite da je generisana tajna webhooka prisutna.

  8. Kreirajte nacrt aplikacije.

  9. Otvorite detalje kreirane nacrtne aplikacije u ChatGPT-u i kopirajte generisani URL webhooka.

URL webhooka treba izgledati ovako: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Završite postavljanje webhooka u GitHub Enterpriseu

  1. Vratite se na postavke GitHub App u GitHub Enterpriseu.

  2. Otvorite opće postavke za GitHub App.

  3. Omogućite aktivne webhookove ako već nisu omogućeni.

  4. Zalijepite ChatGPT URL webhooka u URL webhooka.

  5. Zalijepite ChatGPT tajnu webhooka u tajnu webhooka.

  6. Ostavite SSL provjeru omogućenom.

  7. Potvrdite da pretplaćeni događaji webhooka odgovaraju dozvolama i radnjama koje ste omogućili.

  8. Sačuvajte promjene.

Objavite i upravljajte aplikacijom u ChatGPT-u

Kreiranje nacrtne aplikacije ne čini je automatski dostupnom članovima. Nakon pregleda nacrta:

  1. Objavite nacrtnu aplikaciju.

  2. Potvrdite da se aplikacija pojavljuje u Postavke radnog prostora > Aplikacije > Omogućeno.

  3. Konfigurišite Korisnički pristup za uloge koje je trebaju koristiti.

  4. Pregledajte Kontrolu radnji za radnje čitanja i pisanja.

  5. Pregledajte Dozvole aplikacije da odaberete kada ChatGPT pita članove prije korištenja aplikacije.

  6. Zamolite dozvoljenog testnog korisnika da otvori Aplikacije u ChatGPT-u i potvrdi da se aplikacija pojavljuje.

Ove dozvole aplikacije primjenjuju se na ChatGPT razgovore. Agenti radnog prostora koriste kontrole po agentu koje postavlja graditelj agenta kako bi odredili koje su radnje aplikacije dostupne i kada se od krajnjih korisnika traži da ih odobre. Za ponašanje agenta pogledajte: ChatGPT Workspace Agents za Enterprise i Business.

Instalirajte i testirajte GitHub App

  1. U GitHub Enterpriseu instalirajte GitHub aplikaciju na organizaciju ili račun.

  2. Odaberite sve repozitorije ili odabrane repozitorije prema politici radnog prostora.

  3. Pokrenite tok povezivanja iz ChatGPT-a kao dozvoljeni korisnik.

  4. Autorizujte GitHub aplikaciju kada se to zatraži.

  5. Prvo pokrenite malu radnju čitanja, kao što je navođenje dostupnih repozitorija ili dohvaćanje poznatog zahtjeva za spajanje.

  6. Ako su omogućene radnje pisanja, testirajte ih na repozitoriju niskog rizika prije šireg uvođenja.

Naziv hosta i OAuth ponašanje

ChatGPT koristi naziv hosta za izvođenje krajnjih tačaka za GitHub Enterprise. Unesite samo host, kao što je github.example.com ili octocorp.ghe.com.

Nemojte unositi API putanju, putanju repozitorija ili github.com osim ako je to tačan GitHub Enterprise host za ovu aplikaciju.

Rješavanje problema

  • Nepodudaranje URI-ja za preusmjeravanje: potvrdite da se URL za povratni poziv za GitHub App tačno podudara s URL-om za povratni poziv prikazanim u ChatGPT-u.

  • ChatGPT ne može kreirati ili sačuvati nacrtnu aplikaciju: potvrdite da su prisutna sva obavezna polja, uključujući naziv hosta, ID OAuth klijenta, tajnu OAuth klijenta, privatni ključ i tajnu webhooka.

  • Autentifikacija uspijeva, ali pozivi repozitorija ne uspijevaju: potvrdite da je GitHub App instalirana i da ima pristup repozitoriju.

  • API vraća 403 ili nedovoljne dozvole: dodajte nedostajuću dozvolu za GitHub App i neka vlasnik instalacije odobri ažurirane dozvole ako se to zatraži.

  • Repozitoriji se ne pojavljuju: potvrdite da instalacija aplikacije uključuje očekivane repozitorije i da korisnik koji autorizuje u ChatGPT-u ima pristup njima.

  • Isporuke webhooka ne uspijevaju: potvrdite da se URL webhooka i tajna webhooka podudaraju s vrijednostima iz ChatGPT-a, ostavite SSL provjeru omogućenom i provjerite da GitHub Enterprise host može dosegnuti connectors.api.openai.org.

  • Greške privatnog ključa: potvrdite da je kopiran cijeli PEM sadržaj, uključujući početne i završne redove.

Reference

Da li je ovaj članak bio koristan?