Përmbledhje
Përdoreni këtë udhëzues nëse jeni administrator i hapësirës së punës ChatGPT dhe po konfiguroni shabllonin e aplikacionit GitHub Enterprise për organizatën tuaj. Një shabllon nuk është aplikacioni përfundimtar që përdorin anëtarët. Është një rrjedhë konfigurimi që krijon një aplikacion draft specifik për hapësirën e punës pasi të jepni konfigurimin e kërkuar të GitHub Enterprise.
Për GitHub Enterprise, konfigurimi lidh ChatGPT me hostin GitHub Enterprise të organizatës suaj. Ju krijoni një GitHub App, regjistroni URL-në e callback-ut të ChatGPT, gjeneroni kredenciale, pastaj i ngjitni këto vlera në rrjedhën e konfigurimit të shabllonit ChatGPT. Pasi ChatGPT të krijojë aplikacionin draft, mund ta publikoni dhe ta menaxhoni si aplikacionet e tjera të hapësirës së punës.
Çfarë po konfiguroni
Po krijoni një aplikacion GitHub Enterprise specifik për hapësirën e punës në ChatGPT. Aplikacioni përdor:
Një GitHub App të regjistruar në hostin tuaj GitHub Enterprise.
ID-në e klientit dhe sekretin e klientit të GitHub App për autorizimin OAuth të përdoruesit.
Çelësin privat të GitHub App që ChatGPT të mund të krijojë tokenë instalimi për operacionet e depos.
Një sekret webhook dhe URL webhook-u që GitHub Enterprise të mund t'i dërgojë ngjarjet e instalimit dhe të depos përsëri te ChatGPT.
Emrin e hostit të GitHub Enterprise, si
github.example.com.
Krijoni një GitHub App, jo një GitHub OAuth App të pavarur. Konfigurimi i shabllonit ChatGPT kërkon kredenciale të GitHub App, një çelës privat dhe cilësime webhook-u.
Para se të filloni
Ju nevojiten:
Qasje administratori ose pronari në hapësirën e punës ChatGPT.
Qasje administratori ose pronari organizate në GitHub Enterprise që mund të krijojë dhe instalojë GitHub Apps.
Vetëm emri i hostit të GitHub Enterprise, pa
https://ose shteg.Një vendim se cilat veprime depoje duhet të mbështesë ChatGPT, si kërkim depoje vetëm për lexim, workflow kërkesash pull, workflow problemesh, redaktime skedarësh, GitHub Actions ose workflow më të gjera Codex.
Një vend i sigurt për të trajtuar çelësin privat dhe sekretin e klientit të GitHub App.
Mbajini ChatGPT dhe GitHub Enterprise të hapura në skeda të veçanta. Mos e shpikni URL-në e callback-ut. Kopjoni URL-në e saktë të callback-ut të shfaqur në ChatGPT.
Vlerat për t'u përgatitur
Emri i hostit të GitHub Enterprise: për shembull,
github.example.com.URL-ja e callback-ut: kopjojeni këtë nga rrjedha e konfigurimit të shabllonit ChatGPT.
ID-ja e klientit të GitHub App.
Sekreti i klientit të GitHub App.
Çelësi privat PEM i GitHub App.
Sekreti i webhook-ut i gjeneruar nga ChatGPT.
URL-ja e webhook-ut e gjeneruar pasi krijohet aplikacioni draft në ChatGPT.
Nisni konfigurimin e shabllonit në ChatGPT
Në ChatGPT, kaloni te hapësira e punës ku duhet të jetë i disponueshëm aplikacioni.
Hapni Cilësimet e hapësirës së punës > Aplikacionet.
Zgjidhni Drejtoria.
Kërkoni GitHub Enterprise.
Zgjidhni shabllonin e aplikacionit GitHub Enterprise dhe nisni konfigurimin.
Vendosni një emër dhe përshkrim të qartë aplikacioni, si GitHub Enterprise ose GitHub Enterprise - Engineering.
Vendosni emrin e hostit të GitHub Enterprise, si
github.example.com.Kopjoni URL-në e callback-ut të shfaqur në ChatGPT. Mbajeni këtë skedë të hapur.
Kopjoni sekretin e gjeneruar të webhook-ut nëse shfaqet gjatë konfigurimit.
Shembull URL-je callback: https://chatgpt.com/connector/oauth/<callback_id>
Mos e hiqni ID-në e callback-ut, mos shtoni vijë të pjerrët në fund dhe mos e zëvendësoni me një URL të përgjithshme të ChatGPT.
Krijoni GitHub App në GitHub Enterprise
Hapni hostin tuaj GitHub Enterprise, si
https://github.example.com.Shkoni te organizata ose llogaria që duhet të zotërojë aplikacionin.
Hapni Settings > Developer settings > GitHub Apps.
Zgjidhni New GitHub App.
Vendosni një emër të qartë aplikacioni, si ChatGPT GitHub Enterprise Connector.
Vendosni një URL të faqes kryesore. Nëse nuk ka faqe të brendshme të dedikuar, përdorni URL-në e organizatës GitHub Enterprise.
Te Callback URL, ngjitni URL-në e saktë të callback-ut të kopjuar nga ChatGPT.
Mbajeni të aktivizuar Expire user authorization tokens, përveç nëse ekipi juaj i sigurisë ka një arsye specifike për ta ndryshuar.
Aktivizoni Request user authorization during installation që përdoruesit ta autorizojnë aplikacionin gjatë instalimit ose rrjedhës së lidhjes.
Nën Where can this GitHub App be installed?, zgjidhni opsionin më të ngushtë që i përshtatet shtrirjes suaj.
Krijoni GitHub App.
Konfiguroni lejet dhe ngjarjet
Zgjidhni lejet minimale të kërkuara për veprimet e ChatGPT që planifikoni të aktivizoni.
Për zbulim dhe pyetje-përgjigje vetëm për lexim të depos, nisni me leje leximi si:
Metadata: vetëm lexim. GitHub kërkon metadata për GitHub Apps.
Contents: vetëm lexim, për qasje në përmbajtjen e skedarëve dhe të depos.
Issues: vetëm lexim, nëse nevojitet kërkimi ose leximi i problemeve.
Pull requests: vetëm lexim, nëse nevojitet kërkimi i kërkesave pull ose konteksti i shqyrtimit.
Actions: vetëm lexim, nëse nevojiten statusi i ekzekutimit të workflow-t, detyrat, regjistrat ose artefaktet.
Për workflow shkrimi, shtoni leje shkrimi vetëm aty ku nevojiten, si Contents, Pull requests, Issues, Actions ose Workflows. Përdorni lejet më të ngushta që mbështesin veprimet e synuara të ChatGPT.
Ngjarjet webhook duhet të përputhen me workflow-t që mbështetni. Ngjarjet e zakonshme përfshijnë Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run dhe Workflow job.
Gjeneroni dhe kopjoni kredencialet e GitHub App
Në cilësimet e GitHub App, kopjoni Client ID.
Gjeneroni një Client secret dhe kopjojeni menjëherë.
Nën Private keys, gjeneroni një çelës privat.
Shkarkoni skedarin .pem dhe ruajeni në mënyrë të sigurt.
Hapni lokalisht skedarin .pem dhe kopjoni tekstin e plotë PEM, përfshirë rreshtat e fillimit dhe të fundit.
Çelësi privat është i ndjeshëm. Trajtojeni si kredencial. Nëse ekspozohet, gjeneroni një çelës të ri privat, përditësoni konfigurimin e aplikacionit ChatGPT dhe fshini çelësin e komprometuar në GitHub Enterprise.
Përfundoni konfigurimin në ChatGPT
Kthehuni te skeda e konfigurimit të shabllonit ChatGPT.
Ngjitni Client ID të GitHub App te OAuth client ID.
Ngjitni Client secret të GitHub App te OAuth client secret.
Lëreni Scopes të pandryshuar, përveç nëse organizata juaj ka qëllimisht nevojë të mbishkruajë parazgjedhjet e shabllonit.
Konfirmoni që emri i hostit të GitHub Enterprise është vetëm hostname, si
github.example.com.Ngjitni ose ngarkoni PEM-in e çelësit privat të GitHub App te GitHub App private key.
Konfirmoni që sekreti i gjeneruar i webhook-ut është i pranishëm.
Krijoni aplikacionin draft.
Hapni detajet e aplikacionit draft të krijuar në ChatGPT dhe kopjoni URL-në e gjeneruar të webhook-ut.
URL-ja e webhook-ut duhet të duket kështu: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Përfundoni konfigurimin e webhook-ut në GitHub Enterprise
Kthehuni te cilësimet e GitHub App në GitHub Enterprise.
Hapni cilësimet General të GitHub App.
Aktivizoni Active webhooks nëse nuk janë tashmë të aktivizuara.
Ngjitni URL-në e webhook-ut të ChatGPT te Webhook URL.
Ngjitni sekretin e webhook-ut të ChatGPT te Webhook secret.
Mbajeni të aktivizuar verifikimin SSL.
Konfirmoni që ngjarjet webhook të abonuar përputhen me lejet dhe veprimet që aktivizuat.
Ruani ndryshimet.
Publikoni dhe menaxhoni aplikacionin në ChatGPT
Krijimi i aplikacionit draft nuk e bën automatikisht të disponueshëm për anëtarët. Pas shqyrtimit të draftit:
Publikoni aplikacionin draft.
Konfirmoni që aplikacioni shfaqet te Cilësimet e hapësirës së punës > Aplikacionet > Të aktivizuara.
Konfiguroni Qasjen e përdoruesit për rolet që duhet ta përdorin.
Shqyrtoni Kontrollin e veprimeve për veprimet e leximit dhe shkrimit.
Shqyrtoni Lejet e aplikacionit për të zgjedhur kur ChatGPT u kërkon anëtarëve përpara përdorimit të aplikacionit.
Kërkojini një përdoruesi testimi të lejuar të hapë Aplikacionet në ChatGPT dhe të konfirmojë që aplikacioni shfaqet.
Këto leje aplikacioni zbatohen për bisedat në ChatGPT. Agjentët e hapësirës së punës përdorin kontrolle për çdo agjent, të vendosura nga ndërtuesi i agjentit, për të përcaktuar cilat veprime aplikacioni janë të disponueshme dhe kur u kërkohet përdoruesve fundorë t'i miratojnë ato. Për sjelljen e agjentit, shihni: Agjentët e hapësirës së punës ChatGPT për Enterprise dhe Business.
Instaloni dhe testoni GitHub App
Në GitHub Enterprise, instaloni aplikacionin GitHub në organizatë ose llogari.
Zgjidhni të gjitha depot ose depot e përzgjedhura sipas politikës së hapësirës së punës.
Nisni rrjedhën e lidhjes nga ChatGPT si përdorues i lejuar.
Autorizoni aplikacionin GitHub kur t'ju kërkohet.
Ekzekutoni fillimisht një veprim të vogël leximi, si listimi i depove të qasshme ose marrja e një kërkese pull të njohur.
Nëse janë aktivizuar veprimet e shkrimit, testoni me një depo me rrezik të ulët përpara shtrirjes më të gjerë.
Emri i hostit dhe sjellja OAuth
ChatGPT përdor emrin e hostit për të nxjerrë pikat fundore të GitHub Enterprise. Vendosni vetëm hostin, si github.example.com ose octocorp.ghe.com.
Mos vendosni një shteg API-je, një shteg depoje ose github.com, përveç nëse ai është hosti i saktë GitHub Enterprise për këtë aplikacion.
Zgjidhja e problemeve
Mospërputhje e URI-së së ridrejtimit: konfirmoni që URL-ja e callback-ut të GitHub App përputhet saktësisht me URL-në e callback-ut të shfaqur në ChatGPT.
ChatGPT nuk mund të krijojë ose ruajë aplikacionin draft: konfirmoni që të gjitha fushat e kërkuara janë të pranishme, përfshirë emrin e hostit, OAuth client ID, OAuth client secret, çelësin privat dhe sekretin e webhook-ut.
Autentikimi ka sukses, por thirrjet e depos dështojnë: konfirmoni që GitHub App është instaluar dhe ka qasje në depo.
API kthen 403 ose leje të pamjaftueshme: shtoni lejen që mungon për GitHub App dhe kërkojini pronarit të instalimit të miratojë lejet e përditësuara nëse kërkohet.
Nuk shfaqet asnjë depo: konfirmoni që instalimi i aplikacionit përfshin depot e pritura dhe përdoruesi që autorizon në ChatGPT ka qasje në to.
Dërgesat e webhook-ut dështojnë: konfirmoni që URL-ja e webhook-ut dhe sekreti i webhook-ut përputhen me vlerat nga ChatGPT, mbajeni të aktivizuar verifikimin SSL dhe sigurohuni që hosti GitHub Enterprise të mund të arrijë
connectors.api.openai.org.Gabime të çelësit privat: konfirmoni që është kopjuar përmbajtja e plotë PEM, përfshirë rreshtat e fillimit dhe të fundit.