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: 7 days ago

Gambaran keseluruhan

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

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

Perkara yang anda sediakan

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

  • GitHub App yang didaftarkan pada hos GitHub Enterprise anda.

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

  • 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 kepada ChatGPT.

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

Cipta GitHub App, bukan GitHub OAuth App kendiri. Persediaan templat ChatGPT memerlukan bukti 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 boleh mencipta dan memasang GitHub Apps.

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

  • Keputusan tentang tindakan repositori yang patut 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 yang dipaparkan dalam ChatGPT.

Nilai yang perlu disediakan

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

  • URL panggil balik: salin ini 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 aplikasi draf dicipta dalam ChatGPT.

Mulakan persediaan templat dalam ChatGPT

  1. Dalam ChatGPT, beralih ke ruang kerja tempat aplikasi itu perlu tersedia.

  2. Buka Tetapan ruang kerja > Aplikasi.

  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 - Engineering.

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

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

  9. Salin rahsia webhook yang dijana jika ia dipaparkan semasa persediaan.

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

Jangan keluarkan ID panggil balik, menambah garis miring di hujung, atau menggantikannya dengan URL ChatGPT generik.

Cipta GitHub App dalam GitHub Enterprise

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

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

  3. Buka Settings > Developer settings > GitHub Apps.

  4. Pilih New GitHub App.

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

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

  7. Dalam Callback URL, tampal URL panggil balik tepat yang disalin daripada ChatGPT.

  8. Biarkan Expire user authorization tokens didayakan melainkan pasukan keselamatan anda mempunyai sebab khusus untuk mengubahnya.

  9. Dayakan Request user authorization during installation supaya pengguna boleh membenarkan aplikasi semasa aliran pemasangan atau penyambungan.

  10. Di bawah Where can this GitHub App be installed?, pilih pilihan paling terhad yang sesuai dengan pelancaran anda.

  11. Cipta GitHub App.

Konfigurasikan kebenaran dan peristiwa

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

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

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

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

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

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

  • Actions: baca sahaja, jika status larian aliran kerja, tugas, log atau artifak diperlukan.

Untuk aliran kerja tulis, tambah kebenaran tulis hanya apabila diperlukan, seperti Contents, Pull requests, Issues, Actions atau Workflows. Gunakan kebenaran paling terhad yang menyokong tindakan ChatGPT yang dimaksudkan.

Peristiwa webhook hendaklah sepadan dengan aliran kerja yang anda sokong. Peristiwa biasa termasuk Installation, Installation repositories, Push, Pull request, Issues, Issue comment, Workflow run dan Workflow job.

Jana dan salin bukti kelayakan GitHub App

  1. Dalam tetapan GitHub App, salin Client ID.

  2. Jana Client secret dan salinnya dengan segera.

  3. Di bawah Private keys, jana kunci peribadi.

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

  5. Buka fail .pem secara setempat dan salin teks PEM penuh, termasuk baris mula dan tamat.

Kunci peribadi itu sensitif. Kendalikannya seperti bukti kelayakan. Jika ia terdedah, jana kunci peribadi baharu, kemas kini persediaan aplikasi ChatGPT dan padam kunci yang terjejas dalam GitHub Enterprise.

Selesaikan persediaan dalam ChatGPT

  1. Kembali ke tab persediaan templat ChatGPT.

  2. Tampal Client ID GitHub App ke dalam OAuth client ID.

  3. Tampal Client secret GitHub App ke dalam OAuth client secret.

  4. Biarkan Scopes tidak berubah melainkan organisasi anda sengaja perlu mengatasi lalai templat.

  5. Sahkan nama hos GitHub Enterprise hanya mengandungi nama hos, seperti github.example.com.

  6. Tampal atau muat naik PEM kunci peribadi GitHub App ke dalam GitHub App private key.

  7. Sahkan rahsia webhook yang dijana tersedia.

  8. Cipta aplikasi draf.

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

URL webhook sepatutnya kelihatan seperti: 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 General GitHub App.

  3. Dayakan Active webhooks jika belum didayakan.

  4. Tampal URL webhook ChatGPT ke dalam Webhook URL.

  5. Tampal rahsia webhook ChatGPT ke dalam Webhook secret.

  6. Biarkan pengesahan SSL didayakan.

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

  8. Simpan perubahan.

Terbitkan dan urus aplikasi dalam ChatGPT

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

  1. Terbitkan aplikasi draf.

  2. Sahkan aplikasi muncul dalam Tetapan ruang kerja > Aplikasi > Didayakan.

  3. Konfigurasikan Akses pengguna untuk peranan yang sepatutnya menggunakannya.

  4. Semak Kawalan tindakan untuk tindakan baca dan tulis.

  5. Semak Kebenaran aplikasi untuk memilih masa ChatGPT meminta ahli sebelum menggunakan aplikasi.

  6. Minta pengguna ujian yang dibenarkan membuka Aplikasi dalam ChatGPT dan mengesahkan aplikasi muncul.

Kebenaran aplikasi ini terpakai kepada perbualan ChatGPT. Workspace Agents menggunakan kawalan setiap ejen yang ditetapkan oleh pembina ejen untuk menentukan tindakan aplikasi yang tersedia dan bila pengguna akhir diminta meluluskannya. Untuk tingkah laku ejen, lihat: ChatGPT Workspace Agents 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 daripada ChatGPT sebagai pengguna yang dibenarkan.

  4. Benarkan 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 pelancaran yang lebih luas.

Nama hos dan tingkah laku OAuth

ChatGPT menggunakan nama hos untuk mendapatkan 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 itu hos GitHub Enterprise yang tepat untuk aplikasi ini.

Penyelesaian masalah

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

  • ChatGPT tidak dapat mencipta atau menyimpan aplikasi draf: sahkan semua medan wajib tersedia, termasuk nama hos, OAuth client ID, OAuth client secret, kunci peribadi dan rahsia webhook.

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

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

  • Tiada repositori muncul: sahkan pemasangan aplikasi merangkumi repositori yang dijangka dan pengguna yang membenarkan dalam ChatGPT mempunyai akses kepadanya.

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

  • Ralat kunci peribadi: sahkan kandungan PEM penuh telah disalin, termasuk baris mula dan tamat.

Rujukan

Adakah artikel ini membantu?