Pamamahala ng mga project sa API platform

Layunin ng mga proyekto na bigyan ang mga customer ng kakayahang ayusin ang kanilang trabaho. Maaaring pamahalaan ng mga organisasyon ang access at mga limitasyon, mag-provision ng mga service account (sa pamamagitan ng UI), at subaybayan ang paggamit ayon sa isang nakatakdang saklaw sa loob ng isang proyekto (hal., mga modelo, kakayahan, thread, assistant, fine tuning, storage, atbp.). Maaaring hatiin ayon sa proyekto ang aktibidad sa paggamit, at maaaring tingnan ng mga user ang billing at magtakda ng mga limitasyon sa paggastos para sa bawat proyekto.

Makikita ng mga may-ari ng organisasyon ang lahat ng kanilang Active at Archived na proyekto sa page ng Projects. Matuto pa tungkol sa mga role at pahintulot ng user sa API Platform.

Sino ang maaaring gumawa ng proyekto?

Tanging mga may-ari ng organisasyon ang maaaring gumawa ng proyekto. Mangyaring sumangguni sa mga tungkulin at pahintulot para sa higit pang impormasyon.

Para lumipat sa pagitan ng mga organisasyon, i-hover ang cursor sa pangalan ng iyong organisasyon sa itaas na kaliwa ng page at piliin ang organisasyon mula sa listahan:

Para sa mga organisasyong nasa consolidated billing plan, magkakahiwalay na tinutukoy ang mga sub-org. Hindi maaaring gumawa ng mga proyekto sa loob ng mga sub-org.

Paano gumagana ang mga proyekto?

Kasama sa bawat organisasyon ang isang “Default project” na hindi maaaring i-delete. Maaari mong i-configure ang mga rate limit, mga pahintulot sa virtual na modelo, at mga limitasyon sa paggastos (simula Nobyembre 2024). Namamana nito ang buong configuration ng organisasyon, kaya hindi ka maaaring direktang magdagdag dito ng mga miyembro o service account.

Paano ako gagawa ng proyekto?

Una, itapat ang cursor sa pangalan ng proyekto sa kaliwang sulok ng page at piliin ang Gumawa ng proyekto.

Maglagay ng pangalan, paglalarawan, at website para sa iyong proyekto, pagkatapos ay piliin ang Gumawa.

Paano ako magdaragdag ng mga user sa isang proyekto?

Hindi awtomatikong idinaragdag sa “Default na proyekto” ang mga bagong miyembro ng organisasyon. Maaaring imbitahan ang mga bagong miyembro sa proyekto habang iniimbitahan sila sa organisasyon (sa pamamagitan ng pag-enable sa checkbox na “Imbitahan sa default na proyekto”) o matapos nilang tanggapin ang imbitasyon sa organisasyon.

Ang mga user na inimbitahan sa pamamagitan ng Admin API ay napapailalim sa mga panuntunang nakasaad sa /organization/invites endpoint.

Kung magkaroon ng error habang nag-iimbita ng mga user sa isang proyekto sa pamamagitan ng UI o Admin API, tiyakin muna na umiiral at hindi naka-archive ang target na proyekto bago muling ipadala ang imbitasyon.

Awtomatikong idinaragdag bilang mga may-ari ng mga bagong proyekto sa organisasyon ang mga may-ari nito.

Ano ang iba’t ibang role ng user sa loob ng mga organisasyon at proyekto, at anong mga pahintulot ang kasama sa mga ito?

Samantalang may mga role na ‘owner’ at ‘reader’ ang Mga Organisasyon, may mga role naman na ‘owner’ at ‘member’ ang mga proyekto. Ang mga miyembro ng proyekto ay katumbas ng mga reader ng organisasyon. Sumangguni sa talahanayan sa ibaba para sa mas detalyadong paglalarawan ng mga pahintulot na kasama ng bawat role ng user.

Kung hindi ako May-ari sa organisasyon, ano ang maa-access ko?

Ang mga user na hindi May-ari sa organisasyon ay makakakita lamang ng mga proyektong kinabibilangan nila. Tanging may-ari ng organisasyon ang makakakita ng lahat ng proyekto, miyembro, at API key sa antas ng proyekto at makaka-access sa page ng Mga Proyekto.

• Tanging mga miyembro ng proyekto (at mga may-ari ng organisasyon) ang makakakita ng mga fine-tuned na modelo na ginawa sa proyektong iyon, mga thread mula sa anumang Assistants na ginawa, o anumang idinagdag na file.

• Makikita ng mga miyembro ng proyekto ang lahat ng iba pang miyembro nito at ang kanilang mga tungkulin (hal., May-ari o Miyembro).

Paano ko ia-update ang tungkulin ng isang user sa proyekto o aalisin ang user sa proyekto?

Tanging May-ari ng proyekto ang maaaring mag-update ng tungkulin ng isang user sa proyekto o mag-alis ng user mula rito. Para sa higit pang impormasyon, sumangguni sa mga tungkulin at pahintulot.

Para i-update ang isang user sa proyekto, pumunta sa iyong mga setting ng organisasyon, piliin ang proyekto, at i-click ang Mga Miyembro. Maaari mong itakda ang tungkulin ng bawat miyembro bilang Miyembro o May-ari. Maaari mo ring piliin ang Alisin upang alisin ang user sa proyekto.

Ano ang service account, at paano ito naiiba sa regular na user account?

Ang service account ay gumaganap bilang isang pseudo-user na dinisenyo para sa access ng system, na naiiba sa mga indibidwal na user account. Tanging mga owner ng organisasyon at project ang maaaring gumawa ng mga service account.

Magdagdag ng miyembro sa isang proyekto

Kapag na-click mo ang button na + Magdagdag ng miyembro, makikita mo ang listahan ng mga user sa iyong organisasyon na may tungkuling Mambabasa. Kung gusto mong magdagdag ng user na wala pa sa iyong organisasyon, kailangan mo muna siyang idagdag sa organisasyon (maaari mong panatilihing walang check ang checkbox na “Idagdag sa Default na Proyekto” kung ayaw mong bigyan ng mas malawak na access ang mga user na ito). Hindi kasama sa listahang ito ang mga service account. Sa hakbang na ito, maaari mong piliing gawing May-ari o Miyembro ang kanilang tungkulin:

Kapag nagdagdag ka ng miyembro ng team, dapat mo siyang italaga bilang Miyembro o May-ari. Maaaring gumawa ang mga miyembro ng proyekto ng mga API request na nagbabasa o nagbabago ng data, samantalang maaari ding baguhin ng mga may-ari ng proyekto ang mga setting at limitasyon sa paggastos ng proyekto at pamahalaan ang mga miyembro nito. Para sa higit pang impormasyon, sumangguni sa mga tungkulin at pahintulot.

Paano gumawa ng service account para sa isang proyekto

Pumunta muna sa proyektong gusto mong gawan ng service account sa pamamagitan ng pagpili rito mula sa dropdown sa navigation bar:

Pagkatapos, pumunta sa iyong mga setting ng organisasyon -> Proyekto -> Mga Miyembro -> i-click ang + Service account:

Pangalanan ang service account

Hindi alintana kung gagawa ka ng service account sa antas ng organisasyon o ng natatangi para sa isang project, kapag gumawa ka ng service account maaari kang lumikha ng natatanging service account ID na binubuo ng mga titik, numero, at gitling upang madaling matukoy ang service account.

I-save ang API key ng service account

Pagkapili sa button na Gumawa, agad na gagawa ng API key para sa service account at ipapakita ang secret key. I-save ang secret key na ito sa isang ligtas at secure na lugar. Para sa seguridad, hindi mo na ito muling makikita sa iyong OpenAI account. Kung mawala mo ang secret key na ito, kailangan mong gumawa ng bago.

Bilang default, may pahintulot ang API key ng service account na basahin at baguhin ang lahat ng API resource ng proyekto. Maaaring i-update ang mga pahintulot na ito sa mga setting ng Mga API Key ng iyong proyekto.

Nakalista ang mga service account kasama ng mga miyembro ng proyekto sa page ng mga setting ng miyembro nito. Sumangguni rito upang matuto pa tungkol sa pag-update o pag-alis ng access ng isang service account sa page ng mga setting ng miyembro ng iyong proyekto.

Pinamamahalaan ang mga service account tulad ng mga karaniwang account. Mula sa Organisasyon -> menu ng Mga Miyembro, maaari mong Alisin ang isang service account o i-update ang tungkulin:

Paano ko pamamahalaan ang mga API key sa mga proyekto ng aking organisasyon?

Maaari kang gumawa at mamahala ng mga API key para sa bawat proyekto sa page ng mga setting nito. Sa iyong mga setting ng organisasyon, piliin ang proyekto at i-click ang Mga API Key.

Para gumawa ng bagong secret key, piliin ang + Gumawa ng bagong secret key. Maaari mo ring piliin ang icon na I-edit sa tabi ng isang secret key upang baguhin ang mga pahintulot nito.

Maaari kang magtakda ng mga pahintulot para sa bawat API key kapag gumagawa ng bagong secret key o nag-e-edit ng umiiral na key.

May tatlong antas ng pahintulot: Lahat, Pinaghihigpitan, at Read Only.

• Lahat — Itinatakda ang lahat ng pahintulot para sa secret key. Ito ang default na setting.

• Pinaghihigpitan — Nagbibigay-daan sa user na magtakda ng mga pahintulot na Wala, Magbasa, at Magsulat para sa bawat endpoint.

• Halimbawa, gagawa ka ng API key na sadyang walang pahintulot na Magbasa o Magsulat sa /v1/assistants endpoint:

• Read Only — Itinatakda ang pahintulot na magbasa para sa lahat ng endpoint.

Paano pinamamahalaan ang access para sa mga user na kabilang sa maraming project o organisasyon?

Ang mga user ay maaaring maging miyembro ng kasingdaming project hangga't kinakailangan. Sa loob ng isang project, maaaring gumawa ang mga user ng personal na API key na saklaw at limitado sa pag-access sa project na iyon at sa mga resource nito.

Paano ko itatakda at pamamahalaan ang mga rate limit para sa mga proyekto ng aking organisasyon?

Tanging ang May-ari ng isang organisasyon ang maaaring magtakda at mamahala ng mga rate limit sa antas ng proyekto. Mangyaring sumangguni sa mga tungkulin at pahintulot para sa higit pang impormasyon.

Sa iyong mga setting ng organisasyon, i-click ang proyektong gusto mong i-update at piliin ang Mga Limitasyon sa seksyong Proyekto ng navigation list. Maaari mong i-update ang iyong Paggamit ng Modelo sa page na ito.

Ang paggamit ng modelo ay nagbibigay-daan sa iyong i-configure kung aling mga modelo ang maaaring gamitin ng proyekto, at maaaring magtakda ng mga rate limit para sa bawat modelo kung kinakailangan.

Paano ko itatakda at pamamahalaan ang mga limitasyon sa paggastos para sa mga proyekto ng aking organisasyon?

Tanging mga May-ari ng organisasyon at mga May-ari ng proyekto ang maaaring magtakda at mamahala ng mga limitasyon sa paggastos ng proyekto. Para sa higit pang impormasyon, sumangguni sa mga tungkulin at pahintulot. Para baguhin ang mga limitasyon sa antas ng organisasyon, sa iyong mga setting ng organisasyon, i-click ang Mga Limitasyon, at mag-scroll pababa sa Mga limitasyon sa paggamit.

Para itakda ang mga limitasyon ng proyekto, sa iyong mga setting ng organisasyon, i-click ang proyektong gusto mong i-update at piliin ang Mga Limitasyon. Maaari mong i-update ang Buwanang limitasyon sa paggastos, Threshold ng notification, at Paggamit ng Modelo.

Sa pagtatakda ng buwanang limitasyon sa paggastos, makakagawa ka ng mga hindi mahigpit na threshold sa paggastos para sa iyong proyekto. Kapag lumampas ang paggamit sa limitasyong ito sa loob ng isang buwan sa kalendaryo (UTC), patuloy na ipoproseso ang mga API request nang walang pagkaantala. Idinisenyo ang feature na ito upang makatulong sa pagsubaybay sa paggamit sa pamamagitan ng mga alerto sa limitasyon sa paggastos, ngunit hindi ito nagpapatupad ng mahigpit na hangganan sa paggastos. Kapag gumawa ng limitasyon sa paggastos ng proyekto, awtomatikong gagawa ng alerto sa 100% threshold. Maaaring magtakda ng mga karagdagang alerto sa ibang mga threshold sa pamamagitan ng pag-click sa Magdagdag ng Alerto.

Tandaang palaging matatanggap ng mga may-ari ng organisasyon at proyekto ang mga mensaheng ito at hindi ito maaaring i-customize.

Paano ako magtatakda ng mga limitasyon sa paggastos para sa aking organisasyon o proyekto?

Sinusuportahan na ngayon ng OpenAI ang buwanang mga limitasyon sa paggastos sa API sa antas ng organisasyon at proyekto. Maaaring subaybayan ng isang limitasyon sa paggastos ang gastos nang hindi ito ipinapatupad, o maaari mo itong ipatupad bilang mahigpit na limitasyon upang mabigo ang mga kahilingan sa API kapag umabot na sa limitasyon ang paggastos. Para sa pinakabagong mga hakbang sa configuration at behavior, tingnan ang Spend limits sa dokumentasyon para sa developer.

Paano ko ide-delete o ia-archive ang isang proyekto?

Maaaring i-archive ang mga proyekto sa bagong page ng listahan ng mga proyekto o sa mga setting ng bawat proyekto. Kapag na-archive na ang isang proyekto, hindi na ito maibabalik. Kapag nagpatuloy ka sa pag-archive, hihilingin sa iyong ilagay ang pangalan ng proyekto bago magpatuloy.

Makikita mo ang listahan ng lahat ng naka-archive na proyekto sa tab na “Naka-archive” sa parehong page ng listahan ng mga proyekto.

Hindi maaaring mag-delete ng mga proyekto. Nagpapanatili kami ng kasaysayan ng lahat ng proyekto upang matiyak ang tuloy-tuloy na pagsubaybay sa paggamit at pagsingil.

May limit ba sa bilang ng mga project na maaari kong magkaroon sa aking organisasyon?

Maaaring gumawa ang mga organisasyon ng hanggang 2,000 project bilang default.

Maaari bang ibahagi ang mga resource sa iba't ibang project?

Ang mga resource ng project (gaya ng mga file, assistant, storage, o thread) ay saklaw lang ng project at hindi maa-access ng mga non-admin na miyembro sa labas ng project. Bukod dito, hindi maaaring ilipat ang mga resource sa pagitan ng mga project.

Magkano ang quota sa storage ng file para sa bawat proyekto?

Kasalukuyang sinusuportahan ng OpenAI ang quota na 100 GB ng mga file sa bawat proyekto.

Kung lumampas sa quota na ito, makikita mo ang sumusunod na error:

Inirerekomenda naming tanggalin mo ang mga hindi nagagamit na file na naka-store sa iyong account. Bilang sanggunian, maaari mong tingnan at ilista ang mga file gamit ang API.

May-ari ako ng proyekto. Bakit hindi ko makita ang Dashboard ng Paggamit para sa aking proyekto?

Hindi nakabatay sa tungkulin ng isang user sa proyekto ang visibility ng Dashboard ng Paggamit ng proyekto. Sa halip, nakabatay ito sa iyong tungkulin sa organisasyon at sa mga setting sa https://platform.openai.com/settings/organization/data-controls/visibility

Kung hindi mo makita ang Dashboard ng Paggamit, malamang na nakatakda ang setting na ito sa “Nakikita ng mga may-ari ng organisasyon”.