Alamin kung paano maaaring i-configure ng mga workspace admin ang GitHub Enterprise app template sa ChatGPT gamit ang sariling GitHub App ng kanilang organisasyon.

Pangkalahatang-ideya

Gamitin ang gabay na ito kung isa kang admin ng ChatGPT workspace na nagse-set up ng GitHub Enterprise app template para sa iyong organisasyon. Ang template ay hindi ang pinal na app na ginagamit ng mga miyembro. Isa itong proseso ng pag-set up na gumagawa ng draft na app para sa isang partikular na workspace matapos mong ibigay ang kinakailangang configuration ng GitHub Enterprise.

Para sa GitHub Enterprise, ikinokonekta ng pag-set up ang ChatGPT sa GitHub Enterprise host ng iyong organisasyon. Gagawa ka ng GitHub App, irerehistro ang callback URL ng ChatGPT, bubuo ng mga credential, at pagkatapos ay ipe-paste ang mga value na iyon sa proseso ng pag-set up ng template sa ChatGPT. Matapos gawin ng ChatGPT ang draft na app, maaari mo itong i-publish at pamahalaan tulad ng ibang app sa workspace.

Para sa pag-navigate sa workspace at pag-access sa app, tingnan ang: Mga kontrol ng admin, seguridad, at pagsunod sa mga patakaran para sa mga plugin at app.

Ano ang ise-set up mo

Gagawa ka ng GitHub Enterprise app sa ChatGPT para sa isang partikular na workspace. Gumagamit ang app ng:

GitHub App na nakarehistro sa iyong GitHub Enterprise host.
Client ID at client secret ng GitHub App para sa awtorisasyon ng user sa pamamagitan ng OAuth.
Private key ng GitHub App para makabuo ang ChatGPT ng mga installation token para sa mga operasyon sa repository.
Webhook secret at webhook URL para maipadala ng GitHub Enterprise pabalik sa ChatGPT ang mga event ng pag-install at repository.
Hostname ng iyong GitHub Enterprise, gaya ng github.example.com.

Gumawa ng GitHub App, hindi ng hiwalay na GitHub OAuth App. Kailangan sa pag-set up ng template sa ChatGPT ang mga credential ng GitHub App, isang private key, at mga setting ng webhook.

Bago ka magsimula

Kailangan mo ng:

Access bilang admin o may-ari ng ChatGPT workspace.
Access bilang admin ng GitHub Enterprise o may-ari ng organisasyon na maaaring gumawa at mag-install ng mga GitHub App.
Hostname lang ng GitHub Enterprise, na walang https:// o path.
Desisyon kung aling mga aksyon sa repository ang dapat suportahan ng ChatGPT, gaya ng paghahanap sa repository nang walang pagbabago, mga workflow ng pull request, mga workflow ng isyu, pag-edit ng file, GitHub Actions, o mas malawak na mga workflow ng Codex.
Ligtas na lugar para pangasiwaan ang private key at client secret ng GitHub App.

Panatilihing bukas ang ChatGPT at GitHub Enterprise sa magkahiwalay na tab. Huwag mag-imbento ng callback URL. Kopyahin ang eksaktong callback URL na ipinapakita sa ChatGPT.

Mga value na ihahanda

Hostname ng GitHub Enterprise: halimbawa, github.example.com.
Callback URL: kopyahin ito mula sa proseso ng pag-set up ng template sa ChatGPT.
Client ID ng GitHub App.
Client secret ng GitHub App.
PEM ng private key ng GitHub App.
Webhook secret na binuo ng ChatGPT.
Webhook URL na nabuo matapos magawa ang draft na app sa ChatGPT.

Simulan ang pag-set up ng template sa ChatGPT

Sa ChatGPT, lumipat sa workspace kung saan dapat magamit ang app.
Buksan ang Mga setting ng workspace > Mga app. Maaari ka ring pumunta sa Console ng admin, piliin ang nilalayong ChatGPT workspace, at buksan ang Mga plugin. Piliin ang Pamahalaan ang mga legacy app para buksan ang pinanatiling page ng Mga app.
Piliin ang Direktoryo.
Hanapin ang GitHub Enterprise.
Piliin ang template ng GitHub Enterprise app at simulan ang pag-set up.
Maglagay ng malinaw na pangalan at paglalarawan ng app, gaya ng GitHub Enterprise o GitHub Enterprise - Engineering.
Ilagay ang hostname ng GitHub Enterprise, gaya ng github.example.com.
Kopyahin ang callback URL na ipinapakita sa ChatGPT. Panatilihing bukas ang tab na ito.
Kopyahin ang nabuong webhook secret kung ipinapakita ito habang nagse-set up.

Halimbawa ng callback URL: https://chatgpt.com/connector/oauth/<callback_id>

Huwag alisin ang callback ID, magdagdag ng slash sa dulo, o palitan ito ng pangkalahatang ChatGPT URL.

Gawin ang GitHub App sa GitHub Enterprise

Buksan ang iyong GitHub Enterprise host, gaya ng https://github.example.com.
Pumunta sa organisasyon o account na dapat magmay-ari ng app.
Buksan ang Mga Setting > Mga setting ng developer > Mga GitHub App.
Piliin ang Bagong GitHub App.
Maglagay ng malinaw na pangalan ng app, gaya ng ChatGPT GitHub Enterprise.
Maglagay ng URL ng homepage. Kung walang nakalaang panloob na pahina, gamitin ang URL ng organisasyon sa GitHub Enterprise.
Sa Callback URL, i-paste ang eksaktong callback URL na kinopya mula sa ChatGPT.
Panatilihing naka-enable ang opsyong Mag-expire ang mga token ng awtorisasyon ng user maliban kung may partikular na dahilan ang iyong security team para baguhin ito.
I-enable ang Humingi ng awtorisasyon ng user habang nag-i-install para mapahintulutan ng mga user ang app habang ini-install o ikinokonekta ito.
Sa ilalim ng Saan puwedeng i-install ang GitHub App na ito?, piliin ang opsyong may pinakamakitid na saklaw na angkop sa iyong rollout.
Gawin ang GitHub App.

I-configure ang mga pahintulot at event

Piliin ang pinakamababang antas ng mga pahintulot na kailangan para sa mga aksyon ng ChatGPT na plano mong i-enable.

Para sa paghahanap ng repository at pagtatanong at pagsagot na walang ginagawang pagbabago, magsimula sa mga pahintulot sa pagbasa gaya ng:

Metadata: pagbasa lang. Kinakailangan ng GitHub ang metadata para sa mga GitHub App.
Mga nilalaman: pagbasa lang, para ma-access ang nilalaman ng mga file at repository.
Mga isyu: pagbasa lang, kung kailangang maghanap o magbasa ng mga isyu.
Mga pull request: pagbasa lang, kung kailangan ang paghahanap ng pull request o konteksto para sa pagsusuri.
Mga aksyon: pagbasa lang, kung kailangan ang status ng pagpapatakbo ng workflow, mga job, log, o artifact.

Para sa mga workflow na may pagsusulat, magdagdag lang ng pahintulot sa pagsusulat kung saan kailangan, gaya ng Mga nilalaman, Mga pull request, Mga isyu, Mga aksyon, o Mga workflow. Gamitin ang pinakamakitid na saklaw ng mga pahintulot na sapat para sa mga nilalayong aksyon ng ChatGPT.

Dapat tumugma ang mga webhook event sa mga workflow na sinusuportahan mo. Kabilang sa mga karaniwang event ang Pag-install, Mga repository ng installation, Push, Pull request, Mga isyu, Komento sa isyu, Pagpapatakbo ng workflow, at Job ng workflow.

Bumuo at kumopya ng mga credential ng GitHub App

Sa mga setting ng GitHub App, kopyahin ang Client ID.
Bumuo ng Client secret at kopyahin ito agad.
Sa ilalim ng Mga private key, bumuo ng private key.
I-download ang .pem file at itago ito nang ligtas.
Buksan ang .pem file sa iyong device at kopyahin ang buong teksto ng PEM, kabilang ang mga linyang panimula at pangwakas.

Sensitibong impormasyon ang private key. Ingatan ito tulad ng isang credential. Kung malantad ito, bumuo ng bagong private key, i-update ang pag-set up ng app sa ChatGPT, at tanggalin ang nakompromisong key sa GitHub Enterprise.

Tapusin ang pag-set up sa ChatGPT

Bumalik sa tab ng pag-set up ng template sa ChatGPT.
I-paste ang Client ID ng GitHub App sa Client ID ng OAuth.
I-paste ang client secret ng GitHub App sa Client secret ng OAuth.
Huwag baguhin ang Mga saklaw maliban kung sadyang kailangang palitan ng iyong organisasyon ang mga default ng template.
Tiyaking hostname lang ang nakalagay para sa GitHub Enterprise, gaya ng github.example.com.
I-paste o i-upload ang PEM ng private key ng GitHub App sa Private key ng GitHub App.
Tiyaking nakalagay ang nabuong webhook secret.
Gawin ang draft na app.
Buksan sa ChatGPT ang mga detalye ng ginawang draft na app at kopyahin ang nabuong webhook URL.

Dapat ganito ang anyo ng webhook URL: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Tapusin ang pag-set up ng webhook sa GitHub Enterprise

Bumalik sa mga setting ng GitHub App sa GitHub Enterprise.
Buksan ang Pangkalahatang mga setting ng GitHub App.
I-enable ang Mga aktibong webhook kung hindi pa naka-enable ang mga ito.
I-paste ang webhook URL ng ChatGPT sa URL ng webhook.
I-paste ang webhook secret ng ChatGPT sa Webhook secret.
Panatilihing naka-enable ang pag-verify ng SSL.
Tiyaking tumutugma ang mga naka-subscribe na webhook event sa mga pahintulot at aksyon na na-enable mo.
I-save ang mga pagbabago.

I-publish at pamahalaan ang app sa ChatGPT

Hindi awtomatikong magagamit ng mga miyembro ang app kapag ginawa ang draft nito. Pagkatapos suriin ang draft:

I-publish ang draft ng app.
Sa mga setting ng workspace, buksan ang pahinang Mga App, buksan ang Naka-enable, at tiyaking nakalista ang app. Maaari mo ring buksan ang pahinang Mga App gamit ang Pamahalaan ang mga Legacy App sa Admin Console > Mga Plugin.
Sa Enterprise at Edu, gamitin ang Access ng user para piliin kung aling mga tungkulin ang maaaring gumamit ng app. Sa Business, pamahalaan kung magagamit ang app sa buong workspace.
Suriin ang Kontrol sa mga aksyon para sa mga aksyon sa pagbasa at pagsulat.
Suriin ang Mga pahintulot ng app para piliin kung kailan hihingi ng pahintulot ang ChatGPT sa mga miyembro bago gamitin ang app.
Hilingin sa isang test user na may access na buksan ang Mga App sa ChatGPT at tiyaking nakalista ang app.

Nalalapat ang mga pahintulot na ito ng app sa mga pag-uusap sa ChatGPT. Gumagamit ang mga agent sa workspace ng mga kontrol para sa bawat agent na itinakda ng gumawa nito para matukoy kung aling mga aksyon ng app ang magagamit at kung kailan hihingan ng pag-apruba ang mga end user. Para sa impormasyon tungkol sa paggana ng agent, tingnan ang: Mga Agent sa Workspace ng ChatGPT para sa Enterprise at Business.

I-install at subukan ang GitHub App

Sa GitHub Enterprise, i-install ang GitHub app sa organisasyon o account.
Piliin ang lahat ng repository o mga piling repository ayon sa patakaran ng workspace.
Bilang user na may pahintulot, simulan ang proseso ng pagkonekta mula sa ChatGPT.
Bigyan ng awtorisasyon ang GitHub app kapag hiningi ito.
Magsagawa muna ng simpleng aksyon sa pagbasa, gaya ng paglilista ng mga naa-access na repository o pagkuha ng isang kilalang pull request.
Kung naka-enable ang mga aksyon sa pagsusulat, subukan muna sa isang repository na mababa ang panganib bago ito ipagamit nang mas malawakan.

Hostname at paggana ng OAuth

Ginagamit ng ChatGPT ang hostname para matukoy ang mga endpoint ng GitHub Enterprise. Host lang ang ilagay, gaya ng github.example.com o octocorp.ghe.com.

Huwag maglagay ng API path, repository path, o github.com maliban kung iyon ang eksaktong GitHub Enterprise host para sa app na ito.

Pag-troubleshoot

Hindi tugma ang redirect URI: tiyaking eksaktong tumutugma ang callback URL ng GitHub App sa callback URL na ipinapakita sa ChatGPT.
Hindi magawa o ma-save ng ChatGPT ang draft na app: tiyaking napunan ang lahat ng kinakailangang field, kabilang ang hostname, Client ID ng OAuth, Client secret ng OAuth, private key, at webhook secret.
Matagumpay ang pagpapatunay pero nabibigo ang mga tawag sa repository: tiyaking naka-install ang GitHub App at may access ito sa repository.
Nagbabalik ang API ng 403 o hindi sapat na pahintulot: idagdag ang nawawalang pahintulot ng GitHub App at ipaapruba sa may-ari ng installation ang mga na-update na pahintulot kung hihilingin.
Walang lumalabas na repository: tiyaking kasama sa pag-install ng app ang mga inaasahang repository at may access sa mga ito ang user na nagbibigay ng awtorisasyon sa ChatGPT.
Nabibigo ang pagpapadala ng webhook: tiyaking tumutugma ang webhook URL at webhook secret sa mga value mula sa ChatGPT, panatilihing naka-enable ang pag-verify ng SSL, at tiyaking makakonekta ang GitHub Enterprise host sa connectors.api.openai.org.
Mga error sa private key: tiyaking nakopya ang buong nilalaman ng PEM, kabilang ang mga linyang panimula at pangwakas.

I-set up ang GitHub Enterprise app template sa ChatGPT