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 project?

Una, i-hover ang pangalan ng project sa kaliwang sulok ng page at piliin ang Create project.

Magbigay ng pangalan, paglalarawan, at website para sa iyong project at pagkatapos ay piliin ang Create.

Paano ako magdaragdag ng mga user sa isang proyekto?

Ang mga bagong idinagdag na miyembro ng organisasyon ay hindi awtomatikong naidaragdag sa “Default project”. Maaaring imbitahan ang mga bagong miyembro sa proyekto kapag inimbitahan sila sa organisasyon (sa pamamagitan ng pag-enable sa checkbox na “Imbitahan sa default project”) o matapos tanggapin ng miyembro ang imbitasyon sa organisasyon.

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

Kung makaranas ka ng error kapag nag-iimbita ng mga user sa isang proyekto sa pamamagitan ng UI o Admin API, kumpirmahin muna na umiiral ang target na proyekto at hindi ito naka-archive bago muling ipadala ang imbitasyon.

Ang mga may-ari ng organisasyon ay awtomatikong idinaragdag bilang mga may-ari sa mga bagong proyektong ginawa sa loob ng isang organisasyon.

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 ang may-ari ng organisasyon ang makakakita ng lahat ng proyekto, miyembro, at API key sa antas ng proyekto, at may access sa page ng Mga Proyekto.

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

• Makikita ng mga miyembro ng isang proyekto kung sino ang iba pang mga miyembro ng proyektong iyon at ang kanilang mga tungkulin (ibig sabihin, May-ari o Miyembro).

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

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

Para i-update ang isang user sa isang proyekto, pumunta sa iyong mga setting ng organisasyon, piliin ang proyekto, at i-click ang Mga Miyembro. May opsyon kang itakda ang tungkulin ng bawat miyembro bilang Miyembro o May-ari. Maaari mo ring piliin ang Alisin upang alisin ang user mula 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 + Add member, makakakita ka ng listahan ng mga user sa iyong organisasyon na may role na Reader. Kung gusto mong idagdag ang isang user na kasalukuyang wala sa iyong organisasyon, kailangan mo muna siyang idagdag sa organisasyon (maaari mong panatilihing hindi naka-check ang checkbox na “Add to Default Project” kung ayaw mong bigyan ang mga user na ito ng mas malawak na access). Hindi kasama sa listahang ito ang mga service account. Sa hakbang na ito, maaari mong piliin kung ang role nila ay Owner o Member:

Kapag nagdagdag ka ng team member, dapat mong italaga sa kanya ang role na Member o Owner. Makakagawa ang mga miyembro ng proyekto ng mga kahilingan sa API na nagbabasa o nagbabago ng data, samantalang maaari ring baguhin ng mga may-ari ng proyekto ang mga setting ng proyekto at mga limitasyon sa paggastos ng proyekto, at pamahalaan ang mga miyembro ng proyekto. Sumangguni sa mga role at pahintulot para sa higit pang impormasyon.

Paano gumawa ng service account para sa isang proyekto

Una, pumunta sa proyektong gusto mong gawan ng service account sa pamamagitan ng pagpili mula sa dropdown na nasa 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

Pagkatapos piliin ang button na Gumawa, agad na gagawin ang isang API key para sa service account at ipapakita ang secret key. I-save ang secret key na ito sa ligtas at secure na lugar. Para sa mga kadahilanang panseguridad, hindi mo na ito muling matitingnan sa pamamagitan ng iyong OpenAI account. Kung mawala mo ang secret key na ito, kakailanganin mong gumawa ng bago.

Ang mga pahintulot ng API key ng service account ay naka-default sa pagbasa at pagsulat sa lahat ng API resource ng proyekto. Maaaring i-update ang mga pahintulot na ito sa mga setting ng API Keys ng iyong proyekto.

Nakalista ang mga service account kasama ng mga miyembro ng proyekto sa page ng mga setting ng miyembro ng iyong proyekto. Mangyaring sumangguni dito 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 loob ng mga proyekto ng aking organisasyon?

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

Para gumawa ng bagong secret key, piliin ang + Create new secret key. Maaari mo ring piliin ang icon na Edit sa tabi ng isang secret key upang i-edit ang mga pahintulot nito.

Maaari kang magtakda ng mga pahintulot para sa bawat isa sa iyong mga API key kapag gumagawa ka ng bagong secret key o sa pamamagitan ng pag-edit ng kasalukuyang key.

May tatlong antas ng pahintulot: Lahat, Pinaghigpitan, at Basahin Lang.

• Lahat — Nakatakda ang buong pahintulot para sa secret key. Ito ang default na setting.

• Pinaghigpitan — Pinapahintulutan ang user na magtakda ng Wala, Basahin, at Isulat na mga pahintulot para sa bawat endpoint.

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

    

• Basahin Lang — Nakatakda ang mga 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 itinatakda at pinamamahalaan ang mga limitasyon sa paggastos para sa mga proyekto ng aking organisasyon?

Tanging ang mga Owner ng isang organisasyon at mga Owner ng isang proyekto ang maaaring magtakda at mamahala ng mga limitasyon sa paggastos ng proyekto. Sumangguni sa mga role at pahintulot para sa higit pang impormasyon. Para baguhin ang mga limitasyon sa antas ng organisasyon, sa iyong mga setting ng organisasyon, i-click ang Limits, at mag-scroll pababa sa Usage limits.

Para itakda ang mga limitasyon ng iyong proyekto, sa iyong mga setting ng organisasyon, i-click ang proyektong gusto mong i-update at piliin ang Limits. Maaari mong i-update ang iyong Monthly spend limit, Notification threshold, at Model Usage.

Sa pagtatakda ng buwanang limitasyon sa paggastos, maaari kang magtakda ng mga soft threshold sa paggastos para sa iyong proyekto. Kapag lumampas ang paggamit sa limitasyong ito sa loob ng isang partikular na buwan sa kalendaryo (UTC), patuloy na ipoproseso ang mga kahilingan sa API nang walang pagkaantala. Idinisenyo ang feature na ito para tulungan kang subaybayan ang paggamit sa pamamagitan ng mga alerto sa limitasyon sa paggastos, ngunit hindi ito nagpapatupad ng mahigpit na cap sa paggastos. Kapag gumawa ng limitasyon sa paggastos ng proyekto, bilang default, gagawa ng alerto sa threshold na 100%. Maaaring magtakda ng karagdagang mga alerto sa iba’t ibang threshold sa pamamagitan ng pag-click sa Add Alert.

Pakitandaan na palaging matatanggap ng mga may-ari ng organisasyon at mga may-ari ng 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 tatanggalin o ia-archive ang isang proyekto?

Maaaring i-archive ang mga proyekto sa pamamagitan ng bagong page ng listahan ng proyekto o sa mga setting ng isang indibidwal na proyekto. Kapag na-archive na ang isang proyekto, hindi na ito maibabalik. Kapag nagpapatuloy sa pag-archive, hihilingin sa iyong ilagay ang pangalan ng proyekto upang magpatuloy.

Maaari mong tingnan ang listahan ng lahat ng naka-archive na proyekto sa pamamagitan ng tab na “Naka-archive” sa parehong page ng listahan ng proyekto.

Hindi posibleng magtanggal ng mga proyekto; pinananatili namin ang history ng lahat ng proyekto upang matiyak ang continuity sa pagsubaybay sa paggamit at billing.

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.

Ano ang file storage quota bawat project?

Sa kasalukuyan, sinusuportahan ng OpenAI ang file storage quota na 100 GB ng mga file bawat project.

Kung malampasan ang 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?

Ang visibility ng Dashboard ng Paggamit ng isang proyekto ay hindi nauugnay sa tungkulin ng isang user sa loob ng proyekto. Sa halip, tinutukoy ito ng iyong tungkulin sa loob ng organisasyon at ng 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”.