Project bertujuan memberi pelanggan kemampuan untuk mengatur pekerjaan mereka. Organisasi dapat mengelola akses dan batas, menyediakan service account (melalui UI), dan melacak penggunaan terhadap cakupan terbatas dalam sebuah project (mis. model, kapabilitas, thread, assistants, fine-tuning, penyimpanan, dll.). Aktivitas penggunaan dapat diuraikan per project, dan pengguna dapat melihat penagihan serta menetapkan anggaran per project.
Owner organisasi dapat melihat semua project Active dan Archived mereka di halaman Projects. Pelajari lebih lanjut tentang peran pengguna dan izin di API Platform.
Siapa yang dapat membuat project?
Hanya owner organisasi yang dapat membuat project. Silakan lihat peran dan izin untuk informasi selengkapnya.
Untuk beralih antar organisasi, arahkan kursor ke nama organisasi Anda di kiri atas halaman dan pilih organisasi dari daftar:
Untuk organisasi yang berada pada paket consolidated billing, sub-org diidentifikasi secara terpisah. Project tidak dapat dibuat di dalam sub-org.
Bagaimana cara kerja project?
Setiap organisasi menyertakan “Project default” yang tidak dapat dihapus. Anda dapat mengonfigurasi rate limit, izin model virtual, dan anggaran pengeluaran (per November 2024). Project ini mewarisi konfigurasi lengkap organisasi, sehingga Anda tidak dapat langsung menambahkan anggota atau service account ke dalamnya.
Bagaimana cara membuat project?
Pertama, arahkan kursor ke nama project di sudut kiri halaman lalu pilih Create project.
Berikan nama, deskripsi, dan situs web untuk project Anda lalu pilih Create.
Bagaimana cara menambahkan pengguna ke project?
Anggota organisasi yang baru ditambahkan tidak otomatis ditambahkan ke “Project default”. Anggota baru dapat diundang ke project baik saat mereka diundang ke organisasi (dengan mengaktifkan kotak centang "Invite to default project") maupun setelah anggota menerima undangan organisasi.
Pengguna yang diundang melalui Admin API mengikuti aturan yang dijelaskan oleh endpoint /organization/invites.
Jika Anda mengalami error saat mengundang pengguna ke project melalui UI atau Admin API, pertama pastikan bahwa project tujuan ada dan tidak diarsipkan sebelum mengirim ulang undangan.
Pemilik organisasi secara otomatis ditambahkan sebagai pemilik ke project baru yang dibuat dalam organisasi.
Apa saja peran pengguna yang berbeda dalam organisasi dan project, dan izin apa yang menyertainya?
Sementara Organisasi memiliki peran ‘owner’ dan ‘reader’, project memiliki peran ‘owner’ dan ‘member’. Anggota project serupa dengan reader organisasi. Silakan lihat tabel di bawah untuk penjelasan lebih rinci tentang izin yang menyertai tiap peran pengguna.
| Peran | Cakupan | Deskripsi |
|---|---|---|
| Owner | Organisasi | Dapat membuat/melihat semua project, semua pengguna, semua kunci API. Memiliki kemampuan untuk memantau semua project dalam organisasi dengan halaman Projects. Dapat menetapkan anggaran organisasi dan anggaran project. Dapat memberikan izin kepada orang lain di org untuk melihat informasi penggunaan. Dapat mengarsipkan project. |
| Reader | Organisasi | Dapat melakukan inferensi, menggunakan resource, dan membuat kunci di project mereka. Dapat ditambahkan ke project. Tidak dapat membuat project dan mengelola pengguna. |
| Owner | Project | Dapat menambahkan pengguna lain ke project dan mengganti nama project, serta semua kemampuan seorang Member. Dapat menetapkan anggaran project. Dapat mengarsipkan project. |
| Member | Project | Dapat melakukan inferensi, menggunakan resource, dan membuat kunci di tingkat project. |
Jika saya bukan Owner di organisasi, akses apa yang saya miliki?
Pengguna yang bukan Owner di organisasi hanya dapat melihat project yang mereka ikuti sebagai anggota. Hanya owner organisasi yang dapat melihat semua project, anggota, dan kunci API di tingkat project, serta memiliki akses ke halaman Projects.
Hanya anggota suatu project (dan owner organisasi) yang dapat melihat model fine-tuned yang telah dibuat dalam project tersebut, thread dari Assistants yang dibuat, atau file apa pun yang telah ditambahkan.
Anggota suatu project dapat melihat semua anggota lain di project tersebut beserta perannya (mis. Owner atau Member).
Bagaimana cara memperbarui peran project pengguna atau menghapus pengguna dari project?
Hanya Owner project yang dapat memperbarui peran project pengguna atau menghapus pengguna dari project. Silakan lihat peran dan izin untuk informasi selengkapnya.
Untuk memperbarui pengguna dalam project, buka pengaturan organisasi Anda, pilih project, lalu klik Members. Anda memiliki opsi untuk menetapkan peran setiap anggota sebagai Member atau Owner. Anda juga dapat memilih Remove untuk menghapus pengguna dari project.
Apa itu service account, dan apa bedanya dengan akun pengguna biasa?
Service account bertindak sebagai pseudo-user yang dirancang untuk akses sistem, berbeda dari akun pengguna individual. Hanya owner organisasi dan project yang dapat membuat service account.
Service account hanya dicakup ke project.
Tambahkan anggota ke project
Jika Anda mengklik tombol + Add member, Anda akan melihat daftar pengguna di organisasi Anda dengan peran Reader. Jika Anda ingin menambahkan pengguna yang saat ini belum berada dalam organisasi Anda, Anda harus menambahkan mereka ke organisasi terlebih dahulu (Anda dapat membiarkan kotak centang 'Add to Default Project" tidak dicentang jika Anda tidak ingin memberi pengguna ini akses yang lebih luas). Daftar ini tidak akan menyertakan service account. Pada langkah ini Anda dapat memilih apakah perannya adalah Owner atau Member:
Saat Anda menambahkan anggota tim, Anda harus menetapkan kepada mereka peran Member atau Owner. Anggota project dapat membuat permintaan API yang membaca atau mengubah data, sedangkan pemilik project juga dapat mengubah pengaturan project dan anggaran project serta mengelola anggota project. Silakan lihat peran dan izin untuk informasi selengkapnya.
Cara membuat service account untuk project
Pertama, navigasikan ke project tempat Anda ingin membuat service account dengan memilih dari dropdown yang ada di bilah navigasi:
Kemudian, buka pengaturan organisasi Anda -> Project -> Members -> klik + Service account:
Service account yang dibuat di tingkat project bersifat unik untuk project tersebut dan tidak dapat digunakan di luar project tempat service account itu dibuat.
Menamai service account
Terlepas dari apakah Anda membuat service account di tingkat organisasi atau membuat yang unik untuk project, saat Anda membuat service account, Anda dapat membuat ID service account unik yang terdiri dari huruf, angka, dan tanda hubung agar service account mudah diidentifikasi.
Simpan kunci API service account
Setelah memilih tombol Create, kunci API segera dibuat untuk service account dan secret key akan ditampilkan. Simpan secret key ini di tempat yang aman dan terlindungi. Demi alasan keamanan, Anda tidak akan dapat melihatnya lagi melalui akun OpenAI Anda. Jika Anda kehilangan secret key ini, Anda perlu membuat yang baru.
Izin kunci API service account secara default disetel ke read dan write untuk semua resource API project. Izin ini dapat diperbarui di pengaturan API Keys project Anda.
Service account tercantum bersama anggota project di halaman pengaturan anggota project Anda. Silakan lihat di sini untuk mempelajari lebih lanjut tentang memperbarui atau menghapus akses service account di halaman pengaturan anggota project Anda.
Semua service account di project maupun organisasi akan ditampilkan bersama pengguna manusia Anda di halaman anggota tingkat organisasi.
Service account dikelola seperti akun biasa. Dari Organization -> menu Members Anda dapat Remove service account atau memperbarui perannya:
Bagaimana cara mengelola kunci API dalam project organisasi saya?
Anda dapat membuat dan mengelola kunci API untuk tiap project di halaman pengaturan project tersebut. Di pengaturan organisasi Anda, pilih project, lalu klik API Keys.
Untuk membuat secret key baru, pilih + Create new secret key. Anda juga dapat memilih ikon Edit di sebelah secret key untuk mengedit izinnya.
Anda dapat menetapkan izin untuk tiap kunci API saat membuat secret key baru atau dengan mengedit kunci yang sudah ada.
Tiga tingkat izin tersedia: All, Restricted, dan Read Only.
All — Izin penuh ditetapkan untuk secret key. Ini adalah pengaturan default.
Restricted — Memungkinkan pengguna menetapkan izin None, Read, dan Write untuk tiap endpoint.
Misalnya, Anda membuat kunci API yang secara khusus tidak memiliki izin untuk Read atau Write ke endpoint /v1/assistants:
Read Only — Izin Read ditetapkan untuk semua endpoint.
Bagaimana akses dikelola untuk pengguna yang termasuk dalam beberapa project atau organisasi?
Pengguna dapat menjadi anggota sebanyak mungkin project yang diperlukan. Dalam sebuah project, pengguna dapat membuat kunci API pribadi yang dicakup dan dibatasi untuk mengakses project tersebut beserta resource-nya.
Bagaimana cara menetapkan dan mengelola rate limit untuk project organisasi saya?
Hanya Owner organisasi yang dapat menetapkan dan mengelola rate limit tingkat project. Silakan lihat peran dan izin untuk informasi selengkapnya.
Di pengaturan organisasi Anda, klik project yang ingin Anda perbarui dan pilih Limits di bagian Project pada daftar navigasi. Anda dapat memperbarui Model Usage di halaman ini.
Model usage memungkinkan Anda mengonfigurasi model mana yang dapat digunakan oleh project, dan rate limit dapat ditetapkan untuk tiap model sesuai kebutuhan.
Bagaimana cara menetapkan dan mengelola anggaran untuk project organisasi saya?
Hanya Owner organisasi dan Owner project yang dapat menetapkan dan mengelola anggaran project. Silakan lihat peran dan izin untuk informasi selengkapnya. Untuk mengubah batas di tingkat organisasi, di pengaturan organisasi Anda, klik Limits, lalu gulir ke bawah ke Usage limits.
Untuk menetapkan batas project Anda, di pengaturan organisasi Anda, klik project yang ingin Anda perbarui lalu pilih Limits. Anda dapat memperbarui Monthly budget, Notification threshold, dan Model Usage.
Menetapkan anggaran bulanan memungkinkan Anda membuat ambang pengeluaran lunak untuk project Anda. Saat penggunaan melebihi batas ini dalam bulan kalender tertentu (UTC), permintaan API akan tetap diproses tanpa gangguan. Fitur ini dirancang untuk membantu Anda memantau penggunaan melalui alert anggaran, tetapi tidak menerapkan batas pengeluaran yang ketat. Saat anggaran project dibuat, secara default alert akan dibuat pada ambang 100%. Anggaran tambahan pada ambang yang berbeda dapat ditetapkan dengan mengklik Add Alert.
Harap perhatikan bahwa owner organisasi dan owner project akan selalu menerima pesan ini dan ini tidak dapat disesuaikan.
Bagaimana cara menghapus atau mengarsipkan project?
Project dapat diarsipkan melalui halaman daftar project baru atau di pengaturan project individual. Setelah project diarsipkan, project tidak dapat dipulihkan. Saat melanjutkan pengarsipan, Anda akan diminta memasukkan nama project untuk melanjutkan.
Anda dapat melihat daftar semua project yang diarsipkan melalui tab “Archived” di halaman daftar project yang sama.
Menghapus project tidak dimungkinkan, kami menyimpan riwayat semua project untuk memastikan kesinambungan pelacakan penggunaan dan penagihan.
Apakah ada batas jumlah project yang dapat saya miliki dalam organisasi saya?
Secara default, organisasi dapat membuat hingga 2.000 project.
Bisakah resource dibagikan antar project?
Resource project (seperti file, assistants, penyimpanan, atau thread) dicakup ke project dan tidak dapat diakses oleh anggota non-admin di luar project. Selain itu, resource tidak dapat dipindahkan antar project.
Satu-satunya pengecualian adalah fine-tune di "Project default" dapat diakses dari project lain.
Berapa kuota penyimpanan file per project?
OpenAI saat ini mendukung kuota penyimpanan file sebesar 100 GB file per project.
Jika kuota ini terlampaui, Anda akan melihat error berikut:
Anda telah melampaui kuota penyimpanan file. Organisasi dibatasi hingga 100 GB file. Harap kurangi ukuran file atau hubungi dukungan.Kami menyarankan Anda menghapus file yang tidak digunakan dan disimpan di akun Anda. Sebagai referensi, Anda dapat melihat dan membuat daftar file dengan API.
Saya owner project, mengapa saya tidak bisa melihat Usage Dashboard untuk project saya?
Visibilitas Usage Dashboard project tidak terkait dengan peran pengguna dalam suatu project. Sebaliknya, hal itu ditentukan oleh peran Anda dalam organisasi dan pengaturan di https://platform.openai.com/settings/organization/data-controls/visibility
Jika Anda tidak dapat melihat Usage Dashboard, kemungkinan pengaturan ini disetel ke "Visible to organization owners".