Pārskats
Izmantojiet šo ceļvedi, ja esat ChatGPT darbvietas administrators, kas iestata GitHub Enterprise lietotnes veidni savai organizācijai. Veidne nav galīgā lietotne, ko izmanto dalībnieki. Tā ir iestatīšanas plūsma, kas izveido darbvietai specifisku melnraksta lietotni pēc tam, kad norādāt nepieciešamo GitHub Enterprise konfigurāciju.
GitHub Enterprise gadījumā iestatīšana savieno ChatGPT ar jūsu organizācijas GitHub Enterprise resursdatoru. Jūs izveidojat GitHub App, reģistrējat ChatGPT atzvana URL, ģenerējat akreditācijas datus un pēc tam ielīmējat šīs vērtības ChatGPT veidnes iestatīšanas plūsmā. Kad ChatGPT izveido melnraksta lietotni, varat to publicēt un pārvaldīt tāpat kā citas darbvietas lietotnes.
Ko jūs iestatāt
Jūs veidojat darbvietai specifisku GitHub Enterprise lietotni ChatGPT. Lietotne izmanto:
GitHub App, kas reģistrēta jūsu GitHub Enterprise resursdatorā.
GitHub App klienta ID un klienta noslēpumu lietotāju OAuth autorizācijai.
GitHub App privāto atslēgu, lai ChatGPT varētu izdot instalācijas tekstvienības repozitoriju darbībām.
Tīmekļa aizķeres noslēpumu un tīmekļa aizķeres URL, lai GitHub Enterprise varētu sūtīt instalēšanas un repozitoriju notikumus atpakaļ uz ChatGPT.
Jūsu GitHub Enterprise resursdatora nosaukumu, piemēram,
github.example.com.
Izveidojiet GitHub App, nevis atsevišķu GitHub OAuth lietotni. ChatGPT veidnes iestatīšanai ir nepieciešami GitHub App akreditācijas dati, privātā atslēga un tīmekļa aizķeres iestatījumi.
Pirms sākat
Jums nepieciešams:
ChatGPT darbvietas administratora vai īpašnieka piekļuve.
GitHub Enterprise administratora vai organizācijas īpašnieka piekļuve, kas ļauj izveidot un instalēt GitHub Apps.
Tikai GitHub Enterprise resursdatora nosaukums, bez
https://vai ceļa.Lēmums par to, kuras repozitoriju darbības ChatGPT jāatbalsta, piemēram, tikai lasīšanas repozitoriju meklēšana, atgādāšanas pieprasījumu darbplūsmas, problēmu darbplūsmas, failu rediģēšana, GitHub Actions vai plašākas Codex darbplūsmas.
Droša vieta GitHub App privātās atslēgas un klienta noslēpuma apstrādei.
Turiet ChatGPT un GitHub Enterprise atvērtus atsevišķās cilnēs. Neizdomājiet atzvana URL. Nokopējiet precīzu atzvana URL, kas parādīts ChatGPT.
Sagatavojamās vērtības
GitHub Enterprise resursdatora nosaukums: piemēram,
github.example.com.Atzvana URL: nokopējiet to no ChatGPT veidnes iestatīšanas plūsmas.
GitHub App klienta ID.
GitHub App klienta noslēpums.
GitHub App privātās atslēgas PEM.
ChatGPT ģenerētais tīmekļa aizķeres noslēpums.
Tīmekļa aizķeres URL, kas ģenerēts pēc melnraksta lietotnes izveides ChatGPT.
Sāciet veidnes iestatīšanu ChatGPT
ChatGPT pārslēdzieties uz darbvietu, kurā lietotnei jābūt pieejamai.
Atveriet Darbvietas iestatījumi > Lietotnes.
Atlasiet Direktorijs.
Meklējiet GitHub Enterprise.
Atlasiet GitHub Enterprise lietotnes veidni un sāciet iestatīšanu.
Ievadiet skaidru lietotnes nosaukumu un aprakstu, piemēram, GitHub Enterprise vai GitHub Enterprise - Engineering.
Ievadiet GitHub Enterprise resursdatora nosaukumu, piemēram,
github.example.com.Nokopējiet ChatGPT parādīto atzvana URL. Atstājiet šo cilni atvērtu.
Nokopējiet ģenerēto tīmekļa aizķeres noslēpumu, ja tas tiek parādīts iestatīšanas laikā.
Atzvana URL piemērs: https://chatgpt.com/connector/oauth/<callback_id>
Nenoņemiet atzvana ID, nepievienojiet beigu slīpsvītru un neaizstājiet to ar vispārīgu ChatGPT URL.
Izveidojiet GitHub App pakalpojumā GitHub Enterprise
Atveriet savu GitHub Enterprise resursdatoru, piemēram,
https://github.example.com.Dodieties uz organizāciju vai kontu, kam jāpieder lietotnei.
Atveriet Iestatījumi > Izstrādātāja iestatījumi > GitHub Apps.
Atlasiet Jauna GitHub App.
Ievadiet skaidru lietotnes nosaukumu, piemēram, ChatGPT GitHub Enterprise Connector.
Ievadiet sākumlapas URL. Ja nav atsevišķas iekšējas lapas, izmantojiet GitHub Enterprise organizācijas URL.
Laukā Atzvana URL ielīmējiet precīzu atzvana URL, kas nokopēts no ChatGPT.
Atstājiet lietotāja autorizācijas tekstvienību derīguma termiņa beigu iestatījumu iespējotu, ja vien jūsu drošības komandai nav konkrēta iemesla to mainīt.
Iespējojiet lietotāja autorizācijas pieprasīšanu instalēšanas laikā, lai lietotāji varētu autorizēt lietotni instalēšanas vai savienošanas plūsmā.
Sadaļā „Kur šo GitHub App var instalēt?”, izvēlieties šaurāko opciju, kas atbilst jūsu ieviešanas plānam.
Izveidojiet GitHub App.
Konfigurējiet atļaujas un notikumus
Izvēlieties minimālās atļaujas, kas nepieciešamas ChatGPT darbībām, kuras plānojat iespējot.
Tikai lasīšanas repozitoriju atklāšanai un jautājumiem un atbildēm sāciet ar lasīšanas atļaujām, piemēram:
Metadati: tikai lasīšanai. GitHub pieprasa metadatus GitHub Apps vajadzībām.
Saturs: tikai lasīšanai, failu un repozitoriju saturam.
Problēmas: tikai lasīšanai, ja nepieciešama problēmu meklēšana vai lasīšana.
Atgādāšanas pieprasījumi: tikai lasīšanai, ja nepieciešama atgādāšanas pieprasījumu meklēšana vai pārskatīšanas konteksts.
Darbības: tikai lasīšanai, ja nepieciešams darbplūsmu izpildes statuss, darbi, žurnāli vai artefakti.
Rakstīšanas darbplūsmām pievienojiet rakstīšanas atļaujas tikai tur, kur nepieciešams, piemēram, saturam, atgādāšanas pieprasījumiem, problēmām, darbībām vai darbplūsmām. Izmantojiet šaurākās atļaujas, kas atbalsta paredzētās ChatGPT darbības.
Tīmekļa aizķeres notikumiem jāatbilst darbplūsmām, kuras atbalstāt. Bieži notikumi ietver instalēšanu, instalēšanas repozitorijus, nosūtīšanu, atgādāšanas pieprasījumu, problēmas, problēmas komentāru, darbplūsmas izpildi un darbplūsmas darbu.
Ģenerējiet un kopējiet GitHub App akreditācijas datus
GitHub App iestatījumos nokopējiet Klienta ID.
Ģenerējiet klienta noslēpumu un nekavējoties nokopējiet to.
Sadaļā Privātās atslēgas ģenerējiet privāto atslēgu.
Lejupielādējiet .pem failu un glabājiet to droši.
Atveriet .pem failu lokāli un nokopējiet pilnu PEM tekstu, tostarp sākuma un beigu rindas.
Privātā atslēga ir sensitīva. Izturieties pret to kā pret akreditācijas datiem. Ja tā tiek atklāta, ģenerējiet jaunu privāto atslēgu, atjauniniet ChatGPT lietotnes iestatīšanu un izdzēsiet kompromitēto atslēgu pakalpojumā GitHub Enterprise.
Pabeidziet iestatīšanu ChatGPT
Atgriezieties ChatGPT veidnes iestatīšanas cilnē.
Ielīmējiet GitHub App klienta ID laukā OAuth klienta ID.
Ielīmējiet GitHub App klienta noslēpumu laukā OAuth klienta noslēpums.
Atstājiet Tvērumus nemainītus, ja vien jūsu organizācijai nav apzinātas vajadzības pārrakstīt veidnes noklusējumus.
Apstipriniet, ka GitHub Enterprise resursdatora nosaukums ir tikai resursdatora nosaukums, piemēram,
github.example.com.Ielīmējiet vai augšupielādējiet GitHub App privātās atslēgas PEM laukā GitHub App privātā atslēga.
Apstipriniet, ka ģenerētais tīmekļa aizķeres noslēpums ir pieejams.
Izveidojiet melnraksta lietotni.
Atveriet izveidotās melnraksta lietotnes informāciju ChatGPT un nokopējiet ģenerēto tīmekļa aizķeres URL.
Tīmekļa aizķeres URL jāizskatās šādi: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Pabeidziet tīmekļa aizķeres iestatīšanu GitHub Enterprise
Atgriezieties GitHub App iestatījumos pakalpojumā GitHub Enterprise.
Atveriet GitHub App vispārīgos iestatījumus.
Iespējojiet aktīvās tīmekļa aizķeres, ja tās vēl nav iespējotas.
Ielīmējiet ChatGPT tīmekļa aizķeres URL laukā Tīmekļa aizķeres URL.
Ielīmējiet ChatGPT tīmekļa aizķeres noslēpumu laukā Tīmekļa aizķeres noslēpums.
Atstājiet SSL verifikāciju iespējotu.
Apstipriniet, ka abonētie tīmekļa aizķeres notikumi atbilst iespējotajām atļaujām un darbībām.
Saglabājiet izmaiņas.
Publicējiet un pārvaldiet lietotni ChatGPT
Melnraksta lietotnes izveide automātiski nepadara to pieejamu dalībniekiem. Pēc melnraksta pārskatīšanas:
Publicējiet melnraksta lietotni.
Apstipriniet, ka lietotne parādās sadaļā Darbvietas iestatījumi > Lietotnes > Iespējots.
Konfigurējiet Lietotāju piekļuvi lomām, kurām tā jāizmanto.
Pārskatiet Darbību kontroli lasīšanas un rakstīšanas darbībām.
Pārskatiet Lietotņu atļaujas, lai izvēlētos, kad ChatGPT jautā dalībniekiem pirms lietotnes izmantošanas.
Palūdziet atļautam testa lietotājam atvērt Lietotnes ChatGPT un apstiprināt, ka lietotne parādās.
Šīs lietotņu atļaujas attiecas uz ChatGPT sarunām. Darbvietas aģenti izmanto katram aģentam noteiktas vadīklas, ko iestata aģenta veidotājs, lai noteiktu, kuras lietotnes darbības ir pieejamas un kad galalietotājiem tiek lūgts tās apstiprināt. Par aģentu darbību skatiet: ChatGPT darbvietas aģenti Enterprise un Business plāniem.
Instalējiet un testējiet GitHub App
Pakalpojumā GitHub Enterprise instalējiet GitHub App organizācijā vai kontā.
Izvēlieties visus repozitorijus vai atlasītus repozitorijus saskaņā ar darbvietas politiku.
Sāciet savienošanas plūsmu no ChatGPT kā atļauts lietotājs.
Autorizējiet GitHub lietotni, kad tiek prasīts.
Vispirms palaidiet nelielu lasīšanas darbību, piemēram, pieejamo repozitoriju uzskaitīšanu vai zināma atgādāšanas pieprasījuma izgūšanu.
Ja rakstīšanas darbības ir iespējotas, pirms plašākas ieviešanas testējiet ar zema riska repozitoriju.
Resursdatora nosaukums un OAuth darbība
ChatGPT izmanto resursdatora nosaukumu, lai atvasinātu GitHub Enterprise galapunktus. Ievadiet tikai resursdatoru, piemēram, github.example.com vai octocorp.ghe.com.
Neievadiet API ceļu, repozitorija ceļu vai github.com, ja vien tas nav precīzs GitHub Enterprise resursdators šai lietotnei.
Problēmu novēršana
Novirzīšanas URI neatbilstība: apstipriniet, ka GitHub App atzvana URL precīzi atbilst ChatGPT parādītajam atzvana URL.
ChatGPT nevar izveidot vai saglabāt melnraksta lietotni: apstipriniet, ka ir aizpildīti visi obligātie lauki, tostarp resursdatora nosaukums, OAuth klienta ID, OAuth klienta noslēpums, privātā atslēga un tīmekļa aizķeres noslēpums.
Autentifikācija izdodas, bet repozitorija izsaukumi neizdodas: apstipriniet, ka GitHub App ir instalēta un tai ir piekļuve repozitorijam.
API atgriež 403 vai nepietiekamas atļaujas: pievienojiet trūkstošo GitHub App atļauju un, ja tiek prasīts, lūdziet instalācijas īpašniekam apstiprināt atjauninātās atļaujas.
Repozitoriji neparādās: apstipriniet, ka lietotnes instalācija ietver paredzētos repozitorijus un ka lietotājam, kurš autorizē ChatGPT, ir tiem piekļuve.
Tīmekļa aizķeres piegādes neizdodas: apstipriniet, ka tīmekļa aizķeres URL un tīmekļa aizķeres noslēpums atbilst ChatGPT vērtībām, atstājiet SSL verifikāciju iespējotu un pārliecinieties, ka GitHub Enterprise resursdators var sasniegt
connectors.api.openai.org.Privātās atslēgas kļūdas: apstipriniet, ka ir nokopēts pilns PEM saturs, tostarp sākuma un beigu rindas.
