Ringkasan
Templat aplikasi adalah jalur penyiapan untuk workspace Business dan Enterprise yang memerlukan versi khusus workspace dari aplikasi atau konektor ChatGPT. Alih-alih mengaktifkan satu aplikasi bersama dari direktori, admin atau pemilik workspace memulai dari templat yang disediakan OpenAI, menambahkan detail unik untuk organisasinya, dan membuat aplikasi draf untuk ditinjau.
Templat berguna ketika OpenAI dapat menyediakan perilaku aplikasi umum, tetapi setiap workspace harus menyediakan konfigurasi khusus penyedia. Bergantung pada templat, konfigurasi tersebut dapat mencakup nama tenant atau host, kredensial klien Oauth, URL callback, cakupan, detail webhook, URL server MCP terkelola, atau pengaturan penyedia lainnya. Misalnya, templat GitHub Enterprise dapat membuat konektor khusus workspace yang digunakan Codex untuk menjangkau host GitHub Enterprise organisasi tersebut.
Setelah penyiapan, anggota tidak menggunakan templat asli. Mereka menggunakan aplikasi workspace yang dipublikasikan dan dibuat darinya. Admin kemudian dapat mengelola aplikasi tersebut seperti aplikasi ChatGPT lainnya, termasuk akses peran, kontrol tindakan, izin aplikasi, dan otorisasi penyedia.
Plugin Codex juga dapat menyertakan templat aplikasi atau aplikasi yang dibuat dari templat. Jika plugin menyertakan templat aplikasi, admin atau pemilik workspace tetap perlu membuat dan memublikasikan aplikasi khusus workspace sebelum anggota dapat menghubungkannya di ChatGPT, dan menggunakannya melalui plugin tersebut. Saat plugin berjalan, plugin menggunakan instans aplikasi yang tersedia di workspace tersebut, bukan meminta anggota mengonfigurasi sendiri templat asli. Jika templat yang diperlukan belum disiapkan, anggota mungkin memerlukan admin untuk menyelesaikan penyiapan terlebih dahulu. Plugin tidak dapat menggunakan templat aplikasi dengan sendirinya.
Gunakan artikel ini untuk alur templat umum. Untuk penyiapan khusus penyedia, lihat:
Templat berguna ketika pola aplikasi yang sama dapat berfungsi di banyak organisasi, tetapi setiap organisasi memerlukan konfigurasinya sendiri.
Contoh umum meliputi:
URL penyedia mencakup tenant, akun, organisasi, atau nama host workspace perusahaan.
Organisasi perlu membawa klien Oauth atau kredensial penyedianya sendiri.
Penyedia memerlukan penyiapan URL callback khusus pelanggan.
Aplikasi harus menggunakan pola implementasi yang sama, sementara setiap workspace mengontrol akses, tindakan, dan pengaturan keamanan secara terpisah.
Perbedaan templat dengan aplikasi biasa
Aplikasi biasa biasanya dapat diaktifkan langsung dari direktori aplikasi. Sebaliknya, templat memulai alur penyiapan.
Alur biasanya adalah:
Admin menemukan templat di direktori aplikasi.
Admin memasukkan konfigurasi khusus workspace yang diperlukan.
ChatGPT membuat aplikasi draf untuk workspace.
Admin meninjau dan memublikasikan draf.
Admin mengonfigurasi akses dan pengaturan tindakan untuk aplikasi yang dipublikasikan.
Anggota menggunakan aplikasi workspace yang dipublikasikan, bukan templat asli.
Menemukan dan menyiapkan templat 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 tepat bergantung pada templat.
Misalnya, templat GitHub Enterprise dapat meminta detail seperti:
Nama dan deskripsi aplikasi.
Nama host GitHub Enterprise.
Konfigurasi URL callback.
ID klien Oauth dan rahasia klien.
Kunci privat GitHub App.
Cakupan yang diminta.
Detail penyiapan webhook.
Tinjau setiap kolom dengan cermat sebelum membuat draf. Jika organisasi Anda mengelola Oauth atau kredensial penyedia secara terpusat, koordinasikan dengan tim yang memiliki kredensial tersebut.
Lihat instruksi khusus aplikasi: GitHub, Snowflake, dan Databricks.
Penyiapan klien Oauth
Beberapa templat mengharuskan organisasi Anda membawa klien Oauth sendiri. Jika ini diperlukan, buat atau konfigurasikan aplikasi Oauth di konsol admin penyedia eksternal, lalu salin URL callback dari ChatGPT ke pengaturan URL pengalihan atau callback penyedia.
Masukkan ID dan rahasia klien Oauth di ChatGPT hanya setelah memastikan bahwa konfigurasi penyedia sesuai dengan instruksi penyiapan templat.
Jika templat menyertakan cakupan default, pertahankan default kecuali organisasi Anda telah meninjau izin penyedia dan memiliki alasan jelas untuk mengubahnya.
Buat draf
Setelah memasukkan informasi yang diperlukan, pilih Buat draf.
Membuat draf tidak secara otomatis membuat aplikasi tersedia bagi anggota. Tinjau draf, publikasikan, dan konfigurasikan pengaturan akses dan tindakan sebelum meminta anggota menggunakannya.
Publikasikan dan kelola aplikasi yang dihasilkan
Setelah dipublikasikan, kelola aplikasi khusus workspace dari Pengaturan workspace > Aplikasi > Diaktifkan.
Pemeriksaan yang direkomendasikan setelah publikasi:
Konfirmasi aplikasi muncul di Aplikasi yang diaktifkan.
Atur Akses pengguna untuk peran yang seharusnya menggunakan aplikasi.
Tinjau Kontrol tindakan untuk tindakan baca dan tulis.
Tinjau Izin aplikasi untuk memilih kapan ChatGPT meminta konfirmasi anggota sebelum menggunakan aplikasi.
Minta pengguna uji yang diizinkan untuk membuka Aplikasi di ChatGPT dan mengonfirmasi aplikasi muncul.
Jika aplikasi memerlukan autentikasi penyedia, minta pengguna uji menghubungkan akun penyedianya.
Jalankan prompt uji berisiko rendah untuk memastikan aplikasi berfungsi sesuai harapan.
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.
Jika templat hanya dapat digunakan sekali
Beberapa templat mungkin hanya membuat satu aplikasi per workspace. Jika templat sudah digunakan, tombol Aktifkan mungkin tidak tersedia. Dalam hal itu, kelola draf atau aplikasi yang sudah dipublikasikan, bukan membuat yang lain dari templat yang sama.
Yang dilihat anggota
Anggota melihat aplikasi yang dipublikasikan dan dibuat dari templat. Apakah anggota dapat melihat atau menggunakannya bergantung pada pengaturan workspace dan otorisasi penyedia. Jika aplikasi disertakan dalam plugin, anggota dapat menemukannya melalui plugin tersebut, tetapi persyaratan akses workspace dan otorisasi penyedia yang sama tetap berlaku.
Pastikan bahwa:
Aplikasi telah dipublikasikan.
Aplikasi diaktifkan untuk workspace.
Peran workspace anggota memiliki akses.
Anggota berada di workspace yang benar.
Anggota memiliki izin yang diperlukan di penyedia eksternal.
Aplikasi yang dipublikasikan akan muncul di direktori aplikasi ChatGPT, di bagian khusus workspace.
Pemecahan masalah
Jika penyiapan gagal atau aplikasi tidak muncul, konfirmasi hal berikut:
Nama host tenant, akun, atau workspace sudah benar.
URL callback telah disalin persis ke konfigurasi penyedia.
ID klien Oauth dan rahasia klien sudah benar.
Cakupan yang diminta sesuai dengan yang diizinkan aplikasi Oauth penyedia.
Draf telah dibuat.
Draf telah dipublikasikan.
Akses peran memungkinkan pengguna uji melihat aplikasi.
Izin di sisi penyedia memungkinkan data atau tindakan yang sedang diuji.
Catatan keamanan
Perlakukan rahasia klien Oauth dan kredensial penyedia sebagai informasi sensitif.
Tinjau cakupan yang diminta sebelum membuat draf.
Gunakan Kontrol tindakan setelah publikasi untuk membatasi apa yang dapat dilakukan aplikasi.
Gunakan Izin aplikasi untuk menentukan kapan ChatGPT meminta konfirmasi anggota sebelum menggunakan aplikasi.
Perhatikan bahwa izin penyedia tetap berlaku setelah aplikasi diaktifkan di ChatGPT.