Ringkasan
Templat aplikasi adalah jalur penyiapan bagi workspace terkelola yang memerlukan versi khusus workspace dari aplikasi atau konektor ChatGPT. Administrator dan pemilik workspace dapat menemukan templat melalui antarmuka administrator Aplikasi atau Plugin yang tersedia, menambahkan konfigurasi khusus organisasi, dan membuat draf aplikasi untuk ditinjau. Templat aplikasi terkelola tidak muncul di workspace pribadi.
Templat berguna saat OpenAI dapat menyediakan perilaku umum aplikasi, tetapi setiap workspace harus menyediakan konfigurasi khusus penyedia. Bergantung pada templat, konfigurasi tersebut dapat mencakup tenant atau nama host, kredensial klien Oauth, URL panggilan balik, cakupan, detail webhook, URL server MCP terkelola, atau pengaturan penyedia lainnya. Misalnya, templat GitHub Enterprise dapat membuat konektor khusus workspace yang digunakan Codex untuk mengakses host GitHub Enterprise milik organisasi tersebut.
Setelah penyiapan, anggota tidak menggunakan templat asli. Mereka menggunakan aplikasi workspace terbitan yang dibuat dari templat tersebut. Admin kemudian dapat mengelola aplikasi tersebut seperti aplikasi ChatGPT lainnya, termasuk akses peran, kontrol tindakan, izin aplikasi, dan otorisasi penyedia.
Plugin dapat menyertakan templat aplikasi atau aplikasi yang dibuat dari templat. Jika plugin menyertakan templat aplikasi, admin atau pemilik workspace harus membuat dan menerbitkan aplikasi khusus workspace sebelum anggota dapat menghubungkannya di ChatGPT atau menggunakannya melalui plugin. Plugin menggunakan instans aplikasi yang tersedia di workspace tersebut; anggota tidak mengonfigurasi templat asli.
Gunakan artikel ini untuk memahami alur umum templat. Untuk penyiapan khusus penyedia, lihat:
Alasan umum menggunakan templat antara lain:
URL penyedia mencakup nama host tenant, akun, organisasi, atau workspace perusahaan.
Organisasi perlu menggunakan klien Oauth atau kredensial penyedia miliknya sendiri.
Penyedia mewajibkan penyiapan URL panggilan balik khusus pelanggan.
Aplikasi harus menggunakan pola implementasi yang sama, sedangkan setiap workspace mengontrol akses, tindakan, dan pengaturan keamanan secara terpisah.
Perbedaan templat dengan aplikasi biasa
Aplikasi biasa umumnya dapat langsung diaktifkan. Sebaliknya, templat memulai alur penyiapan oleh admin workspace.
Alur umumnya adalah:
Administrator menemukan templat di antarmuka administrator Aplikasi atau Plugin workspace, bergantung pada antarmuka yang tersedia.
Admin memasukkan konfigurasi khusus workspace yang diperlukan.
ChatGPT membuat draf aplikasi untuk workspace.
Admin meninjau dan menerbitkan draf tersebut.
Admin mengonfigurasi pengaturan akses dan tindakan untuk aplikasi terbitan.
Anggota menggunakan aplikasi workspace terbitan, bukan templat asli.
Menemukan dan menyiapkan templat aplikasi
Prosedur berikut menjelaskan antarmuka administrator Aplikasi. Jika workspace Anda menggunakan Admin > Plugin, buka plugin atau templat terkait, lalu ikuti alur penyiapannya. Untuk navigasi workspace, lihat: Kontrol admin, keamanan, dan kepatuhan untuk plugin dan aplikasi.
Buka Pengaturan workspace > Aplikasi.
Pilih Direktori.
Cari nama penyedia atau aplikasi.
Cari entri yang ditandai sebagai templat.
Pilih Aktifkan untuk memulai alur penyiapan.
Alur penyiapan meminta detail yang diperlukan untuk membuat aplikasi khusus workspace. Kolom yang tersedia bergantung pada templat.
Misalnya, templat GitHub Enterprise dapat meminta detail seperti:
Nama dan deskripsi aplikasi.
Nama host GitHub Enterprise.
Konfigurasi URL panggilan balik.
ID klien dan rahasia klien Oauth.
Kunci privat Aplikasi GitHub.
Cakupan yang diminta.
Detail penyiapan webhook.
Tinjau setiap kolom dengan saksama sebelum membuat draf. Jika organisasi Anda mengelola Oauth atau kredensial penyedia secara terpusat, berkoordinasilah dengan tim yang bertanggung jawab atas kredensial tersebut.
Untuk penyiapan khusus penyedia, lihat: GitHub Enterprise, Snowflake, dan Databricks.
Penyiapan klien Oauth
Beberapa templat mengharuskan organisasi Anda menggunakan klien Oauth miliknya sendiri. Jika diwajibkan, buat atau konfigurasikan aplikasi Oauth di konsol admin penyedia eksternal, lalu salin URL panggilan balik dari ChatGPT ke pengaturan URL pengalihan atau panggilan balik penyedia.
Masukkan ID dan rahasia klien Oauth di ChatGPT hanya setelah memastikan bahwa konfigurasi penyedia sesuai dengan petunjuk penyiapan templat.
Jika templat menyertakan cakupan default, pertahankan nilai default kecuali organisasi Anda telah meninjau izin penyedia dan memiliki alasan yang jelas untuk mengubahnya.
Membuat draf
Setelah memasukkan informasi yang diperlukan, pilih Buat draf.
Pembuatan draf tidak otomatis membuat aplikasi tersedia bagi anggota. Tinjau dan terbitkan draf, lalu konfigurasikan pengaturan akses dan tindakan sebelum meminta anggota menggunakannya.
Menerbitkan dan mengelola aplikasi yang dihasilkan
Setelah diterbitkan, kelola aplikasi khusus workspace melalui pengaturan workspace Aplikasi atau Plugin yang tersedia.
Pemeriksaan yang disarankan setelah penerbitan:
Pastikan aplikasi muncul di Aplikasi yang diaktifkan.
Atur Akses peran bagi peran yang seharusnya menggunakan aplikasi.
Tinjau Tindakan untuk tindakan baca dan tulis.
Tinjau Izin aplikasi untuk menentukan kapan ChatGPT meminta persetujuan anggota sebelum menggunakan aplikasi.
Minta pengguna uji yang berwenang membuka Aplikasi atau Plugin, sesuai yang tersedia, lalu memastikan aplikasi terbitan muncul.
Jika aplikasi memerlukan autentikasi penyedia, minta pengguna uji menghubungkan akun penyedianya.
Jalankan prompt pengujian berisiko rendah untuk memastikan aplikasi berfungsi sesuai harapan.
Izin ini berlaku untuk percakapan ChatGPT. Agen Workspace menggunakan kontrol terpisah yang ditentukan oleh pembuat agen. Untuk detailnya, lihat: Agen Workspace ChatGPT untuk Enterprise dan Business.
Jika templat hanya dapat digunakan sekali
Beberapa templat mungkin hanya dapat membuat satu aplikasi per workspace. Jika templat sudah digunakan, tombol Aktifkan mungkin tidak tersedia. Jika demikian, kelola draf atau aplikasi terbitan yang ada alih-alih membuat aplikasi lain dari templat yang sama.
Yang dilihat anggota
Anggota melihat aplikasi terbitan yang dibuat dari templat. Kemampuan anggota untuk melihat atau menggunakannya bergantung pada pengaturan workspace dan otorisasi penyedia. Jika aplikasi disertakan dalam plugin, anggota mungkin menemukannya melalui plugin tersebut, tetapi persyaratan akses workspace dan otorisasi penyedia yang sama tetap berlaku.
Jika plugin memerlukan aplikasi yang dibuat dari templat, plugin mungkin menunjukkan bahwa penyiapan diperlukan hingga admin membuat dan menerbitkan aplikasi khusus workspace, mengaktifkannya untuk peran terkait, serta menyelesaikan semua otorisasi penyedia yang diwajibkan bagi pengguna atau admin.
Pastikan bahwa:
Aplikasi sudah diterbitkan.
Aplikasi diaktifkan untuk workspace.
Peran workspace anggota memiliki akses.
Anggota berada di workspace yang benar.
Anggota memiliki izin yang diperlukan di penyedia eksternal.
Aplikasi terbitan muncul di pengaturan workspace Aplikasi atau Plugin yang tersedia. Jika aplikasi merupakan bagian dari plugin, aplikasi tersebut juga dapat muncul sebagai aplikasi wajib atau opsional di halaman detail plugin.
Memecahkan masalah templat aplikasi
Jika penyiapan gagal atau aplikasi tidak muncul, pastikan hal-hal berikut:
Nama host tenant, akun, atau workspace sudah benar.
URL panggilan balik disalin secara persis ke konfigurasi penyedia.
ID klien dan rahasia klien Oauth sudah benar.
Cakupan yang diminta sesuai dengan yang diizinkan aplikasi Oauth penyedia.
Draf sudah dibuat.
Draf sudah diterbitkan.
Akses peran memungkinkan pengguna uji melihat aplikasi.
Izin di sisi penyedia mengizinkan data atau tindakan yang sedang diuji.
Meninjau persyaratan keamanan
Perlakukan rahasia klien Oauth dan kredensial penyedia sebagai informasi sensitif.
Tinjau cakupan yang diminta sebelum membuat draf.
Setelah menerbitkan aplikasi, gunakan Tindakan untuk membatasi hal yang dapat dilakukan aplikasi.
Gunakan Izin aplikasi untuk menentukan kapan ChatGPT meminta persetujuan anggota sebelum menggunakan aplikasi.
Perhatikan bahwa izin penyedia tetap berlaku setelah aplikasi diaktifkan di ChatGPT.