Projek bertujuan memberi pelanggan keupayaan untuk mengatur kerja mereka. Organisasi boleh mengurus akses dan had, menyediakan akaun perkhidmatan (melalui UI) serta menjejaki penggunaan dalam skop terhad sesebuah projek (misalnya model, keupayaan, urutan, pembantu, penalaan halus, storan dan sebagainya). Aktiviti penggunaan boleh dipecahkan mengikut projek, manakala pengguna boleh melihat pengebilan dan menetapkan had perbelanjaan bagi setiap projek.
Pemilik organisasi boleh melihat semua projek Aktif dan Diarkibkan mereka pada halaman Projek. Ketahui lebih lanjut tentang peranan dan kebenaran pengguna dalam Platform API.
Siapakah yang boleh membuat projek?
Hanya pemilik organisasi boleh membuat projek. Sila rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut.
Untuk beralih antara organisasi, tuding pada nama organisasi anda di bahagian kiri atas halaman dan pilih organisasi daripada senarai:
Bagi organisasi yang menggunakan pelan pengebilan disatukan, suborganisasi dikenal pasti secara berasingan. Projek tidak boleh dibuat dalam suborganisasi.
Bagaimanakah projek berfungsi?
Setiap organisasi mempunyai “Projek lalai” yang tidak boleh dipadamkan. Anda boleh mengkonfigurasi had kadar, kebenaran model maya dan had perbelanjaan (setakat November 2024). Projek ini mewarisi konfigurasi penuh organisasi, jadi anda tidak boleh menambahkan ahli atau akaun perkhidmatan secara langsung padanya.
Bagaimanakah saya mencipta projek?
Mula-mula, tuding pada nama projek di sudut kiri halaman dan pilih Cipta projek.
Berikan nama, perihalan dan laman web untuk projek anda, kemudian pilih Cipta.
Bagaimanakah saya menambahkan pengguna pada projek?
Ahli organisasi yang baru ditambahkan tidak ditambahkan secara automatik pada “Projek lalai”. Ahli baharu boleh dijemput ke projek semasa mereka dijemput menyertai organisasi (dengan menandai kotak pilihan "Jemput ke projek lalai") atau selepas mereka menerima jemputan organisasi.
Pengguna yang dijemput melalui API Pentadbir tertakluk pada peraturan yang diterangkan oleh titik akhir /organization/invites.
Jika ralat berlaku semasa menjemput pengguna ke projek melalui UI atau API Pentadbir, pastikan dahulu projek sasaran wujud dan tidak diarkibkan sebelum menghantar semula jemputan.
Pemilik organisasi ditambahkan secara automatik sebagai pemilik projek baharu yang dicipta dalam organisasi.
Apakah peranan pengguna yang berbeza dalam organisasi dan projek, serta kebenaran yang dimiliki oleh setiap peranan?
Walaupun organisasi mempunyai peranan ‘pemilik’ dan ‘pembaca’, projek mempunyai peranan ‘pemilik’ dan ‘ahli’. Ahli projek setara dengan pembaca organisasi. Sila rujuk jadual di bawah untuk mendapatkan penerangan lebih terperinci tentang kebenaran bagi setiap peranan pengguna.
| Peranan | Skop | Penerangan |
|---|---|---|
| Pemilik | Organisasi | Boleh membuat dan melihat semua projek, semua pengguna serta semua kunci API. Boleh memantau semua projek dalam organisasi melalui halaman Projek . Boleh menetapkan had perbelanjaan organisasi dan projek. Boleh memberikan kebenaran kepada orang lain dalam organisasi untuk melihat maklumat penggunaan. Boleh mengarkibkan projek. |
| Pembaca | Organisasi | Boleh melakukan inferens, menggunakan sumber dan membuat kunci dalam projek mereka. Boleh ditambahkan pada projek. Tidak boleh membuat projek dan mengurus pengguna. |
| Pemilik | Projek | Boleh menambahkan pengguna lain pada projek dan menamakan semula projek, serta mempunyai semua keupayaan Ahli. Boleh menetapkan had perbelanjaan projek. Boleh mengarkibkan projek. |
| Ahli | Projek | Boleh melakukan inferens, menggunakan sumber dan membuat kunci pada peringkat projek. |
Jika saya bukan Pemilik dalam organisasi, apakah yang boleh saya akses?
Pengguna yang bukan Pemilik dalam organisasi hanya boleh melihat projek yang disertai oleh mereka. Hanya pemilik organisasi boleh melihat semua projek, ahli dan kekunci API pada peringkat projek serta mempunyai akses kepada halaman Projek.
Hanya ahli projek (dan pemilik organisasi) boleh melihat model diperhalus yang dicipta dalam projek itu, jalur perbualan daripada mana-mana Assistant yang dicipta atau fail yang telah ditambahkan.
Ahli projek boleh melihat semua ahli lain dalam projek itu serta peranan mereka (iaitu Pemilik atau Ahli).
Bagaimanakah saya mengemas kini peranan projek pengguna atau mengalih keluar pengguna daripada projek?
Hanya Pemilik projek boleh mengemas kini peranan projek pengguna atau mengalih keluar pengguna daripada projek. Sila rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut.
Untuk mengemas kini pengguna dalam projek, buka tetapan organisasi anda, pilih projek tersebut dan klik Ahli. Anda boleh menetapkan peranan setiap ahli sebagai Ahli atau Pemilik. Anda juga boleh memilih Alih keluar untuk mengalih keluar pengguna daripada projek.
Apakah itu akaun perkhidmatan dan apakah perbezaannya daripada akaun pengguna biasa?
Akaun perkhidmatan bertindak sebagai pengguna maya yang direka untuk akses sistem dan berbeza daripada akaun pengguna individu. Hanya pemilik organisasi dan projek boleh membuat akaun perkhidmatan.
Akaun perkhidmatan hanya terhad kepada projek.
Tambahkan ahli pada projek
Jika anda mengklik butang + Tambah ahli, anda akan melihat senarai pengguna dalam organisasi anda yang mempunyai peranan Pembaca. Jika anda mahu menambahkan pengguna yang belum berada dalam organisasi anda, tambahkan mereka pada organisasi dahulu (anda boleh membiarkan kotak pilihan “Tambah pada Projek Lalai” tidak ditandai jika anda tidak mahu memberikan akses yang lebih luas kepada pengguna ini). Senarai ini tidak termasuk akaun perkhidmatan. Dalam langkah ini, anda boleh memilih peranan Pemilik atau Ahli untuk mereka:
Apabila menambahkan ahli pasukan, anda mesti memberikan peranan Ahli atau Pemilik kepada mereka. Ahli projek boleh membuat permintaan API yang membaca atau mengubah suai data, manakala pemilik projek juga boleh mengubah suai tetapan projek dan had perbelanjaan projek serta mengurus ahli projek. Sila rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut.
Cara mencipta akaun perkhidmatan untuk projek
Mula-mula, pergi ke projek yang ingin anda cipta akaun perkhidmatan untuknya dengan memilih daripada menu juntai bawah pada bar navigasi:
Kemudian, pergi ke tetapan organisasi anda -> Projek -> Ahli -> klik + Akaun perkhidmatan:
Akaun perkhidmatan yang dibuat pada peringkat projek adalah khusus untuk projek tersebut dan tidak boleh digunakan di luar projek tempat akaun itu dibuat.
Menamakan akaun perkhidmatan
Sama ada anda membuat akaun perkhidmatan pada peringkat organisasi atau akaun yang khusus untuk sesuatu projek, anda boleh mencipta ID akaun perkhidmatan unik yang terdiri daripada huruf, nombor dan tanda sempang supaya akaun itu mudah dikenal pasti.
Simpan kekunci API akaun perkhidmatan
Selepas memilih butang Cipta, kekunci API akan dicipta serta-merta untuk akaun perkhidmatan dan kekunci rahsia akan dipaparkan. Simpan kekunci rahsia ini di tempat yang selamat dan terjamin. Atas sebab keselamatan, anda tidak akan dapat melihatnya lagi melalui akaun OpenAI anda. Jika kekunci rahsia ini hilang, anda perlu menjana kekunci yang baharu.
Kebenaran kekunci API akaun perkhidmatan ditetapkan secara lalai untuk membaca dan menulis semua sumber API projek. Kebenaran ini boleh dikemas kini dalam tetapan Kekunci API projek anda.
Akaun perkhidmatan disenaraikan bersama ahli projek pada halaman tetapan ahli projek anda. Sila rujuk di sini untuk mengetahui lebih lanjut tentang cara mengemas kini atau mengalih keluar akses akaun perkhidmatan pada halaman tetapan ahli projek anda.
Semua akaun perkhidmatan daripada projek dan organisasi akan dipaparkan bersama pengguna manusia anda pada halaman ahli peringkat organisasi.
Akaun perkhidmatan diurus seperti akaun biasa. Daripada Organisasi -> menu Ahli, anda boleh Mengalih keluar akaun perkhidmatan atau mengemas kini peranannya:
Bagaimanakah saya mengurus kekunci API dalam projek organisasi saya?
Anda boleh mencipta dan mengurus kekunci API bagi setiap projek pada halaman tetapan projek tersebut. Dalam tetapan organisasi anda, pilih projek tersebut dan klik Kekunci API.
Untuk mencipta kekunci rahsia baharu, pilih + Cipta kekunci rahsia baharu. Anda juga boleh memilih ikon Edit di sebelah kekunci rahsia untuk mengedit kebenarannya.
Anda boleh menetapkan kebenaran bagi setiap kekunci API semasa mencipta kekunci rahsia baharu atau dengan mengedit kekunci sedia ada.
Tiga tahap kebenaran tersedia: Semua, Terhad dan Baca Sahaja.
Semua — Kebenaran penuh ditetapkan untuk kekunci rahsia. Ini ialah tetapan lalai.
Terhad — Membolehkan pengguna menetapkan kebenaran Tiada, Baca dan Tulis bagi setiap titik akhir.
Sebagai contoh, anda mencipta kekunci API yang secara khusus tidak mempunyai kebenaran Baca atau Tulis untuk titik akhir /v1/assistants:
Baca Sahaja — Kebenaran membaca ditetapkan untuk semua titik akhir.
Bagaimanakah akses diurus untuk pengguna yang menyertai berbilang projek atau organisasi?
Pengguna boleh menjadi ahli sebanyak mana projek yang diperlukan. Dalam projek, pengguna boleh menjana kunci API peribadi yang skop dan aksesnya terhad kepada projek tersebut serta sumbernya.
Bagaimanakah saya menetapkan dan mengurus had kadar untuk projek organisasi saya?
Hanya Pemilik organisasi boleh menetapkan dan mengurus had kadar pada peringkat projek. Sila rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut.
Dalam tetapan organisasi anda, klik projek yang mahu dikemas kini dan pilih Had dalam bahagian Projek pada senarai navigasi. Anda boleh mengemas kini Penggunaan Model pada halaman ini.
Penggunaan model membolehkan anda menetapkan model yang boleh digunakan oleh projek, manakala had kadar boleh ditetapkan bagi setiap model mengikut keperluan.
Bagaimanakah saya menetapkan dan mengurus had perbelanjaan untuk projek organisasi saya?
Hanya Pemilik organisasi dan Pemilik projek boleh menetapkan serta mengurus had perbelanjaan projek. Sila rujuk peranan dan kebenaran untuk mendapatkan maklumat lanjut. Untuk mengubah had pada peringkat organisasi, buka tetapan organisasi anda, klik Had, kemudian tatal ke bawah ke Had penggunaan.
Untuk menetapkan had projek, buka tetapan organisasi anda, klik projek yang ingin dikemas kini dan pilih Had. Anda boleh mengemas kini Had perbelanjaan bulanan, Ambang pemberitahuan dan Penggunaan Model.
Menetapkan had perbelanjaan bulanan membolehkan anda menentukan ambang perbelanjaan tidak tegar untuk projek anda. Apabila penggunaan melebihi had ini dalam bulan kalendar tertentu (UTC), permintaan API akan terus diproses tanpa gangguan. Ciri ini direka untuk membantu anda memantau penggunaan melalui amaran had perbelanjaan, tetapi tidak menguatkuasakan had maksimum perbelanjaan yang tegar. Apabila had perbelanjaan projek dicipta, amaran pada ambang 100% akan dicipta secara lalai. Amaran tambahan pada ambang yang berbeza boleh ditetapkan dengan mengklik Tambah Amaran.
Harap maklum bahawa pemilik organisasi dan pemilik projek akan sentiasa menerima mesej ini dan perkara ini tidak boleh disesuaikan.
Bagaimanakah saya menetapkan had perbelanjaan untuk organisasi atau projek saya?
OpenAI kini menyokong had perbelanjaan API bulanan pada peringkat organisasi dan projek. Had perbelanjaan boleh memantau perbelanjaan tanpa penguatkuasaan, atau anda boleh menguatkuasakannya sebagai had keras supaya permintaan API gagal selepas perbelanjaan mencapai had tersebut. Untuk mengetahui langkah konfigurasi dan gelagat terkini, lihat Had perbelanjaan dalam dokumentasi pembangun.
Bagaimanakah saya memadamkan atau mengarkibkan projek?
Projek boleh diarkibkan melalui halaman senarai projek yang baharu atau melalui tetapan projek berkenaan. Setelah projek diarkibkan, projek itu tidak boleh dipulihkan. Apabila meneruskan proses pengarkiban, anda akan diminta memasukkan nama projek untuk meneruskan.
Anda boleh melihat senarai semua projek yang diarkibkan melalui tab “Diarkibkan” pada halaman senarai projek yang sama.
Projek tidak boleh dipadamkan. Kami menyimpan sejarah semua projek untuk memastikan kesinambungan penjejakan penggunaan dan pengebilan.
Adakah terdapat had bilangan projek yang boleh dimiliki oleh organisasi saya?
Secara lalai, organisasi boleh membuat sehingga 2,000 projek.
Bolehkah sumber dikongsi antara projek?
Sumber projek (seperti fail, pembantu, storan atau urutan) terhad kepada projek dan tidak boleh diakses oleh ahli bukan pentadbir dari luar projek. Selain itu, sumber tidak boleh dipindahkan antara projek.
Satu-satunya pengecualian ialah model yang ditala halus dalam "Projek lalai" boleh diakses daripada projek lain.
Apakah kuota storan fail bagi setiap projek?
OpenAI kini menyokong kuota storan fail sebanyak 100 GB bagi setiap projek.
Jika kuota ini dilampaui, anda akan melihat ralat berikut:
Anda telah melebihi kuota storan fail. Organisasi dihadkan kepada 100 GB fail. Sila kurangkan saiz fail atau hubungi sokongan.Kami mengesyorkan agar anda memadamkan fail tidak digunakan yang disimpan dalam akaun anda. Sebagai rujukan, anda boleh melihat dan menyenaraikan fail menggunakan API.
Saya pemilik projek. Mengapakah saya tidak dapat melihat Papan Pemuka Penggunaan projek saya?
Keterlihatan Papan Pemuka Penggunaan projek tidak berkaitan dengan peranan pengguna dalam projek tersebut. Sebaliknya, keterlihatan itu ditentukan oleh peranan anda dalam organisasi dan tetapan di https://platform.openai.com/settings/organization/data-controls/visibility
Jika anda tidak dapat melihat Papan Pemuka Penggunaan, tetapan ini mungkin ditetapkan kepada "Kelihatan kepada pemilik organisasi".