OpenAI
Halaman ini diterjemahkan oleh mesin. Lihat artikel asli dalam bahasa Inggris.

Siapkan templat aplikasi GitHub Enterprise di ChatGPT

Pelajari cara admin workspace mengonfigurasi templat aplikasi GitHub Enterprise di ChatGPT menggunakan Aplikasi GitHub milik organisasi mereka sendiri.

Diperbarui: 4 days ago

Gambaran umum

Gunakan panduan ini jika Anda adalah admin workspace ChatGPT yang sedang menyiapkan template aplikasi GitHub Enterprise untuk organisasi Anda. Template bukanlah aplikasi akhir yang digunakan anggota. Template adalah alur penyiapan yang membuat draf aplikasi khusus workspace setelah Anda memasukkan konfigurasi GitHub Enterprise yang diperlukan.

Untuk GitHub Enterprise, proses penyiapan menghubungkan ChatGPT ke host GitHub Enterprise organisasi Anda. Anda membuat GitHub App, mendaftarkan URL callback ChatGPT, membuat kredensial, lalu menempelkan nilai-nilai tersebut ke alur penyiapan template ChatGPT. Setelah ChatGPT membuat draf aplikasi, Anda dapat memublikasikan dan mengelolanya seperti aplikasi workspace lainnya.

Untuk navigasi workspace dan akses aplikasi, lihat: Kontrol admin, keamanan, dan kepatuhan untuk plugin dan aplikasi.

Yang akan Anda siapkan

Anda akan membuat aplikasi GitHub Enterprise khusus workspace di ChatGPT. Aplikasi ini menggunakan:

  • GitHub App yang terdaftar di host GitHub Enterprise Anda.

  • ID klien dan rahasia klien GitHub App untuk otorisasi Oauth pengguna.

  • Kunci privat GitHub App agar ChatGPT dapat membuat token instalasi untuk operasi repositori.

  • Rahasia webhook dan URL webhook agar GitHub Enterprise dapat mengirim peristiwa instalasi dan repositori kembali ke ChatGPT.

  • Nama host GitHub Enterprise Anda, seperti github.example.com.

Buat GitHub App, bukan aplikasi Oauth GitHub yang berdiri sendiri. Penyiapan template ChatGPT memerlukan kredensial GitHub App, kunci privat, dan pengaturan webhook.

Sebelum memulai

Anda memerlukan:

  • Akses admin atau pemilik workspace ChatGPT.

  • Akses admin GitHub Enterprise atau pemilik organisasi yang dapat membuat dan menginstal GitHub App.

  • Nama host GitHub Enterprise saja, tanpa https:// atau jalur.

  • Keputusan tentang tindakan repositori yang perlu didukung ChatGPT, seperti pencarian repositori hanya baca, alur kerja pull request, alur kerja isu, pengeditan file, GitHub Actions, atau alur kerja Codex yang lebih luas.

  • Tempat yang aman untuk menangani kunci privat dan rahasia klien GitHub App.

Biarkan ChatGPT dan GitHub Enterprise tetap terbuka di tab terpisah. Jangan mengarang URL callback sendiri. Salin URL callback yang ditampilkan di ChatGPT tanpa perubahan.

Nilai yang perlu disiapkan

  • Nama host GitHub Enterprise: misalnya, github.example.com.

  • URL callback: salin dari alur penyiapan template ChatGPT.

  • ID klien GitHub App.

  • Rahasia klien GitHub App.

  • Kunci privat GitHub App dalam format PEM.

  • Rahasia webhook yang dihasilkan oleh ChatGPT.

  • URL webhook yang dihasilkan setelah draf aplikasi dibuat di ChatGPT.

Mulai penyiapan template di ChatGPT

  1. Di ChatGPT, beralihlah ke workspace tempat aplikasi akan tersedia.

  2. Buka Pengaturan workspace > Aplikasi. Anda juga dapat membuka Konsol Admin, memilih workspace ChatGPT yang dituju, lalu membuka Plugin. Pilih Kelola Aplikasi Lama untuk membuka halaman Aplikasi yang masih tersedia.

  3. Pilih Direktori.

  4. Cari GitHub Enterprise.

  5. Pilih template aplikasi GitHub Enterprise dan mulai penyiapan.

  6. Masukkan nama dan deskripsi aplikasi yang jelas, seperti GitHub Enterprise atau GitHub Enterprise - Tim Teknik.

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

  8. Salin URL callback yang ditampilkan di ChatGPT. Biarkan tab ini tetap terbuka.

  9. Salin rahasia webhook yang dihasilkan jika ditampilkan selama penyiapan.

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

Jangan hapus ID callback, tambahkan garis miring di akhir, atau ganti URL tersebut dengan URL ChatGPT umum.

Buat Aplikasi GitHub di GitHub Enterprise

  1. Buka host GitHub Enterprise Anda, misalnya https://github.example.com.

  2. Buka organisasi atau akun yang akan menjadi pemilik aplikasi.

  3. Buka Pengaturan > Pengaturan pengembang > Aplikasi GitHub.

  4. Pilih Aplikasi GitHub Baru.

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

  6. Masukkan URL beranda. Jika tidak ada halaman internal khusus, gunakan URL organisasi GitHub Enterprise.

  7. Di URL callback, tempel URL callback yang disalin dari ChatGPT tanpa perubahan.

  8. Biarkan opsi Kedaluwarsakan token otorisasi pengguna tetap aktif, kecuali tim keamanan Anda memiliki alasan khusus untuk mengubahnya.

  9. Aktifkan Minta otorisasi pengguna selama penginstalan agar pengguna dapat mengotorisasi aplikasi saat menginstal atau menghubungkannya.

  10. Di bagian Di mana Aplikasi GitHub ini dapat diinstal?, pilih opsi dengan cakupan paling terbatas yang sesuai dengan rencana penerapan Anda.

  11. Buat Aplikasi GitHub.

Konfigurasikan izin dan peristiwa

Pilih izin minimum yang diperlukan untuk tindakan ChatGPT yang akan Anda aktifkan.

Untuk penemuan repositori dan tanya jawab yang hanya memerlukan akses baca, mulailah dengan izin baca seperti:

  • Metadata: hanya baca. GitHub mewajibkan akses metadata untuk GitHub App.

  • Konten: hanya baca, untuk mengakses file dan konten repositori.

  • Isu: hanya baca, jika diperlukan pencarian atau pembacaan isu.

  • Pull request: hanya baca, jika diperlukan pencarian pull request atau konteks peninjauan.

  • Tindakan: hanya baca, jika diperlukan status eksekusi alur kerja, tugas, log, atau artefak.

Untuk alur kerja yang memerlukan akses tulis, tambahkan izin tulis hanya jika diperlukan, misalnya untuk Konten, Pull request, Isu, Tindakan, atau Alur kerja. Gunakan izin paling terbatas yang tetap mendukung tindakan ChatGPT yang diinginkan.

Peristiwa webhook harus sesuai dengan alur kerja yang Anda dukung. Peristiwa yang umum meliputi Instalasi, Repositori instalasi, Push, Pull request, Isu, Komentar isu, Eksekusi alur kerja, dan Tugas alur kerja.

Buat dan salin kredensial GitHub App

  1. Di pengaturan GitHub App, salin ID Klien.

  2. Buat Rahasia klien dan segera salin.

  3. Di bagian Kunci privat, buat kunci privat.

  4. Unduh file .pem dan simpan dengan aman.

  5. Buka file .pem di perangkat lokal, lalu salin seluruh teks PEM, termasuk baris pembuka dan penutup.

Kunci privat bersifat sensitif. Perlakukan kunci tersebut seperti kredensial. Jika kunci tersebut bocor, buat kunci privat baru, perbarui konfigurasi aplikasi ChatGPT, lalu hapus kunci yang bocor di GitHub Enterprise.

Selesaikan penyiapan di ChatGPT

  1. Kembali ke tab penyiapan template ChatGPT.

  2. Tempel ID klien GitHub App ke kolom ID klien Oauth.

  3. Tempel rahasia klien GitHub App ke kolom Rahasia klien Oauth.

  4. Biarkan Cakupan tetap seperti semula, kecuali organisasi Anda memang perlu mengganti pengaturan default template.

  5. Pastikan nama host GitHub Enterprise hanya berisi nama host, seperti github.example.com.

  6. Tempel atau unggah kunci privat GitHub App dalam format PEM ke kolom Kunci privat GitHub App.

  7. Pastikan rahasia webhook yang dihasilkan sudah terisi.

  8. Buat draf aplikasi.

  9. Buka detail draf aplikasi yang telah dibuat di ChatGPT, lalu salin URL webhook yang dihasilkan.

URL webhook seharusnya berbentuk seperti ini: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Selesaikan penyiapan webhook di GitHub Enterprise

  1. Kembali ke pengaturan GitHub App di GitHub Enterprise.

  2. Buka pengaturan Umum GitHub App.

  3. Aktifkan opsi Webhook aktif jika belum diaktifkan.

  4. Tempel URL webhook ChatGPT ke kolom URL webhook.

  5. Tempel rahasia webhook ChatGPT ke kolom Rahasia webhook.

  6. Biarkan verifikasi SSL tetap aktif.

  7. Pastikan peristiwa webhook yang Anda langgani sesuai dengan izin dan tindakan yang diaktifkan.

  8. Simpan perubahan.

Publikasikan dan kelola aplikasi di ChatGPT

Membuat draf aplikasi tidak otomatis membuatnya tersedia bagi anggota. Setelah meninjau draf:

  1. Publikasikan draf aplikasi.

  2. Di pengaturan workspace, buka halaman Aplikasi, buka Diaktifkan, lalu pastikan aplikasi muncul. Anda juga dapat membuka halaman Aplikasi melalui Kelola Aplikasi Lama di Konsol Admin > Plugin.

  3. Di Enterprise dan Edu, gunakan Akses pengguna untuk memilih peran yang dapat menggunakan aplikasi. Di Business, kelola ketersediaan aplikasi di seluruh workspace.

  4. Tinjau Kontrol tindakan untuk tindakan baca dan tulis.

  5. Tinjau Izin aplikasi untuk menentukan kapan ChatGPT meminta persetujuan anggota sebelum menggunakan aplikasi.

  6. Minta pengguna uji yang memiliki akses untuk membuka Aplikasi di ChatGPT dan memastikan aplikasi muncul.

Izin aplikasi ini berlaku untuk percakapan ChatGPT. Agen Workspace menggunakan kontrol per agen yang ditetapkan oleh pembuatnya untuk menentukan tindakan aplikasi yang tersedia dan kapan pengguna akhir diminta untuk menyetujuinya. Untuk informasi tentang perilaku agen, lihat: Agen Workspace ChatGPT untuk Enterprise dan Business.

Instal dan uji GitHub App

  1. Di GitHub Enterprise, instal aplikasi GitHub pada organisasi atau akun.

  2. Pilih semua repositori atau repositori tertentu sesuai kebijakan workspace.

  3. Mulai alur koneksi dari ChatGPT sebagai pengguna yang memiliki izin.

  4. Berikan otorisasi kepada aplikasi GitHub saat diminta.

  5. Jalankan tindakan baca sederhana terlebih dahulu, seperti menampilkan daftar repositori yang dapat diakses atau mengambil pull request yang sudah diketahui.

  6. Jika tindakan tulis diaktifkan, lakukan pengujian pada repositori berisiko rendah sebelum menerapkannya secara lebih luas.

Nama host dan perilaku Oauth

ChatGPT menggunakan nama host untuk menentukan endpoint GitHub Enterprise. Masukkan nama host saja, seperti github.example.com atau octocorp.ghe.com.

Jangan masukkan jalur API, jalur repositori, atau github.com, kecuali itu memang host GitHub Enterprise untuk aplikasi ini.

Pemecahan masalah

  • URI pengalihan tidak cocok: pastikan URL callback GitHub App sama persis dengan URL callback yang ditampilkan di ChatGPT.

  • ChatGPT tidak dapat membuat atau menyimpan draf aplikasi: pastikan semua kolom wajib sudah terisi, termasuk nama host, ID klien Oauth, Rahasia klien Oauth, kunci privat, dan rahasia webhook.

  • Autentikasi berhasil, tetapi panggilan ke repositori gagal: pastikan GitHub App sudah diinstal dan memiliki akses ke repositori.

  • API mengembalikan kode 403 atau izin tidak memadai: tambahkan izin GitHub App yang belum diberikan dan minta pemilik instalasi menyetujui izin yang diperbarui jika diminta.

  • Tidak ada repositori yang muncul: pastikan instalasi aplikasi mencakup repositori yang diharapkan dan pengguna yang memberikan otorisasi di ChatGPT memiliki akses ke repositori tersebut.

  • Pengiriman webhook gagal: pastikan URL webhook dan rahasia webhook cocok dengan nilai dari ChatGPT, biarkan verifikasi SSL tetap aktif, dan pastikan host GitHub Enterprise dapat menjangkau connectors.api.openai.org.

  • Error kunci privat: pastikan seluruh isi PEM telah disalin, termasuk baris pembuka dan penutup.

Referensi

Apakah artikel ini membantu?