Pregled
Ovaj je vodič namijenjen administratorima radnog prostora u ChatGPT-u koji postavljaju predložak aplikacije Enterprise za svoju organizaciju na platformi GitHub. Predložak nije konačna aplikacija kojom se članovi koriste. To je postupak postavljanja kojim se izrađuje nacrt aplikacije za određeni radni prostor nakon što unesete potrebne konfiguracijske podatke za GitHub Enterprise.
Za GitHub Enterprise postupak postavljanja povezuje ChatGPT s glavnim računalom sustava GitHub Enterprise vaše organizacije. Izradite aplikaciju GitHub, registrirajte URL povratnog poziva za ChatGPT, generirajte vjerodajnice, a zatim te vrijednosti zalijepite u postupku postavljanja predloška u ChatGPT-u. Nakon što ChatGPT izradi nacrt aplikacije, možete ga objaviti i njime upravljati kao i drugim aplikacijama radnog prostora.
Za informacije o navigaciji radnim prostorom i pristupu aplikacijama pogledajte: Administratorske kontrole, sigurnost i usklađenost za dodatke i aplikacije.
Što postavljate
U ChatGPT-u izrađujete aplikaciju GitHub Enterprise za određeni radni prostor. Aplikacija upotrebljava:
Aplikaciju GitHub registriranu na vašem glavnom računalu sustava GitHub Enterprise.
ID klijenta i tajni ključ klijenta aplikacije GitHub za autorizaciju korisnika putem otvorenog ovlaštenja.
Privatni ključ aplikacije GitHub kako bi ChatGPT mogao generirati instalacijske tokene za operacije s repozitorijima.
Tajni ključ i URL webhooka kako bi GitHub Enterprise mogao slati događaje vezane uz instalaciju i repozitorije natrag u ChatGPT.
Naziv vašeg glavnog računala za GitHub Enterprise, primjerice
github.example.com.
Izradite aplikaciju GitHub, a ne samostalnu aplikaciju GitHub za otvoreno ovlaštenje. Za postavljanje predloška u ChatGPT-u potrebne su vjerodajnice aplikacije GitHub, privatni ključ i postavke webhooka.
Prije početka
Potrebno vam je:
Pristup s ovlastima administratora ili vlasnika radnog prostora u ChatGPT-u.
Pristup s ovlastima administratora sustava GitHub Enterprise ili vlasnika organizacije koji može izrađivati i instalirati aplikacije GitHub.
Samo naziv glavnog računala za GitHub Enterprise, bez
https://ili putanje.Odluka o tome koje radnje s repozitorijima ChatGPT treba podržavati, primjerice pretraživanje repozitorija samo za čitanje, tijekove rada za pull request i prijavljene probleme, uređivanje datoteka, GitHub Actions ili šire tijekove rada u Codexu.
Sigurno mjesto za rukovanje privatnim ključem i tajnim ključem klijenta aplikacije GitHub.
Ostavite ChatGPT i GitHub Enterprise otvorenima u zasebnim karticama. Nemojte sami sastavljati URL povratnog poziva. Kopirajte točan URL povratnog poziva prikazan u ChatGPT-u.
Vrijednosti koje treba pripremiti
Naziv glavnog računala za GitHub Enterprise: primjerice
github.example.com.URL povratnog poziva: kopirajte ga iz postupka postavljanja predloška u ChatGPT-u.
ID klijenta aplikacije GitHub.
Tajni ključ klijenta aplikacije GitHub.
Privatni ključ aplikacije GitHub u formatu PEM.
Tajni ključ webhooka koji je generirao ChatGPT.
URL webhooka generiran nakon izrade nacrta aplikacije u ChatGPT-u.
Pokrenite postavljanje predloška u ChatGPT-u
U ChatGPT-u prijeđite u radni prostor u kojem aplikacija treba biti dostupna.
Otvorite Postavke radnog prostora > Aplikacije. Možete i otvoriti Administratorsku konzolu, odabrati željeni radni prostor u ChatGPT-u i otvoriti Dodatke. Odaberite Upravljanje naslijeđenim aplikacijama da biste otvorili zadržanu stranicu Aplikacije.
Odaberite Katalog.
Potražite GitHub Enterprise.
Odaberite predložak aplikacije GitHub Enterprise i pokrenite postavljanje.
Unesite jasan naziv i opis aplikacije, primjerice GitHub Enterprise ili GitHub Enterprise – Razvoj.
Unesite naziv glavnog računala za GitHub Enterprise, primjerice
github.example.com.Kopirajte URL povratnog poziva prikazan u ChatGPT-u. Ostavite ovu karticu otvorenom.
Kopirajte generirani tajni ključ webhooka ako se prikaže tijekom postavljanja.
Primjer URL-a povratnog poziva: https://chatgpt.com/connector/oauth/<callback_id>
Nemojte uklanjati ID povratnog poziva, dodavati završnu kosu crtu ni zamijeniti URL generičkim URL-om za ChatGPT.
Izradite aplikaciju GitHub u sustavu GitHub Enterprise
Otvorite svoje glavno računalo sustava GitHub Enterprise, primjerice
https://github.example.com.Otvorite organizaciju ili račun koji treba biti vlasnik aplikacije.
Otvorite Postavke > Postavke za razvojne programere > Aplikacije GitHub.
Odaberite Nova aplikacija GitHub.
Unesite jasan naziv aplikacije, primjerice Poveznik za ChatGPT i GitHub Enterprise.
Unesite URL početne stranice. Ako ne postoji namjenska interna stranica, upotrijebite URL organizacije u sustavu GitHub Enterprise.
U polje URL povratnog poziva zalijepite točan URL povratnog poziva kopiran iz ChatGPT-a.
Ostavite opciju Istek tokena za autorizaciju korisnika uključenom osim ako vaš sigurnosni tim ima poseban razlog za promjenu.
Uključite opciju Zatraži autorizaciju korisnika tijekom instalacije kako bi korisnici mogli autorizirati aplikaciju tijekom instalacije ili povezivanja.
U odjeljku Gdje se ova aplikacija GitHub može instalirati?, odaberite najužu opciju koja odgovara vašem planu uvođenja.
Izradite aplikaciju GitHub.
Konfigurirajte dozvole i događaje
Odaberite najmanji skup dozvola potreban za radnje koje planirate omogućiti u ChatGPT-u.
Za pronalaženje repozitorija i odgovaranje na pitanja uz pristup samo za čitanje počnite s dozvolama za čitanje kao što su:
Metapodaci: samo za čitanje. GitHub zahtijeva pristup metapodacima za aplikacije GitHub.
Sadržaj: samo za čitanje, za pristup datotekama i sadržaju repozitorija.
Problemi: samo za čitanje, ako je potrebno pretraživati ili čitati prijavljene probleme.
Pull requests: samo za čitanje, ako je potrebno pretraživati stavke pull request ili pristupiti kontekstu za pregled.
Radnje: samo za čitanje, ako su potrebni status izvođenja tijeka rada, poslovi, zapisnici ili artefakti.
Za tijekove rada koji uključuju pisanje dodajte dozvole za pisanje samo gdje su potrebne, primjerice za Sadržaj, Pull requests, Probleme, Radnje ili Tijekove rada. Upotrijebite najuži skup dozvola koji omogućuje predviđene radnje u ChatGPT-u.
Događaji webhooka trebaju odgovarati tijekovima rada koje podržavate. Uobičajeni događaji uključuju Instalaciju, Repozitorije instalacije, Slanje promjena, Pull request, Probleme, Komentar problema, Izvođenje tijeka rada i Posao tijeka rada.
Generirajte i kopirajte vjerodajnice aplikacije GitHub
U postavkama aplikacije GitHub kopirajte ID klijenta.
Generirajte Tajni ključ klijenta i odmah ga kopirajte.
U odjeljku Privatni ključevi generirajte privatni ključ.
Preuzmite datoteku .pem i pohranite je na sigurno.
Otvorite datoteku .pem lokalno i kopirajte cijeli tekst PEM-a, uključujući početni i završni redak.
Privatni ključ osjetljiv je podatak. Postupajte s njime kao s vjerodajnicom. Ako bude otkriven, generirajte novi privatni ključ, ažurirajte postavke aplikacije u ChatGPT-u i izbrišite kompromitirani ključ u sustavu GitHub Enterprise.
Dovršite postavljanje u ChatGPT-u
Vratite se na karticu za postavljanje predloška u ChatGPT-u.
Zalijepite ID klijenta aplikacije GitHub u polje ID klijenta za otvoreno ovlaštenje.
Zalijepite tajni ključ klijenta aplikacije GitHub u polje Tajni ključ klijenta za otvoreno ovlaštenje.
Ostavite Opsege nepromijenjenima osim ako vaša organizacija izričito treba promijeniti zadane postavke predloška.
Provjerite je li za GitHub Enterprise unesen samo naziv glavnog računala, primjerice
github.example.com.Zalijepite ili prenesite privatni ključ aplikacije GitHub u formatu PEM u polje Privatni ključ aplikacije GitHub.
Provjerite je li generirani tajni ključ webhooka unesen.
Izradite nacrt aplikacije.
U ChatGPT-u otvorite pojedinosti izrađenog nacrta aplikacije i kopirajte generirani URL webhooka.
URL webhooka trebao bi izgledati ovako: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Dovršite postavljanje webhooka u sustavu GitHub Enterprise
Vratite se na postavke aplikacije GitHub u sustavu GitHub Enterprise.
Otvorite opće postavke aplikacije GitHub.
Uključite opciju Aktivni webhookovi ako već nije uključena.
Zalijepite URL webhooka iz ChatGPT-a u polje URL webhooka.
Zalijepite tajni ključ webhooka iz ChatGPT-a u polje Tajni ključ webhooka.
Ostavite provjeru SSL-a uključenom.
Provjerite odgovaraju li događaji webhooka na koje ste pretplaćeni dozvolama i radnjama koje ste omogućili.
Spremite promjene.
Objavite aplikaciju i upravljajte njome u ChatGPT-u
Izradom nacrta aplikacija ne postaje automatski dostupna članovima. Nakon pregleda nacrta:
Objavite nacrt aplikacije.
U Postavkama radnog prostora otvorite stranicu Aplikacije, zatim Omogućeno i provjerite prikazuje li se aplikacija. Stranicu Aplikacije možete otvoriti i putem opcije Upravljanje naslijeđenim aplikacijama u odjeljku Administratorska konzola > Dodaci.
Konfigurirajte Pristup korisnika za uloge koje se trebaju koristiti aplikacijom.
Pregledajte Kontrolu radnji za radnje čitanja i pisanja.
Pregledajte Dozvole aplikacije da biste odabrali kada ChatGPT traži odobrenje članova prije upotrebe aplikacije.
Zamolite testnog korisnika kojem je dopušten pristup da otvori Aplikacije u ChatGPT-u i provjeri prikazuje li se aplikacija.
Te dozvole aplikacije primjenjuju se na razgovore u ChatGPT-u. Agenti radnog prostora upotrebljavaju kontrole za pojedinog agenta koje postavlja njegov autor 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 aplikaciju GitHub
U sustavu GitHub Enterprise instalirajte aplikaciju GitHub za organizaciju ili račun.
Odaberite sve repozitorije ili samo odabrane repozitorije u skladu s pravilima radnog prostora.
Kao korisnik kojem je dopušten pristup pokrenite postupak povezivanja iz ChatGPT-a.
Autorizirajte aplikaciju GitHub kada se to zatraži.
Najprije izvršite jednostavnu radnju čitanja, primjerice prikaz popisa dostupnih repozitorija ili dohvat poznate stavke pull request.
Ako su radnje pisanja omogućene, prije šireg uvođenja testirajte ih na repozitoriju niskog rizika.
Naziv glavnog računala i način rada otvorenog ovlaštenja
ChatGPT na temelju naziva glavnog računala određuje krajnje točke za GitHub Enterprise. Unesite samo naziv glavnog računala, primjerice github.example.com ili octocorp.ghe.com.
Nemojte unositi putanju API-ja, putanju repozitorija ni github.com osim ako je to točan naziv glavnog računala sustava GitHub Enterprise za ovu aplikaciju.
Rješavanje problema
URI preusmjeravanja ne podudara se: provjerite podudara li se URL povratnog poziva aplikacije GitHub točno s URL-om povratnog poziva prikazanim u ChatGPT-u.
ChatGPT ne može izraditi ili spremiti nacrt aplikacije: provjerite jesu li popunjena sva obavezna polja, uključujući naziv glavnog računala, ID klijenta za otvoreno ovlaštenje, Tajni ključ klijenta za otvoreno ovlaštenje, privatni ključ i tajni ključ webhooka.
Autentifikacija uspijeva, ali pozivi repozitoriju ne uspijevaju: provjerite je li aplikacija GitHub instalirana i ima li pristup repozitoriju.
API vraća kod 403 ili obavijest o nedovoljnim dozvolama: dodajte dozvolu koja nedostaje aplikaciji GitHub i zatražite od vlasnika instalacije da odobri ažurirane dozvole ako se to zatraži.
Repozitoriji se ne prikazuju: provjerite uključuje li instalacija aplikacije očekivane repozitorije i ima li im pristup korisnik koji daje autorizaciju u ChatGPT-u.
Isporuke webhooka ne uspijevaju: provjerite podudaraju li se URL i tajni ključ webhooka s vrijednostima iz ChatGPT-a, ostavite provjeru SSL-a uključenom i provjerite može li glavno računalo sustava GitHub Enterprise pristupiti adresi
connectors.api.openai.org.Pogreške privatnog ključa: provjerite je li kopiran cijeli sadržaj PEM-a, uključujući početni i završni redak.