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

Pregled

Koristite ovaj vodič ako ste administrator radnog prostora u ChatGPT-u i postavljate predložak aplikacije GitHub Enterprise za svoju organizaciju. Predložak nije konačna aplikacija koju članovi koriste. To je postupak postavljanja koji kreira nacrt aplikacije za određeni radni prostor nakon što unesete potrebnu konfiguraciju za GitHub Enterprise.

Za GitHub Enterprise, postupak postavljanja povezuje ChatGPT s GitHub Enterprise hostom vaše organizacije. Kreirate GitHub aplikaciju, registrirate URL povratnog poziva za ChatGPT, generirate pristupne podatke, a zatim te vrijednosti zalijepite u postupku postavljanja predloška u ChatGPT-u. Nakon što ChatGPT kreira nacrt aplikacije, možete je objaviti i njome upravljati kao i drugim aplikacijama u radnom prostoru.

Za navigaciju radnim prostorom i pristup aplikacijama pogledajte: Administratorske kontrole, sigurnost i usklađenost za dodatke i aplikacije.

Šta postavljate

Kreirate aplikaciju GitHub Enterprise u ChatGPT-u za određeni radni prostor. Aplikacija koristi:

GitHub aplikaciju registriranu na vašem GitHub Enterprise hostu.
ID klijenta i tajni ključ klijenta GitHub aplikacije za OAuth autorizaciju korisnika.
Privatni ključ GitHub aplikacije kako bi ChatGPT mogao generirati instalacijske tokene za operacije nad repozitorijima.
Tajni ključ i URL webhooka kako bi GitHub Enterprise mogao slati događaje vezane za instalaciju i repozitorije nazad u ChatGPT.
Vaš naziv hosta za GitHub Enterprise, naprimjer github.example.com.

Kreirajte GitHub aplikaciju, a ne samostalnu GitHub OAuth aplikaciju. Za postavljanje predloška u ChatGPT-u potrebni su pristupni podaci GitHub aplikacije, privatni ključ i postavke webhooka.

Prije nego što počnete

Potrebno vam je:

Pristup s ulogom administratora ili vlasnika radnog prostora u ChatGPT-u.
Pristup s ulogom administratora GitHub Enterprisea ili vlasnika organizacije koji omogućava kreiranje i instaliranje GitHub aplikacija.
Samo naziv hosta za GitHub Enterprise, bez https:// ili putanje.
Odluka o tome koje radnje nad repozitorijima ChatGPT treba podržavati, naprimjer pretragu repozitorija samo za čitanje, radne tokove za pull request zahtjeve, radne tokove za prijave problema, uređivanje datoteka, GitHub Actions ili šire radne tokove uz Codex.
Sigurno mjesto za rukovanje privatnim ključem i tajnim ključem klijenta GitHub aplikacije.

Držite ChatGPT i GitHub Enterprise otvorene u zasebnim karticama. Nemojte sami izmišljati URL povratnog poziva. Kopirajte tačan URL povratnog poziva prikazan u ChatGPT-u.

Vrijednosti koje treba pripremiti

Naziv hosta za GitHub Enterprise: naprimjer github.example.com.
URL povratnog poziva: kopirajte ga iz postupka postavljanja predloška u ChatGPT-u.
ID klijenta GitHub aplikacije.
Tajni ključ klijenta GitHub aplikacije.
Privatni ključ GitHub aplikacije u PEM formatu.
Tajni ključ za webhook koji generira ChatGPT.
URL webhooka generiran nakon kreiranja nacrta aplikacije u ChatGPT-u.

Započnite postavljanje predloška u ChatGPT-u

U ChatGPT-u pređite u radni prostor u kojem aplikacija treba biti dostupna.
Otvorite Postavke radnog prostora > Aplikacije. Možete otvoriti i Administratorsku konzolu, odabrati željeni radni prostor u ChatGPT-u i otvoriti Dodatke. Odaberite Upravljanje starim aplikacijama da otvorite zadržanu stranicu Aplikacije.
Odaberite Katalog.
Potražite GitHub Enterprise.
Odaberite predložak aplikacije GitHub Enterprise i započnite postavljanje.
Unesite jasan naziv i opis aplikacije, naprimjer GitHub Enterprise ili GitHub Enterprise – Razvojni tim.
Unesite naziv hosta za GitHub Enterprise, naprimjer github.example.com.
Kopirajte URL povratnog poziva prikazan u ChatGPT-u. Ostavite ovu karticu otvorenom.
Kopirajte generirani tajni ključ za webhook ako se prikaže tokom postavljanja.

Primjer URL-a povratnog poziva: https://chatgpt.com/connector/oauth/<callback_id>

Nemojte uklanjati ID povratnog poziva, dodavati kosu crtu na kraju niti ga zamijeniti generičkim URL-om za ChatGPT.

Kreirajte GitHub aplikaciju u GitHub Enterpriseu

Otvorite svoj GitHub Enterprise host, naprimjer https://github.example.com.
Otvorite organizaciju ili račun koji treba biti vlasnik aplikacije.
Otvorite Postavke > Postavke za razvojne programere > GitHub aplikacije.
Odaberite Nova GitHub aplikacija.
Unesite jasan naziv aplikacije, naprimjer ChatGPT konektor za GitHub Enterprise.
Unesite URL početne stranice. Ako ne postoji namjenska interna stranica, koristite URL organizacije u GitHub Enterpriseu.
U polje URL povratnog poziva zalijepite tačan URL povratnog poziva kopiran iz ChatGPT-a.
Ostavite opciju Istek tokena za autorizaciju korisnika uključenom, osim ako vaš sigurnosni tim ima konkretan razlog da je promijeni.
Uključite opciju Zatraži autorizaciju korisnika tokom instalacije kako bi korisnici mogli autorizirati aplikaciju tokom instalacije ili povezivanja.
U odjeljku Gdje se ova GitHub aplikacija može instalirati?, odaberite najužu opciju koja odgovara vašem planu uvođenja.
Kreirajte GitHub aplikaciju.

Konfigurirajte dozvole i događaje

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

Za pronalaženje repozitorija i odgovaranje na pitanja bez izmjena podataka počnite s dozvolama za čitanje kao što su:

Metapodaci: samo za čitanje. GitHub zahtijeva pristup metapodacima za GitHub aplikacije.
Sadržaj: samo za čitanje, za pristup datotekama i sadržaju repozitorija.
Prijave problema: samo za čitanje, ako je potrebno pretraživati ili čitati prijave problema.
Pull requests: samo za čitanje, ako je potrebno pretraživati pull request zahtjeve ili pristupiti kontekstu za pregled.
Radnje: samo za čitanje, ako su potrebni status izvršavanja radnog toka, poslovi, zapisnici ili artefakti.

Za radne tokove koji upisuju podatke dodajte dozvole za pisanje samo gdje je potrebno, naprimjer za Sadržaj, Pull requests, Prijave problema, Radnje ili Radne tokove. Koristite najuže dozvole koje omogućavaju predviđene radnje u ChatGPT-u.

Webhook događaji trebaju odgovarati radnim tokovima koje podržavate. Uobičajeni događaji uključuju Instalaciju, Repozitorije instalacije, Slanje izmjena, Pull request, Prijave problema, Komentar na prijavu problema, Izvršavanje radnog toka i Posao radnog toka.

Generirajte i kopirajte pristupne podatke GitHub aplikacije

U postavkama GitHub aplikacije kopirajte ID klijenta.
Generirajte Tajni ključ klijenta i odmah ga kopirajte.
U odjeljku Privatni ključevi generirajte privatni ključ.
Preuzmite .pem datoteku i pohranite je na sigurno mjesto.
Otvorite .pem datoteku lokalno i kopirajte cijeli PEM tekst, uključujući početni i završni red.

Privatni ključ je osjetljiv podatak. Postupajte s njim kao s pristupnim podatkom. Ako bude otkriven, generirajte novi privatni ključ, ažurirajte postavke aplikacije u ChatGPT-u i izbrišite kompromitirani ključ u GitHub Enterpriseu.

Dovršite postavljanje u ChatGPT-u

Vratite se na karticu za postavljanje predloška u ChatGPT-u.
Zalijepite ID klijenta GitHub aplikacije u polje ID OAuth klijenta.
Zalijepite tajni ključ klijenta GitHub aplikacije u polje Tajni ključ OAuth klijenta.
Ostavite Opsege nepromijenjene, osim ako vaša organizacija ima konkretnu potrebu da promijeni zadane postavke predloška.
Provjerite da je za GitHub Enterprise unesen samo naziv hosta, naprimjer github.example.com.
Zalijepite ili učitajte privatni ključ GitHub aplikacije u PEM formatu u polje Privatni ključ GitHub aplikacije.
Provjerite je li generirani tajni ključ za webhook prisutan.
Kreirajte nacrt aplikacije.
Otvorite detalje kreiranog nacrta aplikacije u ChatGPT-u i kopirajte generirani URL webhooka.

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

Dovršite postavljanje webhooka u GitHub Enterpriseu

Vratite se na postavke GitHub aplikacije u GitHub Enterpriseu.
Otvorite Opće postavke GitHub aplikacije.
Uključite opciju Aktivni webhookovi ako već nije uključena.
Zalijepite URL webhooka iz ChatGPT-a u polje URL webhooka.
Zalijepite tajni ključ za webhook iz ChatGPT-a u polje Tajni ključ za webhook.
Ostavite SSL provjeru uključenom.
Provjerite odgovaraju li webhook događaji na koje ste pretplaćeni dozvolama i radnjama koje ste omogućili.
Sačuvajte izmjene.

Objavite aplikaciju i upravljajte njome u ChatGPT-u

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

Objavite nacrt aplikacije.
U Postavkama radnog prostora otvorite stranicu Aplikacije, zatim Omogućene i provjerite prikazuje li se aplikacija. Stranicu Aplikacije možete otvoriti i putem opcije Upravljanje starim aplikacijama u odjeljku Administratorska konzola > Dodaci.
Konfigurirajte Korisnički pristup za uloge koje trebaju koristiti aplikaciju.
Pregledajte Kontrolu radnji za radnje čitanja i pisanja.
Pregledajte Dozvole aplikacije da odaberete kada ChatGPT traži odobrenje članova prije korištenja aplikacije.
Zamolite testnog korisnika s dozvoljenim pristupom da otvori Aplikacije u ChatGPT-u i provjeri prikazuje li se aplikacija.

Ove dozvole aplikacije primjenjuju se na razgovore u ChatGPT-u. Agenti radnog prostora koriste pojedinačne kontrole koje postavlja kreator svakog agenta kako bi odredio koje su radnje aplikacije dostupne i kada se od krajnjih korisnika traži da ih odobre. Za informacije o ponašanju agenata pogledajte: Agenti radnog prostora u ChatGPT-u za Enterprise i Business.

Instalirajte i testirajte GitHub aplikaciju

U GitHub Enterpriseu instalirajte GitHub aplikaciju za organizaciju ili račun.
Odaberite sve repozitorije ili samo određene repozitorije u skladu s pravilima radnog prostora.
Pokrenite postupak povezivanja iz ChatGPT-a kao korisnik s dozvoljenim pristupom.
Autorizirajte GitHub aplikaciju kada se to zatraži.
Prvo pokrenite jednostavnu radnju čitanja, naprimjer prikaz liste dostupnih repozitorija ili dohvaćanje poznatog pull request zahtjeva.
Ako su radnje pisanja omogućene, testirajte ih na repozitoriju niskog rizika prije šire primjene.

Naziv hosta i način rada OAutha

ChatGPT koristi naziv hosta za određivanje krajnjih tačaka za GitHub Enterprise. Unesite samo naziv hosta, naprimjer github.example.com ili octocorp.ghe.com.

Nemojte unositi putanju API-ja, putanju repozitorija niti github.com, osim ako je to upravo GitHub Enterprise host za ovu aplikaciju.

Rješavanje problema

URI za preusmjeravanje se ne podudara: provjerite da li se URL povratnog poziva GitHub aplikacije potpuno podudara s URL-om povratnog poziva prikazanim u ChatGPT-u.
ChatGPT ne može kreirati ili sačuvati nacrt aplikacije: provjerite jesu li sva obavezna polja popunjena, uključujući naziv hosta, ID OAuth klijenta, Tajni ključ OAuth klijenta, privatni ključ i tajni ključ za webhook.
Autentifikacija uspijeva, ali pozivi repozitoriju ne uspijevaju: provjerite je li GitHub aplikacija instalirana i ima li pristup repozitoriju.
API vraća grešku 403 ili poruku o nedovoljnim dozvolama: dodajte dozvolu koja nedostaje GitHub aplikaciji i zamolite vlasnika instalacije da odobri ažurirane dozvole ako se to zatraži.
Repozitoriji se ne prikazuju: provjerite da li instalacija aplikacije obuhvata očekivane repozitorije i ima li korisnik koji daje autorizaciju u ChatGPT-u pristup tim repozitorijima.
Isporuka webhooka ne uspijeva: provjerite podudaraju li se URL i tajni ključ webhooka s vrijednostima iz ChatGPT-a, ostavite SSL provjeru uključenom i provjerite može li GitHub Enterprise host pristupiti adresi connectors.api.openai.org.
Greške privatnog ključa: provjerite je li kopiran cijeli PEM sadržaj, uključujući početni i završni red.

Postavite predložak GitHub Enterprise aplikacije u ChatGPT-u