OpenAI
Ang page na ito ay isinalin ng AI. Tingnan ang orihinal na artikulo sa English.

I-set up ang GitHub Enterprise app template sa ChatGPT

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.

Na-update: 21 days ago

Pangkalahatang-ideya

Gamitin ang gabay na ito kung ikaw ay 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. Ito ay setup flow na gumagawa ng draft app na partikular sa workspace pagkatapos mong ibigay ang kinakailangang configuration ng GitHub Enterprise.

Para sa GitHub Enterprise, ikinokonekta ng setup ang ChatGPT sa GitHub Enterprise host ng iyong organisasyon. Gumagawa ka ng GitHub App, nirerehistro ang ChatGPT callback URL, gumagawa ng mga kredensyal, at pagkatapos ay i-paste ang mga value na iyon sa setup flow ng template sa ChatGPT. Pagkatapos gawin ng ChatGPT ang draft app, maaari mo itong i-publish at pamahalaan tulad ng ibang workspace apps.

Ang ise-set up mo

Gumagawa ka ng GitHub Enterprise app na partikular sa workspace sa ChatGPT. Gumagamit ang app ng:

  • GitHub App na nakarehistro sa iyong GitHub Enterprise host.

  • Ang client ID at client secret ng GitHub App para sa OAuth authorization ng user.

  • Ang private key ng GitHub App para makagawa ang ChatGPT ng installation tokens para sa mga operasyon sa repository.

  • Webhook secret at webhook URL para makapagpadala ang GitHub Enterprise ng mga event ng installation at repository pabalik sa ChatGPT.

  • Ang hostname ng iyong GitHub Enterprise, gaya ng github.example.com.

Gumawa ng GitHub App, hindi standalone na GitHub OAuth App. Kinakailangan ng pag-set up ng template sa ChatGPT ang mga kredensyal ng GitHub App, private key, at mga setting ng webhook.

Bago ka magsimula

Kailangan mo ng:

  • Access bilang admin o owner ng ChatGPT workspace.

  • Access bilang admin ng GitHub Enterprise o owner ng organisasyon na maaaring gumawa at mag-install ng GitHub Apps.

  • Ang hostname lang ng GitHub Enterprise, nang walang https:// o path.

  • Desisyon kung aling mga aksyon sa repository ang dapat suportahan ng ChatGPT, gaya ng read-only na paghahanap sa repository, mga workflow ng pull request, mga workflow ng isyu, pag-edit ng file, GitHub Actions, o mas malawak na Codex workflows.

  • Secure 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 gumawa-gawa 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 setup flow ng template sa ChatGPT.

  • Client ID ng GitHub App.

  • Client secret ng GitHub App.

  • Private key PEM ng GitHub App.

  • Webhook secret na ginawa ng ChatGPT.

  • Webhook URL na ginawa pagkatapos magawa ang draft app sa ChatGPT.

Simulan ang pag-set up ng template sa ChatGPT

  1. Sa ChatGPT, lumipat sa workspace kung saan dapat maging available ang app.

  2. Buksan ang Mga setting ng workspace > Mga app.

  3. Piliin ang Direktoryo.

  4. Hanapin ang GitHub Enterprise.

  5. Piliin ang template ng GitHub Enterprise app at simulan ang pag-set up.

  6. Maglagay ng malinaw na pangalan at paglalarawan ng app, gaya ng GitHub Enterprise o GitHub Enterprise - Engineering.

  7. Ilagay ang hostname ng GitHub Enterprise, gaya ng github.example.com.

  8. Kopyahin ang callback URL na ipinapakita sa ChatGPT. Panatilihing bukas ang tab na ito.

  9. Kopyahin ang nabuong webhook secret kung ipinapakita ito habang nagse-set up.

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

Huwag alisin ang callback ID, magdagdag ng trailing slash, o palitan ito ng generic na ChatGPT URL.

Gawin ang GitHub App sa GitHub Enterprise

  1. Buksan ang iyong GitHub Enterprise host, gaya ng https://github.example.com.

  2. Pumunta sa organisasyon o account na dapat magmay-ari ng app.

  3. Buksan ang Mga Setting > Mga setting ng developer > GitHub Apps.

  4. Piliin ang Bagong GitHub App.

  5. Maglagay ng malinaw na pangalan ng app, gaya ng ChatGPT GitHub Enterprise Connector.

  6. Maglagay ng homepage URL. Kung walang nakalaang internal page, gamitin ang URL ng organisasyon sa GitHub Enterprise.

  7. Sa Callback URL, i-paste ang eksaktong callback URL na kinopya mula sa ChatGPT.

  8. Panatilihing naka-enable ang Expire user authorization tokens maliban kung may partikular na dahilan ang iyong security team para baguhin ito.

  9. I-enable ang Request user authorization during installation para ma-authorize ng mga user ang app habang nag-i-install o kumokonekta.

  10. Sa ilalim ng Saan maaaring i-install ang GitHub App na ito?, piliin ang pinakamakitid na opsyong akma sa iyong rollout.

  11. Gawin ang GitHub App.

I-configure ang mga pahintulot at event

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

Para sa read-only na pagtuklas ng repository at Q&A, magsimula sa mga pahintulot sa pagbasa gaya ng:

  • Metadata: read-only. Kinakailangan ng GitHub ang metadata para sa GitHub Apps.

  • Mga Nilalaman: read-only, para sa access sa file at nilalaman ng repository.

  • Mga Isyu: read-only, kung kailangan ang paghahanap o pagbasa ng isyu.

  • Mga pull request: read-only, kung kailangan ang paghahanap ng pull request o konteksto ng review.

  • Mga Aksyon: read-only, kung kailangan ang status ng workflow run, mga job, log, o artifact.

Para sa mga write workflow, magdagdag lang ng write permissions kung kailangan, gaya ng Contents, Pull requests, Issues, Actions, o Workflows. Gamitin ang pinakamakitid na pahintulot na sumusuporta sa nilalayong mga aksyon sa ChatGPT.

Dapat tumugma ang mga webhook event sa mga workflow na sinusuportahan mo. Kasama sa karaniwang event ang Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run, at Workflow job.

Gumawa at kopyahin ang mga kredensyal ng GitHub App

  1. Sa mga setting ng GitHub App, kopyahin ang Client ID.

  2. Gumawa ng Client secret at kopyahin ito kaagad.

  3. Sa ilalim ng Mga private key, gumawa ng private key.

  4. I-download ang .pem file at itago ito nang secure.

  5. Buksan ang .pem file nang lokal at kopyahin ang buong PEM text, kasama ang mga linya ng begin at end.

Sensitibo ang private key. Tratuhin ito tulad ng kredensyal. Kung malantad ito, gumawa ng bagong private key, i-update ang pag-set up ng ChatGPT app, at tanggalin ang nakompromisong key sa GitHub Enterprise.

Tapusin ang pag-set up sa ChatGPT

  1. Bumalik sa tab ng pag-set up ng template sa ChatGPT.

  2. I-paste ang GitHub App Client ID sa OAuth client ID.

  3. I-paste ang GitHub App Client secret sa OAuth client secret.

  4. Huwag baguhin ang Scopes maliban kung sadyang kailangang i-override ng iyong organisasyon ang mga default ng template.

  5. Kumpirmahing hostname lang ang hostname ng GitHub Enterprise, gaya ng github.example.com.

  6. I-paste o i-upload ang private key PEM ng GitHub App sa GitHub App private key.

  7. Kumpirmahing naroon ang nabuong webhook secret.

  8. Gawin ang draft app.

  9. Buksan ang mga detalye ng ginawang draft app sa ChatGPT at kopyahin ang nabuong webhook URL.

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

Tapusin ang pag-set up ng webhook sa GitHub Enterprise

  1. Bumalik sa mga setting ng GitHub App sa GitHub Enterprise.

  2. Buksan ang General settings ng GitHub App.

  3. I-enable ang Active webhooks kung hindi pa naka-enable ang mga ito.

  4. I-paste ang ChatGPT webhook URL sa Webhook URL.

  5. I-paste ang ChatGPT webhook secret sa Webhook secret.

  6. Panatilihing naka-enable ang SSL verification.

  7. Kumpirmahing tumutugma ang mga naka-subscribe na webhook event sa mga pahintulot at aksyong in-enable mo.

  8. I-save ang mga pagbabago.

I-publish at pamahalaan ang app sa ChatGPT

Ang paggawa ng draft app ay hindi awtomatikong ginagawa itong available sa mga miyembro. Pagkatapos suriin ang draft:

  1. I-publish ang draft app.

  2. Kumpirmahing lumalabas ang app sa Mga setting ng workspace > Mga app > Naka-enable.

  3. I-configure ang Access ng user para sa mga tungkuling dapat gumamit nito.

  4. Suriin ang Kontrol sa aksyon para sa mga aksyon sa pagbasa at pagsulat.

  5. Suriin ang Mga pahintulot ng app para piliin kung kailan tatanungin ng ChatGPT ang mga miyembro bago gamitin ang app.

  6. Hilingin sa isang pinapayagang test user na buksan ang Mga app sa ChatGPT at kumpirmahing lumalabas ang app.

Nalalapat ang mga pahintulot ng app na ito sa mga pag-uusap sa ChatGPT. Gumagamit ang Workspace Agents ng mga kontrol na pang-agent na itinakda ng builder ng agent para matukoy kung aling mga aksyon ng app ang available at kung kailan hihingan ng pag-apruba ang mga end user. Para sa gawi ng agent, tingnan ang: ChatGPT Workspace Agents para sa Enterprise at Business.

I-install at subukan ang GitHub App

  1. Sa GitHub Enterprise, i-install ang GitHub app sa organisasyon o account.

  2. Piliin ang lahat ng repository o mga napiling repository ayon sa patakaran ng workspace.

  3. Simulan ang connect flow mula sa ChatGPT bilang pinapayagang user.

  4. I-authorize ang GitHub app kapag na-prompt.

  5. Magpatakbo muna ng maliit na read action, gaya ng paglilista ng accessible na mga repository o pagkuha ng kilalang pull request.

  6. Kung naka-enable ang mga write action, subukan muna sa low-risk na repository bago ang mas malawak na rollout.

Gawi ng hostname at OAuth

Ginagamit ng ChatGPT ang hostname para makuha ang mga endpoint ng GitHub Enterprise. Ilagay lang ang host, 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: kumpirmahing eksaktong tumutugma ang callback URL ng GitHub App sa callback URL na ipinapakita sa ChatGPT.

  • Hindi magawa o ma-save ng ChatGPT ang draft app: kumpirmahing naroon ang lahat ng kinakailangang field, kabilang ang hostname, OAuth client ID, OAuth client secret, private key, at webhook secret.

  • Matagumpay ang authentication ngunit nabibigo ang mga tawag sa repository: kumpirmahing naka-install ang GitHub App at may access ito sa repository.

  • Nagbabalik ang API ng 403 o kulang ang mga pahintulot: idagdag ang nawawalang pahintulot ng GitHub App at ipaapruba sa owner ng installation ang mga na-update na pahintulot kung na-prompt.

  • Walang lumalabas na repository: kumpirmahing kasama sa installation ng app ang inaasahang mga repository at may access sa mga ito ang user na nag-a-authorize sa ChatGPT.

  • Nabibigo ang mga webhook delivery: kumpirmahing tumutugma ang webhook URL at webhook secret sa mga value mula sa ChatGPT, panatilihing naka-enable ang SSL verification, at tiyaking naaabot ng GitHub Enterprise host ang connectors.api.openai.org.

  • Mga error sa private key: kumpirmahing nakopya ang buong nilalaman ng PEM, kasama ang mga linya ng begin at end.

Mga Sanggunian

Nakatulong ba ang artikulong ito?