Mësoni si administratorët e hapësirës së punës mund të konfigurojnë shabllonin e aplikacionit GitHub Enterprise në ChatGPT duke përdorur GitHub App të vetë organizatës së tyre.

Përmbledhje

Përdoreni këtë udhëzues nëse jeni administrator i një hapësire pune në ChatGPT dhe po konfiguroni shabllonin e aplikacionit GitHub Enterprise për organizatën tuaj. Shablloni nuk është aplikacioni përfundimtar që përdorin anëtarët. Ai është një proces konfigurimi që krijon një aplikacion paraprak për hapësirën tuaj të punës, pasi të jepni konfigurimin e kërkuar të GitHub Enterprise.

Për GitHub Enterprise, konfigurimi e lidh ChatGPT me hostin e GitHub Enterprise të organizatës suaj. Krijoni një aplikacion GitHub, regjistroni URL-në e kthimit të ChatGPT, gjeneroni kredencialet dhe më pas ngjitni këto vlera gjatë procesit të konfigurimit të shabllonit në ChatGPT. Pasi ChatGPT të krijojë aplikacionin paraprak, mund ta publikoni dhe ta menaxhoni si aplikacionet e tjera të hapësirës së punës.

Për lundrimin në hapësirën e punës dhe qasjen në aplikacione, shihni: Kontrollet e administratorit, siguria dhe pajtueshmëria për shtojcat dhe aplikacionet.

Çfarë po konfiguroni

Po krijoni në ChatGPT një aplikacion GitHub Enterprise posaçërisht për hapësirën tuaj të punës. Aplikacioni përdor:

Një aplikacion GitHub të regjistruar në hostin tuaj të GitHub Enterprise.
ID-në dhe sekretin e klientit të aplikacionit GitHub për autorizimin OAuth të përdoruesit.
Çelësin privat të aplikacionit GitHub, që ChatGPT të mund të gjenerojë tokenë instalimi për veprimet në depo.
Një sekret dhe një URL të webhook-ut, që GitHub Enterprise të mund t'i dërgojë ChatGPT ngjarje të instalimit dhe të depove.
Emrin e hostit tuaj të GitHub Enterprise, si github.example.com.

Krijoni një aplikacion GitHub, jo një aplikacion të veçantë GitHub OAuth. Konfigurimi i shabllonit në ChatGPT kërkon kredencialet e aplikacionit GitHub, një çelës privat dhe cilësimet e webhook-ut.

Përpara se të filloni

Ju nevojiten:

Qasje si administrator ose zotërues i hapësirës së punës në ChatGPT.
Qasje si administrator i GitHub Enterprise ose zotërues i organizatës, me të drejtë krijimi dhe instalimi të aplikacioneve GitHub.
Vetëm emri i hostit të GitHub Enterprise, pa https:// ose shteg.
Një vendim për veprimet në depo që duhet të mbështesë ChatGPT, si kërkimi vetëm për lexim në depo, rrjedhat e punës për pull request ose çështjet, redaktimet e skedarëve, GitHub Actions apo rrjedha më të gjera pune me Codex.
Një vend i sigurt për të administruar çelësin privat dhe sekretin e klientit të aplikacionit GitHub.

Mbajini ChatGPT dhe GitHub Enterprise të hapura në skeda të veçanta. Mos e sajoni URL-në e kthimit. Kopjoni saktësisht URL-në e kthimit që shfaqet në ChatGPT.

Vlerat që duhet të përgatitni

Emri i hostit të GitHub Enterprise: për shembull, github.example.com.
URL-ja e kthimit: kopjojeni nga procesi i konfigurimit të shabllonit në ChatGPT.
ID-ja e klientit të aplikacionit GitHub.
Sekreti i klientit të aplikacionit GitHub.
Çelësi privat PEM i aplikacionit GitHub.
Sekreti i webhook-ut i gjeneruar nga ChatGPT.
URL-ja e webhook-ut e gjeneruar pas krijimit të aplikacionit paraprak 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. Mund të shkoni edhe te Konsola e administratorit, të zgjidhni hapësirën përkatëse të punës në ChatGPT dhe të hapni Shtojcat. Zgjidhni Menaxhoni aplikacionet e vjetra për të hapur faqen Aplikacionet që është ruajtur.
Zgjidhni Katalogu.
Kërkoni GitHub Enterprise.
Zgjidhni shabllonin e aplikacionit GitHub Enterprise dhe nisni konfigurimin.
Vendosni një emër dhe përshkrim të qartë për aplikacionin, si GitHub Enterprise ose GitHub Enterprise - Inxhinieri.
Vendosni emrin e hostit të GitHub Enterprise, si github.example.com.
Kopjoni URL-në e kthimit që shfaqet në ChatGPT. Mbajeni të hapur këtë skedë.
Kopjoni sekretin e gjeneruar të webhook-ut nëse shfaqet gjatë konfigurimit.

Shembull i URL-së së kthimit: https://chatgpt.com/connector/oauth/<callback_id>

Mos e hiqni ID-në e kthimit, mos shtoni vijë të pjerrët në fund dhe mos e zëvendësoni URL-në me një URL të përgjithshme të ChatGPT.

Krijoni aplikacionin GitHub në GitHub Enterprise

Hapni adresën e serverit tuaj GitHub Enterprise, për shembull https://github.example.com.
Shkoni te organizata ose llogaria që duhet të zotërojë aplikacionin.
Hapni Cilësimet > Cilësimet e zhvilluesit > Aplikacionet GitHub.
Zgjidhni Aplikacion i ri GitHub.
Vendosni një emër të qartë për aplikacionin, për shembull ChatGPT GitHub Enterprise.
Vendosni URL-në e faqes kryesore. Nëse nuk ka një faqe të brendshme të dedikuar, përdorni URL-në e organizatës në GitHub Enterprise.
Te URL-ja e kthimit, ngjitni pa ndryshime URL-në e kthimit të kopjuar nga ChatGPT.
Mbajeni të aktivizuar opsionin Skadimi i tokenëve të autorizimit të përdoruesve, përveçse kur ekipi juaj i sigurisë ka një arsye të caktuar për ta ndryshuar.
Aktivizoni opsionin Kërko autorizimin e përdoruesit gjatë instalimit, që përdoruesit të mund ta autorizojnë aplikacionin gjatë procesit të instalimit ose të lidhjes.
Te Ku mund të instalohet ky aplikacion GitHub?, zgjidhni opsionin më të kufizuar që i përshtatet planit tuaj të vënies në përdorim.
Krijoni aplikacionin GitHub.

Konfiguroni lejet dhe ngjarjet

Zgjidhni lejet minimale të nevojshme për veprimet e ChatGPT që planifikoni të aktivizoni.

Për gjetjen e depove dhe pyetje e përgjigje me qasje vetëm për lexim, filloni me leje leximi si:

Metadatat: vetëm lexim. GitHub kërkon qasje në metadata për aplikacionet GitHub.
Përmbajtja: vetëm lexim, për qasje në skedarë dhe në përmbajtjen e depos.
Çështjet: vetëm lexim, nëse nevojitet kërkimi ose leximi i çështjeve.
Pull request: vetëm lexim, nëse nevojitet kërkimi i pull request ose konteksti për shqyrtimin e tyre.
Veprimet: vetëm lexim, nëse nevojiten statusi i ekzekutimit të rrjedhave të punës, detyrat, regjistrat ose artefaktet.

Për rrjedhat e punës që bëjnë shkrime, shtoni leje shkrimi vetëm aty ku nevojiten, si te Përmbajtja, Pull request, Çështjet, Veprimet ose Rrjedhat e punës. Përdorni lejet më të kufizuara që mundësojnë veprimet e synuara të ChatGPT.

Ngjarjet e webhook-ut duhet të përputhen me rrjedhat e punës që mbështetni. Ngjarjet e zakonshme përfshijnë Instalimin, Depot e instalimit, Dërgimin e ndryshimeve, Pull request, Çështjet, Komentin në çështje, Ekzekutimin e rrjedhës së punës dhe Detyrën e rrjedhës së punës.

Gjeneroni dhe kopjoni kredencialet e aplikacionit GitHub

Te cilësimet e aplikacionit GitHub, kopjoni ID-në e klientit.
Gjeneroni një Sekret klienti dhe kopjojeni menjëherë.
Te Çelësat privatë, gjeneroni një çelës privat.
Shkarkoni skedarin .pem dhe ruajeni në mënyrë të sigurt.
Hapni skedarin .pem në pajisjen tuaj dhe kopjoni të gjithë tekstin PEM, përfshirë rreshtat e fillimit dhe të fundit.

Çelësi privat është informacion i ndjeshëm. Trajtojeni si kredencial. Nëse ekspozohet, gjeneroni një çelës të ri privat, përditësoni konfigurimin e aplikacionit në ChatGPT dhe fshini çelësin e komprometuar në GitHub Enterprise.

Përfundoni konfigurimin në ChatGPT

Kthehuni te skeda e konfigurimit të shabllonit në ChatGPT.
Ngjitni ID-në e klientit të aplikacionit GitHub te ID-ja e klientit OAuth.
Ngjitni sekretin e klientit të aplikacionit GitHub te Sekreti i klientit OAuth.
Lëreni fushën Fushat e autorizimit të pandryshuar, përveç rastit kur organizata juaj ka nevojë të ndryshojë qëllimisht vlerat e parazgjedhura të shabllonit.
Konfirmoni që fusha e emrit të hostit të GitHub Enterprise përmban vetëm emrin e hostit, si github.example.com.
Ngjitni ose ngarkoni çelësin privat PEM të aplikacionit GitHub te fusha Çelësi privat i aplikacionit GitHub.
Konfirmoni që sekreti i gjeneruar i webhook-ut është i pranishëm.
Krijoni aplikacionin paraprak.
Hapni në ChatGPT detajet e aplikacionit paraprak të krijuar dhe kopjoni URL-në e gjeneruar të webhook-ut.

URL-ja e webhook-ut duhet të ketë këtë formë: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Përfundoni konfigurimin e webhook-ut në GitHub Enterprise

Kthehuni te cilësimet e aplikacionit GitHub në GitHub Enterprise.
Hapni Cilësimet e përgjithshme të aplikacionit GitHub.
Aktivizoni opsionin Webhook-ë aktivë nëse nuk është aktivizuar tashmë.
Ngjitni URL-në e webhook-ut të ChatGPT te URL-ja e webhook-ut.
Ngjitni sekretin e webhook-ut të ChatGPT te Sekreti i webhook-ut.
Mbajeni të aktivizuar verifikimin SSL.
Konfirmoni që ngjarjet e webhook-ut ku jeni abonuar përputhen me lejet dhe veprimet që keni aktivizuar.
Ruani ndryshimet.

Publikoni dhe menaxhoni aplikacionin në ChatGPT

Krijimi i versionit paraprak të aplikacionit nuk e bën atë automatikisht të disponueshëm për anëtarët. Pasi të keni shqyrtuar versionin paraprak:

Publikoni versionin paraprak të aplikacionit.
Te cilësimet e hapësirës së punës, hapni faqen Aplikacionet, hapni Të aktivizuara dhe verifikoni që aplikacioni shfaqet. Faqen Aplikacionet mund ta hapni edhe përmes opsionit Menaxho aplikacionet e vjetra te Konsola e administratorit > Shtojcat.
Në Enterprise dhe Edu, përdorni Qasja e përdoruesve për të zgjedhur se cilat role mund ta përdorin aplikacionin. Në Business, menaxhoni disponueshmërinë e aplikacionit në të gjithë hapësirën e punës.
Shqyrtoni Kontrolli i veprimeve për veprimet e leximit dhe të shkrimit.
Shqyrtoni Lejet e aplikacionit për të zgjedhur se kur ChatGPT u kërkon leje anëtarëve përpara se të përdorë aplikacionin.
Kërkojini një përdoruesi testues me leje qasjeje të hapë Aplikacionet në ChatGPT dhe të verifikojë që aplikacioni shfaqet.

Këto leje të aplikacionit zbatohen për bisedat në ChatGPT. Agjentët e hapësirës së punës përdorin kontrolle që krijuesi i secilit agjent i cakton veçmas, për të përcaktuar se cilat veprime të aplikacionit janë të disponueshme dhe kur përdoruesve fundorë u kërkohet t'i miratojnë ato. Për sjelljen e agjentëve, shihni: Agjentët e hapësirës së punës në ChatGPT për Enterprise dhe Business.

Instaloni dhe testoni aplikacionin GitHub

Në GitHub Enterprise, instaloni aplikacionin GitHub në organizatë ose në llogari.
Zgjidhni të gjitha depot ose vetëm disa prej tyre, sipas politikës së hapësirës së punës.
Nisni procesin e lidhjes nga ChatGPT si përdorues me qasje të lejuar.
Autorizoni aplikacionin GitHub kur t'ju kërkohet.
Fillimisht kryeni një veprim të thjeshtë leximi, si listimi i depove ku keni qasje ose marrja e një pull request të njohur.
Nëse veprimet e shkrimit janë të aktivizuara, testoni në një depo me rrezik të ulët përpara se ta zgjeroni përdorimin.

Emri i hostit dhe funksionimi i OAuth

ChatGPT përdor emrin e hostit për të përcaktuar 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ç rastit kur ky është pikërisht hosti i GitHub Enterprise për këtë aplikacion.

Zgjidhja e problemeve

Mospërputhje e URI-së së ridrejtimit: konfirmoni që URL-ja e kthimit të aplikacionit GitHub përputhet saktësisht me URL-në e kthimit që shfaqet në ChatGPT.
ChatGPT nuk mund të krijojë ose ruajë aplikacionin paraprak: konfirmoni që janë plotësuar të gjitha fushat e kërkuara, përfshirë emrin e hostit, ID-në e klientit OAuth, Sekretin e klientit OAuth, çelësin privat dhe sekretin e webhook-ut.
Autentikimi kryhet me sukses, por thirrjet drejt depos dështojnë: konfirmoni që aplikacioni GitHub është i instaluar dhe ka qasje në depo.
API-ja kthen kodin 403 ose leje të pamjaftueshme: shtoni lejen që mungon për aplikacionin GitHub dhe, nëse kërkohet, kërkojini zotëruesit të instalimit të miratojë lejet e përditësuara.
Nuk shfaqet asnjë depo: konfirmoni që instalimi i aplikacionit përfshin depot e pritshme dhe që përdoruesi që jep autorizimin në ChatGPT ka qasje në to.
Dërgesat e webhook-ut dështojnë: konfirmoni që URL-ja dhe sekreti i webhook-ut përputhen me vlerat nga ChatGPT, mbajeni të aktivizuar verifikimin SSL dhe sigurohuni që hosti i GitHub Enterprise mund të lidhet me connectors.api.openai.org.
Gabime të çelësit privat: konfirmoni që është kopjuar e gjithë përmbajtja PEM, përfshirë rreshtat e fillimit dhe të fundit.

Konfiguroni shabllonin e aplikacionit GitHub Enterprise në ChatGPT