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

Ikhtisar

Gunakan panduan ini jika Anda adalah admin workspace ChatGPT yang menyiapkan templat aplikasi Enterprise GitHub untuk organisasi Anda. Templat bukan aplikasi akhir yang digunakan anggota. Ini adalah alur penyiapan yang membuat aplikasi draf khusus workspace setelah Anda memberikan konfigurasi GitHub Enterprise yang diperlukan.

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

Yang Anda siapkan

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

  • Aplikasi GitHub yang terdaftar di host GitHub Enterprise Anda.

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

  • Kunci privat Aplikasi GitHub 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.

  • Hostname GitHub Enterprise Anda, seperti github.example.com.

Buat Aplikasi GitHub, bukan Aplikasi Oauth GitHub mandiri. Penyiapan templat ChatGPT memerlukan kredensial Aplikasi GitHub, 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 Apps.

  • Hanya hostname GitHub Enterprise, tanpa https:// atau path.

  • Keputusan tentang tindakan repositori mana yang harus didukung ChatGPT, seperti pencarian repositori baca-saja, workflow pull request, workflow issue, pengeditan file, GitHub Actions, atau workflow Codex yang lebih luas.

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

Biarkan ChatGPT dan GitHub Enterprise terbuka di tab terpisah. Jangan mengarang URL callback. Salin URL callback persis yang ditampilkan di ChatGPT.

Nilai yang perlu disiapkan

  • Hostname GitHub Enterprise: misalnya, github.example.com.

  • URL callback: salin ini dari alur penyiapan templat ChatGPT.

  • ID klien Aplikasi GitHub.

  • Rahasia klien Aplikasi GitHub.

  • PEM kunci privat Aplikasi GitHub.

  • Rahasia webhook yang dibuat oleh ChatGPT.

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

Mulai penyiapan templat di ChatGPT

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

  2. Buka Pengaturan workspace > Aplikasi.

  3. Pilih Direktori.

  4. Cari GitHub Enterprise.

  5. Pilih templat aplikasi GitHub Enterprise dan mulai penyiapan.

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

  7. Masukkan hostname GitHub Enterprise, seperti github.example.com.

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

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

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

Jangan hapus ID callback, menambahkan garis miring di akhir, atau menggantinya dengan URL ChatGPT generik.

Buat Aplikasi GitHub di GitHub Enterprise

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

  2. Buka organisasi atau akun yang akan memiliki aplikasi tersebut.

  3. Buka Pengaturan > Pengaturan developer > GitHub Apps.

  4. Pilih Aplikasi GitHub Baru.

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

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

  7. Di URL Callback, tempel URL callback persis yang disalin dari ChatGPT.

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

  9. Aktifkan Minta otorisasi pengguna selama instalasi agar pengguna dapat mengotorisasi aplikasi selama alur instalasi atau koneksi.

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

  11. Buat Aplikasi GitHub.

Konfigurasi izin dan peristiwa

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

Untuk penemuan repositori baca-saja dan tanya jawab, mulai dengan izin baca seperti:

  • Metadata: baca-saja. GitHub mewajibkan metadata untuk GitHub Apps.

  • Konten: baca-saja, untuk akses file dan konten repositori.

  • Issue: baca-saja, jika pencarian issue atau pembacaan issue diperlukan.

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

  • Actions: baca-saja, jika status eksekusi workflow, job, log, atau artefak diperlukan.

Untuk workflow tulis, tambahkan izin tulis hanya jika diperlukan, seperti Konten, Pull request, Issue, Actions, atau Workflow. Gunakan izin paling terbatas yang mendukung tindakan ChatGPT yang dimaksud.

Peristiwa webhook harus sesuai dengan workflow yang Anda dukung. Peristiwa umum mencakup Instalasi, Repositori instalasi, Push, Pull request, Issue, Komentar issue, Eksekusi workflow, dan Job workflow.

Buat dan salin kredensial Aplikasi GitHub

  1. Di pengaturan Aplikasi GitHub, 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 secara lokal dan salin teks PEM lengkap, termasuk baris awal dan akhir.

Kunci privat bersifat sensitif. Perlakukan seperti kredensial. Jika terekspos, buat kunci privat baru, perbarui penyiapan aplikasi ChatGPT, dan hapus kunci yang disusupi di GitHub Enterprise.

Selesaikan penyiapan di ChatGPT

  1. Kembali ke tab penyiapan templat ChatGPT.

  2. Tempel ID Klien Aplikasi GitHub ke ID klien Oauth.

  3. Tempel rahasia Klien Aplikasi GitHub ke rahasia klien Oauth.

  4. Biarkan Cakupan tidak berubah kecuali organisasi Anda sengaja perlu mengganti default templat.

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

  6. Tempel atau unggah PEM kunci privat Aplikasi GitHub ke kunci privat Aplikasi GitHub.

  7. Pastikan rahasia webhook yang dibuat tersedia.

  8. Buat aplikasi draf.

  9. Buka detail aplikasi draf yang dibuat di ChatGPT dan salin URL webhook yang dibuat.

URL webhook akan terlihat seperti: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Selesaikan penyiapan webhook di GitHub Enterprise

  1. Kembali ke pengaturan Aplikasi GitHub di GitHub Enterprise.

  2. Buka pengaturan Umum Aplikasi GitHub.

  3. Aktifkan webhook Aktif jika belum aktif.

  4. Tempel URL webhook ChatGPT ke URL Webhook.

  5. Tempel rahasia webhook ChatGPT ke Rahasia webhook.

  6. Biarkan verifikasi SSL tetap aktif.

  7. Pastikan peristiwa webhook yang dilanggan sesuai dengan izin dan tindakan yang Anda aktifkan.

  8. Simpan perubahan.

Publikasikan dan kelola aplikasi di ChatGPT

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

  1. Publikasikan aplikasi draf.

  2. Pastikan aplikasi muncul di Pengaturan workspace > Aplikasi > Diaktifkan.

  3. Konfigurasikan Akses pengguna untuk peran yang harus menggunakannya.

  4. Tinjau Kontrol tindakan untuk tindakan baca dan tulis.

  5. Tinjau Izin aplikasi untuk memilih kapan ChatGPT bertanya kepada anggota sebelum menggunakan aplikasi.

  6. Minta pengguna uji yang diizinkan membuka Aplikasi di ChatGPT dan memastikan aplikasi muncul.

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

Instal dan uji Aplikasi GitHub

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

  2. Pilih semua repositori atau repositori yang dipilih sesuai kebijakan workspace.

  3. Mulai alur koneksi dari ChatGPT sebagai pengguna yang diizinkan.

  4. Otorisasi aplikasi GitHub saat diminta.

  5. Jalankan tindakan baca kecil terlebih dahulu, seperti mencantumkan repositori yang dapat diakses atau mengambil pull request yang diketahui.

  6. Jika tindakan tulis diaktifkan, uji dengan repositori berisiko rendah sebelum peluncuran yang lebih luas.

Perilaku hostname dan Oauth

ChatGPT menggunakan hostname untuk memperoleh endpoint GitHub Enterprise. Masukkan hanya host, seperti github.example.com atau octocorp.ghe.com.

Jangan masukkan path API, path repositori, atau github.com kecuali itu adalah host GitHub Enterprise yang tepat untuk aplikasi ini.

Pemecahan masalah

  • Ketidakcocokan URI pengalihan: pastikan URL callback Aplikasi GitHub sama persis dengan URL callback yang ditampilkan di ChatGPT.

  • ChatGPT tidak dapat membuat atau menyimpan aplikasi draf: pastikan semua bidang wajib tersedia, termasuk hostname, ID klien Oauth, rahasia klien Oauth, kunci privat, dan rahasia webhook.

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

  • API mengembalikan 403 atau izin tidak cukup: tambahkan izin Aplikasi GitHub yang hilang 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 mengotorisasi di ChatGPT memiliki akses ke repositori tersebut.

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

  • Kesalahan kunci privat: pastikan konten PEM lengkap telah disalin, termasuk baris awal dan akhir.

Referensi

Apakah artikel ini membantu?