Layunin ng mga proyekto na bigyan ang mga customer ng kakayahang isaayos 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 laban sa isang limitadong saklaw sa loob ng proyekto (hal. mga modelo, kakayahan, thread, assistant, fine tuning, storage, atbp.). Maaaring hati-hatiin ang aktibidad ng paggamit ayon sa proyekto, at maaaring tingnan ng mga user ang billing at magtakda ng mga badyet kada proyekto.
Maaaring tingnan ng mga may-ari ng organisasyon ang lahat ng kanilang Aktibo at Naka-archive na proyekto sa page ng Mga Proyekto. Matuto pa tungkol sa mga tungkulin 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 project?
Bawat organisasyon ay may kasamang “Default project” na hindi maaaring i-delete. Maaari mong i-configure ang mga rate limit, mga pahintulot ng virtual na modelo, at mga budget sa paggastos (mula 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 tungkulin ng user sa loob ng mga organisasyon at proyekto, at anong mga pahintulot ang kasama sa mga ito?
Habang ang mga Organisasyon ay may mga tungkuling ‘may-ari’ at ‘reader’, ang mga proyekto ay may mga tungkuling ‘may-ari’ at ‘miyembro’. Ang mga miyembro ng proyekto ay katulad ng mga reader ng organisasyon. Mangyaring sumangguni sa talahanayan sa ibaba para sa mas detalyadong paglalarawan ng mga pahintulot na kasama sa bawat tungkulin ng user.
| Tungkulin | Saklaw | Paglalarawan |
|---|---|---|
| May-ari | Organisasyon | Maaaring gumawa/tingnan ang lahat ng proyekto, lahat ng user, lahat ng API key. May kakayahang mag-monitor sa lahat ng proyekto sa loob ng organisasyon gamit ang page ng Mga Proyekto . Maaaring magtakda ng mga badyet ng organisasyon at mga badyet ng proyekto. Maaaring magbigay ng mga pahintulot para makita ng iba sa org ang impormasyon sa paggamit. Maaaring mag-archive ng mga proyekto. |
| Reader | Organisasyon | Maaaring magsagawa ng inference, gumamit ng mga resource, at gumawa ng mga key sa kanilang mga proyekto. Maaaring idagdag sa mga proyekto. Hindi maaaring gumawa ng mga proyekto at mamahala ng mga user. |
| May-ari | Proyekto | Maaaring magdagdag ng ibang mga user sa proyekto at palitan ang pangalan ng proyekto, pati na rin ang lahat ng kakayahan ng isang Miyembro. Maaaring magtakda ng mga badyet ng proyekto. Maaaring i-archive ang proyekto. |
| Miyembro | Proyekto | Maaaring magsagawa ng inference, gumamit ng mga resource, at gumawa ng mga key sa antas ng proyekto. |
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.
Ang mga service account ay para lamang sa mga project.
Magdagdag ng miyembro sa isang proyekto
Kung iki-click mo ang button na + Add member, makikita mo ang listahan ng mga user sa iyong organisasyon na may tungkuling Reader. Kung gusto mong idagdag ang user na kasalukuyang wala sa iyong organisasyon, kailangan mo muna silang idagdag sa organisasyon (maaari mong panatilihing hindi naka-check ang checkbox na “Idagdag sa Default Project” kung ayaw mong bigyan ang mga user na ito ng mas malawak na access). Hindi isasama sa listahang ito ang mga service account. Sa hakbang na ito, maaari mong piliin kung ang kanilang tungkulin ay Owner o Member:
Kapag nagdaragdag ka ng miyembro ng team, dapat mong italaga sa kanila ang tungkuling Miyembro o May-ari. Ang mga miyembro ng proyekto ay maaaring gumawa ng mga API request na nagbabasa o nagbabago ng data, samantalang ang mga may-ari ng proyekto ay maaari ring magbago ng mga setting at badyet ng proyekto at mamahala ng mga miyembro ng proyekto. Mangyaring sumangguni sa mga tungkulin 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:
Ang mga service account na ginawa sa antas ng project ay natatangi sa project at hindi maaaring gamitin sa labas ng project kung saan sila ginawa.
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.
Ipapakita ang lahat ng service account sa parehong mga proyekto at organisasyon kasama ng iyong mga human user sa page ng mga miyembro sa antas ng organisasyon.
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 itatakda at pamamahalaan ang mga badyet para sa mga proyekto ng aking organisasyon?
Tanging ang mga May-ari ng isang organisasyon at mga May-ari ng isang proyekto ang maaaring magtakda at mamahala ng mga badyet ng proyekto. Mangyaring sumangguni sa mga tungkulin 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 Mga Limitasyon, at mag-scroll pababa sa Mga limitasyon sa paggamit.
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 Mga Limitasyon. Maaari mong i-update ang iyong Buwanang badyet, Threshold ng notification, at Paggamit ng Modelo.
Ang pagtatakda ng buwanang badyet ay nagbibigay-daan sa iyong 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 API request nang walang pagkaantala. Idinisenyo ang feature na ito upang tulungan kang subaybayan ang paggamit sa pamamagitan ng mga alerto sa badyet, ngunit hindi ito nagpapatupad ng hard cap sa paggastos. Kapag ginawa ang badyet ng proyekto, bilang default, gagawa ng alerto sa 100% threshold. Maaaring magtakda ng karagdagang mga badyet sa iba’t ibang threshold sa pamamagitan ng pag-click sa Magdagdag ng Alerto.
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 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.
Ang nag-iisang exception ay ang mga fine tune sa "Default project" ay maaaring ma-access mula sa ibang 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:
Lumampas ka na sa quota ng iyong file storage. Ang mga organisasyon ay limitado sa 100 GB ng mga file. Pakibawasan ang laki ng file o makipag-ugnayan sa support.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”.