Ringkasan
Templat aplikasi menyediakan cara penyiapan bagi workspace terkelola yang memerlukan versi aplikasi atau konektor ChatGPT khusus untuk workspace tersebut. 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 ketika OpenAI dapat menyediakan fungsi umum aplikasi, 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 mengakses host GitHub Enterprise organisasi tersebut.
Setelah penyiapan selesai, anggota tidak menggunakan templat aslinya. Mereka menggunakan aplikasi workspace yang dibuat dari templat tersebut dan sudah dipublikasikan. Admin kemudian dapat mengelola aplikasi tersebut seperti aplikasi ChatGPT lainnya. Di ChatGPT Business, pemilik dan admin mengaktifkan atau menonaktifkan aplikasi untuk workspace. Di ChatGPT Enterprise/Edu, pemilik dan admin dapat menggunakan akses aplikasi berbasis peran yang didukung. Admin juga dapat mengelola 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 memublikasikan aplikasi khusus workspace tersebut sebelum anggota dapat menghubungkannya di ChatGPT atau menggunakannya melalui plugin. Plugin menggunakan instans aplikasi yang tersedia di workspace tersebut; anggota tidak mengonfigurasi templat aslinya.
Gunakan artikel ini sebagai panduan alur umum penggunaan templat. Untuk penyiapan khusus penyedia, lihat:
Beberapa alasan umum untuk menggunakan templat:
URL penyedia mencakup tenant perusahaan, akun, organisasi, atau nama host workspace.
Organisasi perlu menyediakan klien Oauth atau kredensial penyedianya sendiri.
Penyedia mengharuskan penyiapan URL callback khusus pelanggan.
Aplikasi perlu menggunakan pola implementasi yang sama, sementara 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 memublikasikan draf.
Admin mengonfigurasi pengaturan akses dan tindakan untuk aplikasi yang sudah dipublikasikan.
Anggota menggunakan aplikasi workspace yang sudah dipublikasikan, bukan templat aslinya.
Menemukan dan menyiapkan templat aplikasi
Prosedur di bawah ini menjelaskan penggunaan antarmuka administrator Aplikasi. Jika workspace Anda menggunakan Admin > Plugin, buka plugin atau templat yang sesuai dan ikuti alur penyiapannya. Untuk navigasi workspace dan kontrol admin khusus paket, 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 ditampilkan bergantung pada templat.
Misalnya, templat GitHub Enterprise dapat meminta detail seperti:
Nama dan deskripsi aplikasi.
Nama host GitHub Enterprise.
Konfigurasi URL callback.
ID klien dan rahasia klien Oauth.
Kunci privat GitHub App.
Cakupan yang diminta.
Detail penyiapan webhook.
Tinjau setiap kolom dengan saksama sebelum membuat draf. Jika organisasi Anda mengelola kredensial Oauth atau 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 menyediakan klien Oauth sendiri. Jika 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 konfigurasi penyedia sesuai dengan petunjuk penyiapan templat.
Jika templat menyertakan cakupan default, pertahankan cakupan tersebut kecuali organisasi Anda telah meninjau izin penyedia dan memiliki alasan yang jelas untuk mengubahnya.
Membuat draf
Setelah memasukkan informasi yang diperlukan, pilih Buat draf.
Membuat draf tidak otomatis membuat aplikasi tersedia bagi anggota. Tinjau draf, publikasikan, dan konfigurasikan pengaturan akses serta tindakan sebelum meminta anggota menggunakannya.
Memublikasikan dan mengelola aplikasi yang dihasilkan
Setelah dipublikasikan, kelola aplikasi khusus workspace melalui pengaturan Aplikasi atau Plugin yang tersedia di workspace.
Pemeriksaan yang disarankan setelah publikasi:
Pastikan aplikasi muncul di Aplikasi yang diaktifkan.
Di ChatGPT Business, aktifkan atau nonaktifkan aplikasi untuk workspace. Di ChatGPT Enterprise/Edu, atur Akses peran untuk peran yang perlu menggunakan aplikasi, jika akses aplikasi berbasis peran didukung.
Tinjau Tindakan untuk tindakan baca dan tulis.
Tinjau Izin aplikasi untuk memilih kapan ChatGPT meminta persetujuan anggota sebelum menggunakan aplikasi.
Minta pengguna uji yang memiliki izin untuk membuka Aplikasi atau Plugin, sesuai yang tersedia, dan memastikan aplikasi yang sudah dipublikasikan muncul.
Jika aplikasi memerlukan autentikasi penyedia, minta pengguna uji menghubungkan akun penyedianya.
Jalankan prompt uji 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 yang sudah dipublikasikan alih-alih membuat aplikasi lain dari templat yang sama.
Yang dilihat anggota
Anggota melihat aplikasi yang dibuat dari templat dan sudah dipublikasikan. Apakah anggota dapat 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 menampilkan pemberitahuan bahwa penyiapan diperlukan hingga admin membuat dan memublikasikan aplikasi khusus workspace tersebut, mengaktifkannya untuk workspace di ChatGPT Business atau untuk peran yang sesuai di ChatGPT Enterprise/Edu yang mendukung akses aplikasi berbasis peran, serta menyelesaikan semua otorisasi penyedia yang diperlukan dari pengguna atau admin.
Pastikan bahwa:
Aplikasi sudah dipublikasikan.
Aplikasi sudah diaktifkan untuk workspace.
Di ChatGPT Enterprise/Edu, peran anggota dalam workspace memiliki akses jika akses aplikasi berbasis peran didukung.
Anggota berada di workspace yang benar.
Anggota memiliki izin yang diperlukan di penyedia eksternal.
Aplikasi yang sudah dipublikasikan muncul di pengaturan Aplikasi atau Plugin yang tersedia di workspace. Jika aplikasi merupakan bagian dari plugin, aplikasi juga dapat muncul sebagai aplikasi wajib atau opsional di halaman detail plugin.
Mengatasi masalah templat aplikasi
Jika penyiapan gagal atau aplikasi tidak muncul, pastikan hal-hal berikut:
Tenant, akun, atau nama host workspace sudah benar.
URL callback disalin persis ke konfigurasi penyedia.
ID klien dan rahasia klien Oauth sudah benar.
Cakupan yang diminta sesuai dengan yang diizinkan oleh aplikasi Oauth penyedia.
Draf sudah dibuat.
Draf sudah dipublikasikan.
Di ChatGPT Business, aplikasi sudah diaktifkan untuk workspace. Di ChatGPT Enterprise/Edu, akses peran mengizinkan pengguna uji melihat aplikasi jika akses aplikasi berbasis peran didukung.
Izin di sisi penyedia mengizinkan akses data atau pelaksanaan tindakan yang sedang diuji.
Meninjau persyaratan keamanan
Perlakukan rahasia klien Oauth dan kredensial penyedia sebagai informasi sensitif.
Tinjau cakupan yang diminta sebelum membuat draf.
Gunakan Tindakan setelah publikasi untuk membatasi hal-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.