OpenAI
Ova je stranica strojno prevedena. Pogledajte izvorni članak na engleskom jeziku.

Postavljanje predloška aplikacije GitHub Enterprise u ChatGPT-u

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

Ažurirano: 20 hours ago

Pregled

Upotrijebite ovaj vodič ako ste administrator ChatGPT radnog prostora i postavljate GitHub predložak aplikacije Enterprise za svoju organizaciju. Predložak nije konačna aplikacija koju članovi upotrebljavaju. To je tijek postavljanja koji izrađuje skicu aplikacije specifičnu za radni prostor nakon što navedete potrebnu konfiguraciju za GitHub Enterprise.

Za GitHub Enterprise postavljanje povezuje ChatGPT s GitHub Enterprise hostom vaše organizacije. Izradite GitHub App, registrirate URL povratnog poziva za ChatGPT, generirate vjerodajnice, a zatim zalijepite te vrijednosti u tijek postavljanja ChatGPT predloška. Nakon što ChatGPT izradi skicu aplikacije, možete je objaviti i njome upravljati kao drugim aplikacijama radnog prostora.

Što postavljate

U ChatGPT-u izrađujete aplikaciju GitHub Enterprise specifičnu za radni prostor. Aplikacija upotrebljava:

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

  • ID klijenta i tajnu klijenta za GitHub App za korisničko OAuth ovlaštenje.

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

  • Webhook tajnu i webhook URL kako bi GitHub Enterprise mogao slati događaje instalacije i repozitorija natrag u ChatGPT.

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

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

Prije početka

Treba vam:

  • Administratorski ili vlasnički pristup ChatGPT radnom prostoru.

  • Administratorski pristup ili pristup vlasnika organizacije za GitHub Enterprise koji može izrađivati 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 pretraživanje repozitorija samo za čitanje, tijekovi rada za pull request, tijekovi rada za probleme, uređivanje datoteka, GitHub Actions ili širi Codex tijekovi rada.

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

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

Vrijednosti za pripremu

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

  • URL povratnog poziva: kopirajte ga iz tijeka postavljanja ChatGPT predloška.

  • ID klijenta za GitHub App.

  • Tajna klijenta za GitHub App.

  • PEM privatni ključ za GitHub App.

  • Webhook tajna koju generira ChatGPT.

  • Webhook URL generiran nakon izrade skice aplikacije u ChatGPT-u.

Pokrenite postavljanje predloška u ChatGPT-u

  1. U ChatGPT-u prijeđite 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 su GitHub Enterprise ili GitHub Enterprise - Engineering.

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

  8. Kopirajte URL povratnog poziva prikazan u ChatGPT-u. Ostavite ovu karticu otvorenom.

  9. Kopirajte generiranu tajnu za webhook 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 ga generičkim ChatGPT URL-om.

Izradite 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 razvojne 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 nema namjenske interne stranice, upotrijebite URL organizacije GitHub Enterprise.

  7. U polje URL povratnog poziva zalijepite točan URL povratnog poziva kopiran iz ChatGPT-a.

  8. Ostavite opciju isteka tokena za ovlaštenje korisnika omogućenom, osim ako vaš sigurnosni tim nema poseban razlog za promjenu.

  9. Omogućite zahtjev za korisničko ovlaštenje tijekom instalacije kako bi korisnici mogli ovlastiti aplikaciju tijekom instalacije ili povezivanja.

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

  11. Izradite GitHub App.

Konfigurirajte dopuštenja i događaje

Odaberite minimalna dopuštenja potrebna za ChatGPT radnje koje planirate omogućiti.

Za otkrivanje repozitorija samo za čitanje i pitanja i odgovore počnite s dopuštenjima 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.

  • Pull requests: samo za čitanje, ako je potreban kontekst pretraživanja ili pregleda pull requesta.

  • Radnje: samo za čitanje, ako su potrebni status izvršavanja tijeka rada, poslovi, zapisnici ili artefakti.

Za tijekove rada s pisanjem dodajte dopuštenja za pisanje samo gdje je potrebno, kao što su Sadržaj, Pull requests, Problemi, Radnje ili Tijekovi rada. Upotrijebite najuža dopuštenja koja podržavaju predviđene ChatGPT radnje.

Webhook događaji trebaju odgovarati tijekovima rada koje podržavate. Uobičajeni događaji uključuju Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run i Workflow job.

Generirajte i kopirajte vjerodajnice za GitHub App

  1. U postavkama aplikacije GitHub App kopirajte ID klijenta.

  2. Generirajte tajnu klijenta i odmah je kopirajte.

  3. U odjeljku Privatni ključevi generirajte privatni ključ.

  4. Preuzmite datoteku .pem i sigurno je pohranite.

  5. Lokalno otvorite datoteku .pem i kopirajte cijeli PEM tekst, uključujući početne i završne retke.

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

Dovrš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 nepromijenjenima, osim ako vaša organizacija namjerno treba nadjačati zadane vrijednosti predloška.

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

  6. Zalijepite ili prenesite PEM privatni ključ aplikacije GitHub App u privatni ključ aplikacije GitHub App.

  7. Potvrdite da je generirana tajna za webhook prisutna.

  8. Izradite skicu aplikacije.

  9. Otvorite pojedinosti izrađene skice aplikacije u ChatGPT-u i kopirajte generirani webhook URL.

Webhook URL trebao bi izgledati ovako: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Dovršite postavljanje webhooka u GitHub Enterpriseu

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

  2. Otvorite opće postavke aplikacije GitHub App.

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

  4. Zalijepite ChatGPT webhook URL u Webhook URL.

  5. Zalijepite ChatGPT webhook tajnu u Webhook tajna.

  6. Ostavite SSL provjeru omogućenom.

  7. Potvrdite da pretplaćeni webhook događaji odgovaraju dopuštenjima i radnjama koje ste omogućili.

  8. Spremite promjene.

Objavite aplikaciju i upravljajte njome u ChatGPT-u

Izrada skice aplikacije ne čini je automatski dostupnom članovima. Nakon pregleda skice:

  1. Objavite skicu aplikacije.

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

  3. Konfigurirajte Korisnički pristup za uloge koje je trebaju upotrebljavati.

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

  5. Pregledajte Dopuštenja aplikacije kako biste odabrali kada ChatGPT pita članove prije upotrebe aplikacije.

  6. Zatražite od dopuštenog testnog korisnika da otvori Aplikacije u ChatGPT-u i potvrdi da se aplikacija prikazuje.

Ova dopuštenja aplikacije primjenjuju se na ChatGPT razgovore. Agenti radnog prostora upotrebljavaju kontrole po agentu koje postavlja izrađivač agenta kako bi odredili koje su radnje aplikacije dostupne i kada se od krajnjih korisnika traži njihovo odobrenje. Za ponašanje agenta pogledajte: ChatGPT agenti radnog prostora za Enterprise i Business.

Instalirajte i testirajte GitHub App

  1. U GitHub Enterpriseu instalirajte GitHub app u organizaciju ili račun.

  2. Odaberite sve repozitorije ili odabrane repozitorije u skladu s pravilima radnog prostora.

  3. Pokrenite tijek povezivanja iz ChatGPT-a kao dopušteni korisnik.

  4. Ovlastite GitHub app kada se to zatraži.

  5. Najprije pokrenite malu radnju čitanja, kao što je popisivanje dostupnih repozitorija ili dohvaćanje poznatog pull requesta.

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

Naziv hosta i OAuth ponašanje

ChatGPT upotrebljava naziv hosta za izvođenje krajnjih toč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 točan GitHub Enterprise host za ovu aplikaciju.

Otklanjanje poteškoća

  • Nepodudaranje URI-ja za preusmjeravanje: potvrdite da URL povratnog poziva aplikacije GitHub App točno odgovara URL-u povratnog poziva prikazanom u ChatGPT-u.

  • ChatGPT ne može izraditi ili spremiti skicu aplikacije: potvrdite da su prisutna sva potrebna polja, uključujući naziv hosta, ID OAuth klijenta, tajnu OAuth klijenta, privatni ključ i webhook tajnu.

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

  • API vraća 403 ili nedovoljna dopuštenja: dodajte nedostajuće dopuštenje za GitHub App i neka vlasnik instalacije odobri ažurirana dopuštenja ako se to zatraži.

  • Ne prikazuju se repozitoriji: potvrdite da instalacija aplikacije uključuje očekivane repozitorije i da korisnik koji ovlašćuje u ChatGPT-u ima pristup njima.

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

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

Reference

Je li vam ovaj članak bio koristan?