Panduan peluncuran admin

Panduan peluncuran admin

Rencanakan, konfigurasikan, dan verifikasi peluncuran ChatGPT Enterprise di seluruh ruang kerja dan antarmuka pengembang

Gunakan panduan ini untuk merencanakan peluncuran ChatGPT Enterprise di seluruh batas administrasi berikut:

  • Akses ruang kerja.
  • Kebijakan runtime lokal untuk kapabilitas yang dicakup di aplikasi desktop ChatGPT, Codex CLI, dan ekstensi IDE.
  • Cloud Codex.
  • Akses Platform API.
  • Akses plugin dan konektor.
  • Izin dalam sistem yang terhubung.

Selesaikan langkah-langkah secara berurutan untuk peluncuran baru, atau gunakan halaman tertaut untuk mengubah satu batas.

Jika Anda mengelola gateway model untuk klien Codex lokal, gunakan Terapkan Codex melalui gateway untuk kualifikasi gateway, distribusi kredensial, dan serah terima klien. Konfigurasikan akses ruang kerja secara terpisah jika penerapan Anda menggunakan fitur ruang kerja.

Dalam pengaturan ruang kerja, Codex and Work Local menggabungkan akses Codex dan Work lokal di bawah Allow members to use Codex and Work Locally. Sebagian ruang kerja menyediakan bagian Codex Local dan Work Local yang terpisah. Dalam tata letak tersebut, Allow members to use Codex locally mengontrol Codex, sedangkan Use Work locally mengontrol Work. Mengaktifkan salah satunya tidak mengaktifkan yang lain. Label ini menunjukkan izin ruang kerja, bukan produk atau klien yang terpisah. Izin token dan batas masa berlaku kredensial ditampilkan di bagian Access tokens atau bagian akses lokal, bergantung pada ruang kerja. Konfigurasi terkelola merupakan lapisan kebijakan terpisah yang dapat membatasi perilaku runtime yang didukung untuk kemampuan yang tercakup dalam klien tersebut. Panduan ini menyebutkan antarmuka tertentu ketika perilaku atau ketersediaannya berbeda.

Untuk gambaran umum kontrol akses, lihat Peran dan izin ruang kerja. Gunakan panduan Pusat Bantuan untuk prosedur ruang kerja ChatGPT terkini dan dokumentasi pengembang yang ditautkan untuk perilaku runtime lokal dan yang dihosting.

Untuk keamanan, privasi, dan perlindungan runtime tingkat perusahaan, lihat Persetujuan dan keamanan agen dan laporan resmi keamanan Codex.

Langkah 1: Tetapkan penanggung jawab dan pilih metode peluncuran

Tetapkan penanggung jawab untuk setiap bagian peluncuran:

  • Akses ruang kerja: Keanggotaan, lisensi pengguna, peran, dan fitur ruang kerja yang didukung.
  • Kebijakan runtime lokal: Persetujuan, profil izin, akses sistem file dan jaringan, serta persyaratan lain untuk klien lokal yang didukung.
  • Cloud Codex: Lingkungan yang dihosting, koneksi repositori, dan kebijakan runtime cloud.
  • Sistem yang terhubung: Instalasi aplikasi di sisi penyedia, akun, dan izin.
  • Pelaporan dan kepatuhan: Akses analitik, ekspor audit, dan penanganan data hilir.

Tentukan apakah setiap kelompok pengguna memerlukan kapabilitas lokal yang dicakup di aplikasi desktop ChatGPT, Codex CLI, ekstensi IDE, cloud Codex, atau kombinasinya. Perlakukan akses Platform API sebagai batas organisasi dan proyek yang terpisah ketika alur kerja menggunakan autentikasi API key.

Langkah 2: Konfigurasikan akses dan identitas ruang kerja

Gunakan keanggotaan ruang kerja ChatGPT, lisensi pengguna, grup, dan izin RBAC yang didukung untuk memberikan fitur ruang kerja yang didukung kepada kelompok pengguna yang dituju. Verifikasi akses klien lokal dan cloud Codex berdasarkan panduan ruang kerja terkini, bukan dengan menganggap bahwa peran yang sama mengendalikan setiap antarmuka. Batasi peran administrasi bawaan hanya untuk pengguna yang mengelola ruang kerja.

Kontrol dan label ruang kerja berubah seiring waktu. Gunakan sumber berikut untuk prosedur terkini:

Uji proses masuk dan akses fitur bersama anggota yang memiliki izin yang dimaksud. Akses ruang kerja tidak memberikan akses repositori, berkas, atau tindakan di layanan yang terhubung.

Siapkan akses komputer lokal dengan Work Cloud

Jika penerapan Anda mencakup akses komputer lokal untuk Work atau dots, tinjau kebijakan di Agent Security sebelum penerapan. Migrasi kebijakan dan akses fitur merupakan perubahan terpisah; alur konfirmasi tidak mewajibkan pembuatan kebijakan untuk mengaktifkan akses. Kebijakan Global yang didukung mengatur orkestrasi cloud saat kebijakan terkelola diaktifkan. Persyaratan eksekusi lokal dan kontrol perangkat mengatur komputer yang terhubung. Kontainer cloud Work dan komputer cloud dots menggunakan konfigurasi dan persyaratan eksekusi masing-masing. Ikuti Akses komputer lokal untuk Work Cloud dan dots untuk persyaratan penyiapan dan kelayakan yang terpisah.

Gunakan API kebijakan untuk mengelola pengaturan Global. Untuk mengelola pengaturan Local atau Codex Cloud, gunakan UI Agent Security. Alur kerja API Global yang ada tetap tersedia setelah migrasi. Uji skrip dan integrasi Terraform Anda, lalu pastikan penetapan dan urutan kebijakan tidak berubah.

Periksa kompatibilitas sebelum mengaktifkan sinkronisasi:

Kebijakan jaringan. Jika penggantian pengaturan pada tingkat lingkungan tersedia, uji pengecualian experimental_network yang didokumentasikan dalam Konfigurasi terkelola. Pembatasan global dapat tetap berlaku meskipun lingkungan memberikan izin.

  • Hook Enterprise. Jika diaktifkan untuk ruang kerja Anda, akses komputer lokal dengan Work Cloud mendukung hook MCP yang ditentukan admin dan dijalankan pada koordinator cloud (orkestrator) untuk peristiwa siklus hidup dan alat yang didukung. Hook perintah serta hook dari konfigurasi lokal atau plugin tidak didukung dengan orkestrasi cloud, meskipun alat dijalankan secara lokal.

  • Hook yang tidak didukung. Hook perintah serta hook dari konfigurasi lokal atau plugin tidak didukung dengan orkestrasi cloud, meskipun alat dijalankan secara lokal. Jika orkestrasi dan eksekusi sama-sama berlangsung secara lokal, hook yang sudah didukung tetap berfungsi dalam utas Work dan Codex yang hanya berjalan secara lokal. Admin tetap dapat mengonfigurasi hook terkelola yang didukung di Agent Security untuk alur kerja tersebut.

  • Audit. Sebelum mengandalkan hook ini, uji koneksi callback, pastikan peristiwa yang diterimanya, dan periksa dampak kegagalan terhadap tugas. Hook MCP tidak menyediakan jejak audit Compliance API yang lengkap.

  • Persyaratan data. Akses komputer lokal dengan Work Cloud tidak menyediakan retensi data nol yang ketat. Residensi data dan residensi inferensi hanya mencakup konten yang memenuhi syarat serta beban kerja, wilayah, dan konfigurasi yang didukung. Enterprise Key Management (EKM) mencakup konten tersimpan yang didukung di ruang kerja yang memenuhi syarat. Work tidak didukung dengan residensi inferensi UEA. Jika enforce_residency diaktifkan dalam kebijakan cloud mana pun, Izinkan akses komputer lokal dinonaktifkan untuk Work dan dots. Pengamanan ini tidak mengonfigurasi residensi ruang kerja atau, dengan sendirinya, menonaktifkan Work Cloud maupun dots. Jika organisasi Anda memerlukan ZDR, jangan aktifkan fitur ini.

Sebagai pemilik ruang kerja, tinjau izin Work untuk pengguna atau grup yang dituju. Aktifkan Work Cloud, lalu aktifkan Izinkan akses komputer lokal. Gunakan penetapan peran yang didukung untuk memberikan akses. Lihat Peran dan izin ruang kerja.

Langkah 3: Konfigurasikan persyaratan runtime lokal

Persyaratan lokal membatasi perilaku runtime ketika pengguna memulai eksekusi lokal yang didukung di aplikasi desktop ChatGPT, Codex CLI, atau ekstensi IDE. Distribusikan requirements.toml melalui saluran cloud, perangkat, atau sistem yang didukung. Pisahkan kebijakan ini dari peran dan grup ruang kerja ChatGPT.

Gunakan profil izin untuk klien lokal yang didukung, alih-alih membangun penerapan baru berdasarkan pembatasan mode sandbox lama. Contoh:

default_permissions = ":workspace"

[allowed_permission_profiles]
":read-only" = true
":workspace" = true

Untuk menonaktifkan Computer Use di seluruh antarmuka fitur browser dan desktop yang didukung, batasi setiap kunci fitur publik yang terlibat dalam pengalaman tersebut:

[features]
browser_use = false
browser_use_full_cdp_access = false
browser_use_external = false
in_app_browser = false
computer_use = false

Untuk daftar kunci resmi, perilaku distribusi, presedensi, dan contoh lainnya, lihat Konfigurasi terkelola dan referensi requirements.toml.

Langkah 4: Standarkan konfigurasi repositori

Gunakan konfigurasi dalam lingkup repositori untuk berbagi nilai default, aturan, dan skill proyek tanpa menduplikasi penyiapan untuk setiap pengguna. Simpan konfigurasi ke .codex atau .agents sesuai lokasi yang didokumentasikan untuk fitur tersebut:

Jenis Sumber Kegunaan
Konfigurasi Dasar-dasar konfigurasi Menetapkan nilai default repositori untuk klien lokal yang didukung
Aturan Aturan Mengendalikan perintah yang memerlukan persetujuan di luar sandbox
Skill Buat skill Menyediakan alur kerja repositori bagi klien yang didukung

Konfigurasi repositori dapat menyediakan nilai default dan alur kerja yang dapat digunakan kembali. Konfigurasi ini tidak dapat memberikan akses ruang kerja, model, Platform API, atau sistem yang terhubung.

Langkah 5: Konfigurasikan cloud Codex

Codex cloud menggunakan lingkungan yang dihosting dan repositori sumber yang terhubung.

Codex Cloud dinonaktifkan secara default untuk ruang kerja Enterprise. Pengaturan Gunakan Codex di cloud yang ada diteruskan dari Codex Cloud (Legacy): ruang kerja yang sudah mengaktifkan Cloud tetap memiliki akses, sedangkan ruang kerja dengan Cloud yang dinonaktifkan tetap demikian hingga admin mengaktifkannya. Akses tetap tunduk pada peluncuran dan pembatasan ruang kerja.

Rencanakan setiap batasan:

  1. Berikan izin Gunakan Codex di cloud kepada pengguna yang dituju. Secara terpisah, berikan izin Kelola lingkungan ruang kerja kepada orang yang membuat dan mengedit lingkungan bersama dalam ruang kerja. Lihat panduan peran ruang kerja.
  2. Instal dan konfigurasikan integrasi sistem sumber yang didukung.
  3. Batasi akses repositori di sistem sumber hanya ke repositori yang dibutuhkan setiap kelompok pengguna.
  4. Konfigurasikan lingkungan cloud, rahasia, akses internet, dan persyaratan yang didukung serta dikelola melalui cloud untuk repositori tersebut.
  5. Konfigurasikan alur kerja opsional yang dihosting, seperti peninjauan kode.
  6. Uji akses tugas dengan anggota yang mewakili pengguna dan pengelolaan lingkungan dengan administrator yang ditunjuk. Verifikasi izin ruang kerja, lingkungan, dan repositori setiap orang.

Lingkungan cloud tidak mewarisi kebijakan perangkat lokal, pengaturan MDM, atau akses jaringan lokal. Tinjau persyaratan yang didukung dan dikelola melalui cloud secara terpisah dari persyaratan yang diinstal pada komputer pengguna. Lihat Menghubungkan ke layanan untuk akses ke tujuan dan Agent Security untuk mengetahui cara persyaratan ruang kerja membatasi lingkungan cloud.

Codex cloud mematuhi izin dan perlindungan repositori yang disediakan oleh sistem sumber yang terhubung. Akses ruang kerja tidak melewati kontrol tersebut. Lihat Lingkungan cloud untuk panduan penyiapan dan runtime.

Langkah 6: Konfigurasikan plugin dan kapabilitas yang terhubung

Tinjau instalasi plugin, skill bawaan, kapabilitas berbasis konektor, tindakan konektor, dan otorisasi sistem sumber sebagai keputusan terpisah. Menonaktifkan kapabilitas berbasis konektor tidak selalu menghapus plugin atau skill bawaannya.

Sebelum menyertakan plugin atau skill dalam peluncuran:

  1. Konfirmasikan sumber, penanggung jawab, kelompok pengguna yang dituju, dan tanggal peninjauannya.
  2. Tinjau skill bawaan, konektor, MCP server, hook, serta data dan tindakan yang diperlukan setiap kapabilitas.
  3. Uji dengan data tidak sensitif dan akses minimum yang diperlukan.
  4. Catat pihak yang bertanggung jawab atas peninjauan ulang dan penghentian penggunaan.

Plugin berfungsi di Chat dan Work pada ChatGPT di web, desktop, dan perangkat seluler, di Codex dalam aplikasi desktop ChatGPT, serta melalui browser plugin Codex CLI. Plugin tidak tersedia di ekstensi IDE. ChatGPT dan Codex menggunakan satu direktori plugin publik universal yang sama; kontrol ruang kerja menentukan plugin mana yang dapat diakses oleh anggota.

Lihat Kontrol plugin dan Kontrol skill untuk model lengkap.

Langkah 7: Siapkan tata kelola dan observabilitas

Pilih antarmuka pelaporan yang sesuai dengan pertanyaan:

Gunakan referensi API yang memerlukan autentikasi untuk mengetahui persyaratan akses, skema, kolom, retensi, dan perilaku permintaan terkini saat membangun integrasi.

Lindungi batas integrasi:

  • Simpan API key dan kredensial integrasi lainnya dalam sistem pengelolaan rahasia organisasi.
  • Batasi akses ke sistem hilir dan data yang dipertahankan hanya untuk kelompok pengguna yang disetujui.
  • Lindungi catatan Compliance API yang diekspor sesuai tingkat sensitivitas dan kebijakan retensi organisasi, serta uji alur kerja pengumpulan dan penghapusan berdasarkan kontrak terkini.

Langkah 8: Verifikasi dan pelihara peluncuran

Setelah mengaktifkan akses komputer lokal dengan Work Cloud, buat tugas baru dan lanjutkan percakapan dari perangkat lain yang didukung. Tugas yang sudah ada tidak dimigrasikan dan tetap mempertahankan perilaku awalnya, yaitu hanya lokal atau hanya cloud. Pastikan komputer tetap online untuk langkah yang memerlukan file atau alatnya. Uji tindakan yang seharusnya diizinkan oleh kebijakan dan tindakan yang seharusnya diblokir, dengan memeriksa persetujuan serta pembatasan sistem file dan jaringan yang berlaku secara terpisah untuk eksekusi lokal dan cloud. Uji juga memulai giliran baru saat komputer lokal tidak tersedia. Tugas yang memenuhi syarat dapat dilanjutkan dalam kontainer cloud tanpa akses ke file atau alat lokal komputer tersebut. Tugas tidak dapat beralih dari eksekusi lokal ke cloud di tengah giliran.

Catat pengaturan yang berlaku dan hasil setiap pengujian. Jika pembatasan tidak berfungsi sesuai harapan, selesaikan masalahnya sebelum pengguna mengandalkannya. Ikuti perilaku yang didokumentasikan untuk menonaktifkan sinkronisasi. Perlakukan pencabutan akses, penghentian tugas, dan retensi data sebagai tindakan terpisah.

Verifikasi setiap batas yang berlaku dengan identitas perwakilan:

  • Keanggotaan ruang kerja ChatGPT, lisensi pengguna, dan izin peran yang didukung.
  • Kapabilitas lokal yang dicakup di aplikasi desktop ChatGPT, Codex CLI, dan ekstensi IDE, termasuk proses masuk dan persyaratan runtime yang berlaku.
  • Akses cloud Codex, konfigurasi lingkungan, dan izin repositori.
  • Akses organisasi dan proyek Platform API untuk alur kerja berbasis API key.
  • Instalasi plugin, skill bawaan, akses konektor, dan tindakan yang didukung.
  • Otorisasi sistem yang terhubung dan akses data.
  • Akses analitik dan kepatuhan bagi administrator yang bertanggung jawab.

Catat penanggung jawab dan sumber prosedural terkini untuk setiap kontrol. Catatan ini memungkinkan administrator memperbarui prosedur ketika UI atau kebijakan berubah tanpa mengubah model administrasi.

Setelah peluncuran awal, tinjau akses, kapabilitas yang terhubung, penggunaan kredit, masukan dukungan, dan alur kerja yang benar-benar digunakan tim. Sesuaikan cakupan peluncuran dan panduan administrator ketika sinyal tersebut berubah.

Jika Anda perlu menonaktifkan akses komputer lokal dengan Work Cloud

Menonaktifkan akses komputer lokal dengan Work Cloud akan menghentikan giliran yang sedang berjalan. Pengguna dapat memulai giliran baru dalam percakapan cloud yang sudah ada. Giliran tersebut secara otomatis menggunakan Work Cloud tanpa akses ke file lokal. Beri tahu pengguna untuk memulai giliran baru setelah penghentian tersebut dan jelaskan bahwa file lokal tidak lagi tersedia bagi utas cloud.