OpenAI
Halaman ini diterjemah oleh mesin. Lihat artikel asal dalam bahasa Inggeris.

Mengurus projek dalam platform API

Dikemas kini: 1 hour ago

Projek bertujuan memberikan keupayaan kepada pelanggan untuk mengatur kerja mereka. Organisasi boleh mengurus akses dan had, menyediakan akaun perkhidmatan (melalui UI), serta menjejaki penggunaan terhadap skop terhad dalam projek (cth. model, keupayaan, threads, assistants, fine tuning, storan dan sebagainya). Aktiviti penggunaan boleh dipecahkan mengikut projek, dan pengguna boleh melihat pengebilan serta menetapkan belanjawan bagi setiap projek.

Pemilik organisasi boleh melihat semua projek Aktif dan Diarkibkan mereka pada halaman Projek. Ketahui lebih lanjut tentang peranan pengguna dan kebenaran dalam Platform API.

Image

Siapakah yang boleh membuat projek?

Hanya pemilik organisasi boleh membuat projek. Sila rujuk peranan dan kebenaran untuk maklumat lanjut.

Untuk bertukar antara organisasi, tuding pada nama organisasi anda di penjuru kiri atas halaman dan pilih organisasi daripada senarai:

Projects page with the organization switcher open, listing Personal and Staging organizations

Bagi organisasi yang menggunakan pelan pengebilan disatukan, suborganisasi dikenal pasti secara berasingan. Projek tidak boleh dibuat dalam suborganisasi.

Image

Bagaimanakah projek berfungsi?

Setiap organisasi menyertakan “Projek lalai” yang tidak boleh dipadam. Anda boleh mengkonfigurasi had kadar, kebenaran model maya dan belanjawan perbelanjaan (setakat November 2024). Ia mewarisi konfigurasi penuh organisasi, jadi anda tidak boleh menambah ahli atau akaun perkhidmatan terus kepadanya.

Bagaimanakah saya membuat projek?

Mula-mula, tuding pada nama projek di penjuru kiri halaman dan pilih Buat projek.

API platform project menu with Create project highlighted under Default project

Berikan nama, perihalan dan laman web untuk projek anda, kemudian pilih Create.

Create a new project dialog in the API platform with fields for project name, use case, and business website

Bagaimanakah saya menambah pengguna pada projek?

Ahli organisasi yang baru ditambah tidak ditambahkan secara automatik pada “Projek lalai”. Ahli baharu boleh dijemput ke projek sama ada semasa mereka dijemput ke organisasi (dengan mendayakan kotak semak "Jemput ke projek lalai") atau selepas ahli tersebut menerima jemputan organisasi.

Pengguna yang dijemput melalui Admin API mengikut peraturan yang digariskan oleh titik akhir /organization/invites.

Jika anda mengalami ralat semasa menjemput pengguna ke projek melalui UI atau Admin API, mula-mula sahkan bahawa projek sasaran wujud dan tidak diarkibkan sebelum menghantar semula jemputan.

Pemilik organisasi ditambahkan secara automatik sebagai pemilik kepada projek baharu yang dibuat dalam organisasi.

Apakah peranan pengguna yang berbeza dalam organisasi dan projek, dan apakah kebenaran yang disertakan?

Sementara organisasi mempunyai peranan ‘pemilik’ dan ‘pembaca’, projek mempunyai peranan ‘pemilik’ dan ‘ahli’. Ahli projek adalah setara dengan pembaca organisasi. Sila rujuk jadual di bawah untuk penerangan yang lebih terperinci tentang kebenaran yang disertakan bagi setiap peranan pengguna.

PerananSkopPerihalan
PemilikOrganisasiBoleh membuat/melihat semua projek, semua pengguna dan semua kunci API. Mempunyai keupayaan untuk memantau semua projek dalam organisasi melalui

halaman Projek
. Boleh menetapkan belanjawan organisasi dan belanjawan projek. Boleh memberikan kebenaran kepada orang lain dalam organisasi untuk melihat maklumat penggunaan. Boleh mengarkibkan projek.
PembacaOrganisasiBoleh melakukan inferens, menggunakan sumber dan membuat kunci dalam projek mereka. Boleh ditambahkan pada projek.
Tidak boleh membuat projek dan mengurus pengguna.
PemilikProjekBoleh menambah pengguna lain pada projek dan menamakan semula projek, serta mempunyai semua keupayaan Ahli. Boleh menetapkan belanjawan projek. Boleh mengarkibkan projek.
AhliProjekBoleh 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 mereka sertai sebagai ahli. Hanya pemilik organisasi boleh melihat semua projek, ahli dan kunci API pada peringkat projek, serta mempunyai akses kepada halaman Projek.

  • Hanya ahli projek (dan pemilik organisasi) boleh melihat model fine tuned yang telah dibuat dalam projek tersebut, threads daripada mana-mana Assistants yang dibuat, atau sebarang fail yang telah ditambahkan.

  • Ahli projek boleh melihat siapa ahli lain dalam projek tersebut dan 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 maklumat lanjut.

Untuk mengemas kini pengguna dalam projek, pergi ke tetapan organisasi anda, pilih projek dan klik Ahli. Anda mempunyai pilihan untuk 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 bagaimanakah ia berbeza daripada akaun pengguna biasa?

Akaun perkhidmatan bertindak sebagai pengguna pseudo yang direka untuk akses sistem, 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 + Add member, anda akan melihat senarai pengguna dalam organisasi anda dengan peranan Reader. Jika anda mahu menambah pengguna yang belum berada dalam organisasi anda, anda perlu menambahkan mereka pada organisasi terlebih dahulu (anda boleh membiarkan kotak semak 'Tambah pada Projek Lalai" tidak ditanda jika anda tidak mahu memberikan akses yang lebih luas kepada pengguna ini). Senarai ini tidak akan menyertakan akaun perkhidmatan. Pada langkah ini, anda boleh memilih sama ada peranan mereka ialah Owner atau Member:

Project members with Add team members dialog assigning a user the Member role

Apabila anda menambah ahli pasukan, anda mesti menetapkan 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 belanjawan projek serta mengurus ahli projek. Sila rujuk peranan dan kebenaran untuk maklumat lanjut.

Cara membuat akaun perkhidmatan untuk projek

Mula-mula, pergi ke projek yang ingin anda buat akaun perkhidmatan untuknya dengan memilih daripada menu juntai bawah dalam bar navigasi:

API platform project switcher open with options to create a project or manage projects

Kemudian, pergi ke tetapan organisasi anda -> Projek -> Ahli -> klik + Service account:

Akaun perkhidmatan yang dibuat pada peringkat projek adalah unik kepada projek dan tidak boleh digunakan di luar projek tempat akaun tersebut dibuat.

Project Members page with Create a service account dialog after selecting the Service account option

Menamakan akaun perkhidmatan

Sama ada anda membuat akaun perkhidmatan pada peringkat organisasi atau membuat akaun yang unik kepada projek, apabila anda membuat akaun perkhidmatan, anda boleh mencipta ID akaun perkhidmatan unik yang terdiri daripada huruf, nombor dan tanda sempang supaya akaun perkhidmatan mudah dikenal pasti.

Simpan kunci API akaun perkhidmatan

Selepas memilih butang Buat, kunci API akan dibuat serta-merta untuk akaun perkhidmatan dan kunci rahsia akan dipaparkan. Simpan kunci rahsia ini di tempat yang selamat dan terjamin. Atas sebab keselamatan, anda tidak akan dapat melihatnya semula melalui akaun OpenAI anda. Jika anda kehilangan kunci rahsia ini, anda perlu menjana kunci baharu.

Members page with Save your key modal after creating a service account

Kebenaran kunci API akaun perkhidmatan ditetapkan secara lalai untuk membaca dan menulis semua sumber API projek. Kebenaran ini boleh dikemas kini dalam tetapan Kunci API projek anda.

Akaun perkhidmatan disenaraikan bersama ahli projek pada halaman tetapan ahli projek anda. Sila rujuk di sini untuk mengetahui lebih lanjut tentang mengemas kini atau mengalih keluar akses akaun perkhidmatan dalam halaman tetapan ahli projek anda.

Semua akaun perkhidmatan merentas 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:

OpenAI API Members settings with a service account role menu open for Reader or Owner

Bagaimanakah saya mengurus kunci API dalam projek organisasi saya?

Anda boleh membuat dan mengurus kunci API untuk setiap projek pada halaman tetapan projek tersebut. Dalam tetapan organisasi anda, pilih projek dan klik Kunci API.

Untuk membuat kunci rahsia baharu, pilih + Create new secret key. Anda juga boleh memilih ikon Edit di sebelah kunci rahsia untuk mengedit kebenarannya.

API keys page for a project with the Create new secret key button highlighted

Anda boleh menetapkan kebenaran untuk setiap kunci API anda apabila anda membuat kunci rahsia baharu atau dengan mengedit kunci sedia ada.

Tiga tahap kebenaran tersedia: Semua, Terhad dan Baca Sahaja.

  • Semua — Kebenaran penuh ditetapkan untuk kunci rahsia. Ini ialah tetapan lalai.

  • Terhad — Membolehkan pengguna menetapkan kebenaran Tiada, Baca dan Tulis untuk setiap titik akhir.

    • Contohnya, anda membuat kunci API yang secara khusus tidak mempunyai kebenaran untuk Membaca atau Menulis ke titik akhir /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Baca Sahaja — Kebenaran baca ditetapkan untuk semua titik akhir.

Bagaimanakah akses diurus untuk pengguna yang tergolong dalam berbilang projek atau organisasi?

Pengguna boleh menjadi ahli seberapa banyak projek yang diperlukan. Dalam projek, pengguna boleh menjana kunci API peribadi yang diskopkan dan dihadkan untuk mengakses projek tersebut serta sumbernya.

Bagaimanakah saya menetapkan dan mengurus had kadar untuk projek organisasi saya?

Hanya Pemilik organisasi boleh menetapkan dan mengurus had kadar peringkat projek. Sila rujuk peranan dan kebenaran untuk 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 anda pada halaman ini.

Penggunaan model membolehkan anda mengkonfigurasi model yang boleh digunakan oleh projek, dan had kadar boleh ditetapkan untuk setiap model mengikut keperluan.

Bagaimanakah saya menetapkan dan mengurus belanjawan untuk projek organisasi saya?

Hanya Pemilik organisasi dan Pemilik projek boleh menetapkan dan mengurus belanjawan projek. Sila rujuk peranan dan kebenaran untuk maklumat lanjut. Untuk menukar had pada peringkat organisasi, dalam tetapan organisasi anda, klik Had, dan tatal ke bawah ke Had penggunaan.

Project Limits page with organization budget controls, usage alerts, and model rate limits table

Untuk menetapkan had projek anda, dalam tetapan organisasi anda, klik projek yang mahu dikemas kini dan pilih Had. Anda boleh mengemas kini Belanjawan bulanan, Ambang pemberitahuan dan Penggunaan Model anda.

Menetapkan belanjawan bulanan membolehkan anda menentukan ambang perbelanjaan lembut 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 belanjawan, tetapi ia tidak menguatkuasakan had keras pada perbelanjaan. Apabila belanjawan projek dibuat, secara lalai, amaran akan dibuat pada ambang 100%. Belanjawan tambahan pada ambang yang berbeza boleh ditetapkan dengan mengklik Tambah Amaran.

Sila ambil perhatian bahawa pemilik organisasi dan pemilik projek akan sentiasa menerima mesej ini, dan perkara ini tidak boleh disesuaikan.

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

Bagaimanakah saya memadam atau mengarkibkan projek?

Projek boleh diarkibkan melalui halaman senarai projek baharu atau melalui tetapan projek individu. Setelah projek diarkibkan, projek tersebut tidak boleh dipulihkan. Apabila meneruskan 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.

API platform Projects page with the Archived tab selected to view archived projects

Projek tidak boleh dipadam; kami menyimpan sejarah semua projek untuk memastikan kesinambungan penjejakan penggunaan dan pengebilan.

Adakah terdapat had bilangan projek yang boleh saya miliki dalam organisasi saya?

Secara lalai, organisasi boleh membuat sehingga 2,000 projek.

Bolehkah sumber dikongsi merentas projek?

Sumber projek (seperti fail, assistants, storan atau threads) terhad kepada projek dan tidak boleh diakses oleh ahli bukan pentadbir di luar projek. Selain itu, sumber tidak boleh dipindahkan antara projek.

Satu-satunya pengecualian ialah fine tune dalam "Projek lalai" boleh diakses daripada projek lain.

Apakah kuota storan fail bagi setiap projek?

OpenAI pada masa ini menyokong kuota storan fail sebanyak 100 GB fail bagi setiap projek.

Jika kuota ini dilanggar, anda akan melihat ralat berikut:

Anda telah melebihi kuota storan fail anda. Organisasi dihadkan kepada 100 GB fail. Sila kurangkan saiz fail atau hubungi sokongan.

Kami mengesyorkan agar anda memadam fail yang tidak digunakan yang disimpan dalam akaun anda. Sebagai rujukan, anda boleh melihat dan menyenaraikan fail dengan API.

Saya pemilik projek, mengapakah saya tidak dapat melihat Papan Pemuka Penggunaan untuk projek saya?

Keterlihatan Papan Pemuka Penggunaan projek tidak berkaitan dengan peranan pengguna dalam projek. Sebaliknya, ia ditentukan oleh peranan anda dalam organisasi dan tetapan di https://platform.openai.com/settings/organization/data-controls/visibility

Project setting for Usage dashboard visibility with Visible to organization owners selected

Jika anda tidak dapat melihat Papan Pemuka Penggunaan, tetapan ini berkemungkinan ditetapkan kepada "Kelihatan kepada pemilik organisasi".

Adakah artikel ini membantu?