OpenAI
Halaman ini diterjemah oleh mesin. Lihat artikel asal dalam bahasa Inggeris.

Sediakan templat aplikasi GitHub Enterprise dalam ChatGPT

Ketahui cara pentadbir ruang kerja boleh mengkonfigurasi templat aplikasi GitHub Enterprise dalam ChatGPT menggunakan GitHub App milik organisasi mereka sendiri.

Dikemas kini: 5 days ago

Gambaran keseluruhan

Gunakan panduan ini jika anda pentadbir ruang kerja ChatGPT yang menyediakan templat aplikasi GitHub Enterprise untuk organisasi anda. Templat bukanlah aplikasi akhir yang digunakan oleh ahli. Templat ialah aliran persediaan yang mencipta draf aplikasi khusus untuk ruang kerja selepas anda memberikan konfigurasi GitHub Enterprise yang diperlukan.

Bagi GitHub Enterprise, persediaan ini menghubungkan ChatGPT dengan hos GitHub Enterprise organisasi anda. Anda mencipta GitHub App, mendaftarkan URL panggil balik ChatGPT, menjana kelayakan, kemudian menampalkan nilai tersebut ke dalam aliran persediaan templat ChatGPT. Selepas ChatGPT mencipta draf aplikasi, anda boleh menerbitkan dan mengurusnya seperti aplikasi ruang kerja yang lain.

Untuk navigasi ruang kerja dan akses aplikasi, lihat: Kawalan pentadbir, keselamatan dan pematuhan untuk pemalam dan aplikasi.

Perkara yang anda sediakan

Anda sedang mencipta aplikasi GitHub Enterprise khusus untuk ruang kerja dalam ChatGPT. Aplikasi ini menggunakan:

  • GitHub App yang didaftarkan pada hos GitHub Enterprise anda.

  • ID klien dan rahsia klien GitHub App untuk pemberian kebenaran pengguna melalui OAuth.

  • Kunci peribadi GitHub App supaya ChatGPT boleh menjana token pemasangan untuk operasi repositori.

  • Rahsia webhook dan URL webhook supaya GitHub Enterprise boleh menghantar peristiwa pemasangan dan repositori kembali ke ChatGPT.

  • Nama hos GitHub Enterprise anda, seperti github.example.com.

Cipta GitHub App, bukan GitHub OAuth App kendiri. Persediaan templat ChatGPT memerlukan kelayakan GitHub App, kunci peribadi dan tetapan webhook.

Sebelum anda bermula

Anda memerlukan:

  • Akses pentadbir atau pemilik ruang kerja ChatGPT.

  • Akses pentadbir GitHub Enterprise atau pemilik organisasi yang membolehkan anda mencipta dan memasang GitHub Apps.

  • Nama hos GitHub Enterprise sahaja, tanpa https:// atau laluan.

  • Keputusan tentang tindakan repositori yang perlu disokong oleh ChatGPT, seperti carian repositori baca sahaja, aliran kerja pull request, aliran kerja isu, suntingan fail, GitHub Actions atau aliran kerja Codex yang lebih luas.

  • Tempat yang selamat untuk mengendalikan kunci peribadi dan rahsia klien GitHub App.

Biarkan ChatGPT dan GitHub Enterprise terbuka dalam tab berasingan. Jangan reka URL panggil balik sendiri. Salin URL panggil balik tepat seperti yang ditunjukkan dalam ChatGPT.

Nilai yang perlu disediakan

  • Nama hos GitHub Enterprise: contohnya, github.example.com.

  • URL panggil balik: salin daripada aliran persediaan templat ChatGPT.

  • ID klien GitHub App.

  • Rahsia klien GitHub App.

  • PEM kunci peribadi GitHub App.

  • Rahsia webhook yang dijana oleh ChatGPT.

  • URL webhook yang dijana selepas draf aplikasi dicipta dalam ChatGPT.

Mulakan persediaan templat dalam ChatGPT

  1. Dalam ChatGPT, beralih ke ruang kerja yang sepatutnya menyediakan aplikasi tersebut.

  2. Buka Tetapan ruang kerja > Aplikasi. Anda juga boleh pergi ke Konsol Pentadbir, pilih ruang kerja ChatGPT yang dimaksudkan dan buka Pemalam. Pilih Urus Aplikasi Legasi untuk membuka halaman Aplikasi yang masih dikekalkan.

  3. Pilih Direktori.

  4. Cari GitHub Enterprise.

  5. Pilih templat aplikasi GitHub Enterprise dan mulakan persediaan.

  6. Masukkan nama dan perihalan aplikasi yang jelas, seperti GitHub Enterprise atau GitHub Enterprise - Kejuruteraan.

  7. Masukkan nama hos GitHub Enterprise, seperti github.example.com.

  8. Salin URL panggil balik yang ditunjukkan dalam ChatGPT. Biarkan tab ini terbuka.

  9. Salin rahsia webhook yang dijana jika rahsia itu ditunjukkan semasa persediaan.

Contoh URL panggil balik: https://chatgpt.com/connector/oauth/<callback_id>

Jangan buang ID panggil balik, tambah garis miring di hujung atau gantikan URL itu dengan URL ChatGPT umum.

Cipta Aplikasi GitHub dalam GitHub Enterprise

  1. Buka hos GitHub Enterprise anda, seperti https://github.example.com.

  2. Pergi ke organisasi atau akaun yang sepatutnya memiliki aplikasi itu.

  3. Buka Tetapan > Tetapan pembangun > Aplikasi GitHub.

  4. Pilih Aplikasi GitHub Baharu.

  5. Masukkan nama aplikasi yang jelas, seperti ChatGPT GitHub Enterprise.

  6. Masukkan URL halaman utama. Jika tiada halaman dalaman khusus, gunakan URL organisasi GitHub Enterprise.

  7. Dalam URL panggil balik, tampal URL panggil balik yang disalin daripada ChatGPT tanpa sebarang perubahan.

  8. Pastikan tetapan Tamatkan tempoh token kebenaran pengguna kekal didayakan melainkan pasukan keselamatan anda mempunyai sebab khusus untuk mengubahnya.

  9. Dayakan Minta kebenaran pengguna semasa pemasangan supaya pengguna boleh memberikan kebenaran kepada aplikasi semasa proses pemasangan atau penyambungan.

  10. Pada bahagian “Di manakah Aplikasi GitHub ini boleh dipasang?”, pilih pilihan dengan skop paling terhad yang sesuai dengan pelaksanaan anda.

  11. Cipta Aplikasi GitHub.

Konfigurasikan kebenaran dan peristiwa

Pilih kebenaran minimum yang diperlukan untuk tindakan ChatGPT yang anda rancang untuk dayakan.

Untuk penemuan repositori dan soal jawab baca sahaja, mulakan dengan kebenaran baca seperti:

  • Metadata: baca sahaja. GitHub memerlukan metadata untuk GitHub Apps.

  • Kandungan: baca sahaja, untuk akses kepada kandungan fail dan repositori.

  • Isu: baca sahaja, jika carian atau pembacaan isu diperlukan.

  • Pull request: baca sahaja, jika carian pull request atau konteks semakan diperlukan.

  • Tindakan: baca sahaja, jika status pelaksanaan aliran kerja, tugas, log atau artifak diperlukan.

Untuk aliran kerja tulis, tambahkan kebenaran tulis hanya apabila diperlukan, seperti Kandungan, Pull request, Isu, Tindakan atau Aliran kerja. Gunakan kebenaran paling terhad yang menyokong tindakan ChatGPT yang dimaksudkan.

Peristiwa webhook hendaklah sepadan dengan aliran kerja yang anda sokong. Peristiwa lazim termasuk Pemasangan, Repositori pemasangan, Tolakan, Pull request, Isu, Komen isu, Pelaksanaan aliran kerja dan Tugas aliran kerja.

Jana dan salin kelayakan GitHub App

  1. Dalam tetapan GitHub App, salin ID klien.

  2. Jana Rahsia klien dan salin dengan segera.

  3. Di bawah Kunci peribadi, jana kunci peribadi.

  4. Muat turun fail .pem dan simpan dengan selamat.

  5. Buka fail .pem pada peranti anda dan salin keseluruhan teks PEM, termasuk baris permulaan dan penamat.

Kunci peribadi ialah maklumat sensitif. Kendalikan kunci ini seperti kelayakan. Jika kunci ini terdedah, jana kunci peribadi baharu, kemas kini persediaan aplikasi ChatGPT dan padamkan kunci yang terjejas dalam GitHub Enterprise.

Selesaikan persediaan dalam ChatGPT

  1. Kembali ke tab persediaan templat ChatGPT.

  2. Tampalkan ID klien GitHub App ke dalam ID klien OAuth.

  3. Tampalkan rahsia klien GitHub App ke dalam Rahsia klien OAuth.

  4. Biarkan Skop tidak berubah melainkan organisasi anda memang perlu menggantikan tetapan lalai templat.

  5. Pastikan nama hos GitHub Enterprise mengandungi nama hos sahaja, seperti github.example.com.

  6. Tampalkan atau muat naik PEM kunci peribadi GitHub App ke dalam Kunci peribadi GitHub App.

  7. Pastikan rahsia webhook yang dijana sudah diisi.

  8. Cipta draf aplikasi.

  9. Buka butiran draf aplikasi yang telah dicipta dalam ChatGPT dan salin URL webhook yang dijana.

URL webhook sepatutnya dalam bentuk ini: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Selesaikan persediaan webhook dalam GitHub Enterprise

  1. Kembali ke tetapan GitHub App dalam GitHub Enterprise.

  2. Buka tetapan Umum GitHub App.

  3. Dayakan Webhook aktif jika belum didayakan.

  4. Tampalkan URL webhook ChatGPT ke dalam URL webhook.

  5. Tampalkan rahsia webhook ChatGPT ke dalam Rahsia webhook.

  6. Kekalkan pengesahan SSL didayakan.

  7. Pastikan peristiwa webhook yang dilanggan sepadan dengan kebenaran dan tindakan yang anda dayakan.

  8. Simpan perubahan.

Terbitkan dan urus aplikasi dalam ChatGPT

Mencipta draf aplikasi tidak menjadikannya tersedia kepada ahli secara automatik. Selepas menyemak draf:

  1. Terbitkan draf aplikasi.

  2. Dalam tetapan ruang kerja, buka halaman Aplikasi, buka Didayakan, dan pastikan aplikasi itu dipaparkan. Anda juga boleh membuka halaman Aplikasi melalui Urus Aplikasi Legasi dalam Konsol Pentadbir > Pemalam.

  3. Dalam Enterprise dan Edu, gunakan Akses pengguna untuk memilih peranan yang boleh menggunakan aplikasi itu. Dalam Business, urus ketersediaan aplikasi di seluruh ruang kerja.

  4. Semak Kawalan tindakan untuk tindakan baca dan tulis.

  5. Semak Kebenaran aplikasi untuk memilih bila ChatGPT perlu meminta kebenaran ahli sebelum menggunakan aplikasi itu.

  6. Minta pengguna ujian yang diberi akses untuk membuka Aplikasi dalam ChatGPT dan memastikan aplikasi itu dipaparkan.

Kebenaran aplikasi ini terpakai pada perbualan ChatGPT. Ejen Ruang Kerja menggunakan kawalan khusus bagi setiap ejen yang ditetapkan oleh pembinanya untuk menentukan tindakan aplikasi yang tersedia dan bila pengguna akhir diminta meluluskan tindakan tersebut. Untuk mengetahui cara ejen bertindak, lihat: Ejen Ruang Kerja ChatGPT untuk Enterprise dan Business.

Pasang dan uji GitHub App

  1. Dalam GitHub Enterprise, pasang aplikasi GitHub pada organisasi atau akaun.

  2. Pilih semua repositori atau repositori terpilih mengikut dasar ruang kerja.

  3. Mulakan aliran penyambungan dari ChatGPT sebagai pengguna yang dibenarkan.

  4. Berikan kebenaran kepada aplikasi GitHub apabila diminta.

  5. Jalankan tindakan baca kecil dahulu, seperti menyenaraikan repositori yang boleh diakses atau mendapatkan pull request yang diketahui.

  6. Jika tindakan tulis didayakan, uji dengan repositori berisiko rendah sebelum meluaskan penggunaannya.

Nama hos dan cara OAuth berfungsi

ChatGPT menggunakan nama hos untuk menentukan titik akhir GitHub Enterprise. Masukkan hos sahaja, seperti github.example.com atau octocorp.ghe.com.

Jangan masukkan laluan API, laluan repositori atau github.com melainkan itulah hos GitHub Enterprise sebenar untuk aplikasi ini.

Penyelesaian masalah

  • URI ubah hala tidak sepadan: pastikan URL panggil balik GitHub App sepadan tepat dengan URL panggil balik yang ditunjukkan dalam ChatGPT.

  • ChatGPT tidak dapat mencipta atau menyimpan draf aplikasi: pastikan semua medan wajib telah diisi, termasuk nama hos, ID klien OAuth, Rahsia klien OAuth, kunci peribadi dan rahsia webhook.

  • Pengesahan berjaya tetapi panggilan repositori gagal: pastikan GitHub App telah dipasang dan mempunyai akses kepada repositori.

  • API mengembalikan 403 atau kebenaran tidak mencukupi: tambahkan kebenaran GitHub App yang belum diberikan dan minta pemilik pemasangan meluluskan kebenaran yang dikemas kini jika diminta.

  • Tiada repositori dipaparkan: pastikan pemasangan aplikasi merangkumi repositori yang dijangka dan pengguna yang memberikan kebenaran dalam ChatGPT mempunyai akses kepadanya.

  • Penghantaran webhook gagal: pastikan URL webhook dan rahsia webhook sepadan dengan nilai daripada ChatGPT, kekalkan pengesahan SSL didayakan dan pastikan hos GitHub Enterprise boleh mencapai connectors.api.openai.org.

  • Ralat kunci peribadi: pastikan keseluruhan kandungan PEM telah disalin, termasuk baris permulaan dan penamat.

Rujukan

Adakah artikel ini membantu?