Pamamahala ng mga project sa API platform

Pangkalahatang-ideya

Inaayos ng mga proyekto ang gawain sa loob ng isang organisasyon sa API. Gamitin ang mga ito para pamahalaan ang access, i-configure ang mga limitasyon sa modelo at rate limit, gumawa ng mga service account, at subaybayan ang paggamit, pagsingil, at mga limitasyon sa gastos para sa isang tinukoy na pangkat ng mga resource, gaya ng mga modelo, kakayahan, thread, assistant, fine-tuning, at storage.

Makikita ng mga may-ari ng organisasyon ang lahat ng aktibo at naka-archive na proyekto sa pahina ng Mga Proyekto.

Bago ka magsimula

Kailangan mong magkaroon ng tungkuling may-ari ng organisasyon para makagawa ng proyekto. Bilang default, makagagawa ang mga organisasyon ng hanggang 2,000 proyekto.

Kung gumagamit ng pinagsamang pagsingil ang iyong organisasyon, hiwalay na lumalabas ang mga sub-organisasyon sa tagapili ng organisasyon. Hindi ka makagagawa ng mga proyekto sa loob ng isang sub-organisasyon.

Para lumipat ng organisasyon, buksan ang tagapili ng organisasyon at piliin ang organisasyong gusto mong gamitin.

Default na proyekto

May Default na proyekto ang bawat organisasyon, at hindi ito maaaring i-delete. Namamana nito ang buong configuration ng organisasyon. Maaari mong i-configure ang mga rate limit, pahintulot sa virtual na modelo, at limitasyon sa gastos nito.

Hindi ka direktang makapagdaragdag ng mga miyembro o service account sa Default na proyekto. Maaari mong isama ang access sa Default na proyekto kapag nag-iimbita ng isang tao sa organisasyon, gamit ang mga hakbang sa pag-imbita sa organisasyon sa artikulong ito.

Gumawa ng proyekto

1. Buksan ang tagapili ng proyekto at piliin ang Gumawa ng proyekto.

2. Maglagay ng pangalan, paglalarawan, at website para sa iyong proyekto.

3. Piliin ang Gumawa.

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

Unawain ang mga tungkulin at access

Ibinubuod ng talahanayan ang mga tungkuling may-ari at tagabasa ng organisasyon, at may-ari at miyembro ng proyekto na ginagamit sa mga hakbang na ito. Katulad ng mga pahintulot ng mga tagabasa ng organisasyon ang mga pahintulot ng mga miyembro ng proyekto.

Para sa mga detalye ng tungkulin sa organisasyon, tingnan ang: mga tungkulin sa organisasyon. Para sa mga karagdagang tungkulin, custom na tungkulin, at kumpletong pahintulot, tingnan ang gabay sa mga tungkulin at pahintulot sa API.

Visibility ng proyekto

Sa mga karaniwang tungkuling ito, ang mga user na hindi may-ari ng organisasyon ay makakakita lang ng mga proyektong kinabibilangan nila. Makikita ng mga may-ari ng organisasyon ang lahat ng proyekto, miyembro, at API key sa antas ng proyekto, at maa-access nila ang pahina ng Mga Proyekto.

Makikita ng mga miyembro ng proyekto ang iba pang miyembro ng kanilang proyekto at ang tungkulin ng bawat isa. Ang mga miyembro lang ng proyekto at mga may-ari ng organisasyon ang makakakita sa mga na-fine-tune na modelo, assistant thread, at file na ginawa o idinagdag sa loob ng proyektong iyon.

Maaari kang maging miyembro ng kahit ilang proyekto ayon sa pangangailangan mo. Ang personal na API key na ginawa sa loob ng isang proyekto ay limitado sa proyektong iyon at sa mga resource nito.

Mga hangganan ng resource

Ang mga file, assistant, storage, at thread ay limitado sa kani-kanilang proyekto. Hindi maa-access ng mga miyembrong hindi admin at hindi kabilang sa proyektong iyon ang mga resource nito, at hindi maililipat ang mga resource sa ibang proyekto.

Hindi ito nalalapat sa mga na-fine-tune na modelo sa Default na proyekto: maa-access ang mga ito mula sa ibang proyekto.

Pamahalaan ang mga miyembro ng proyekto

Mag-imbita ng isang tao sa iyong organisasyon

Kapag nag-imbita ka ng isang tao sa organisasyon, maaari mong isama ang access sa Default na proyekto sa pamamagitan ng pagpili sa opsyong iyon sa form ng imbitasyon. Huwag itong piliin kung ayaw mong magbigay ng access sa Default na proyekto. Hindi awtomatikong idinaragdag sa Default na proyekto ang mga bagong miyembro ng organisasyon.

Hindi mo kailangang gumawa ng isa pang proyekto bago mag-imbita ng isang tao. Maaari ka ring magdagdag ng isang tao sa proyekto pagkatapos niyang tanggapin ang imbitasyon sa organisasyon.

Ang mga imbitasyong ipinadala sa pamamagitan ng Admin API ay sumusunod sa mga panuntunan para sa /organization/invites endpoint.

Magdagdag ng miyembro ng organisasyon sa isang proyekto

Maaaring magdagdag ng mga miyembro ang mga may-ari ng organisasyon at proyekto:

1. Pumunta sa mga setting ng organisasyon.

2. Piliin ang proyekto, pagkatapos ay buksan ang Mga Miyembro.

3. Piliin ang + Magdagdag ng miyembro.

4. Piliin ang user at italaga ang tungkuling Miyembro o May-ari.

Ipinapakita sa listahan ng mga user ang mga user ng organisasyon na may tungkuling Tagabasa. Hindi kasama rito ang mga service account.

Kung mabigo ang imbitasyon sa UI o Admin API, tiyaking umiiral ang target na proyekto at hindi ito naka-archive bago muling ipadala ang imbitasyon.

Magbago ng tungkulin o mag-alis ng miyembro

Maaaring baguhin ng mga may-ari ng organisasyon at proyekto ang tungkulin ng isang user sa proyekto o alisin ang user sa proyektong iyon.

1. Pumunta sa mga setting ng organisasyon.

2. Piliin ang proyekto, pagkatapos ay buksan ang Mga Miyembro.

3. Itakda ang tungkulin ng user sa Miyembro o May-ari, o piliin ang Alisin para alisin siya.

Gumawa at mamahala ng mga service account

Nagbibigay ang service account ng access para sa isang system sa halip na kumatawan sa isang indibidwal na user. Limitado ang mga service account sa kani-kanilang proyekto.

Kailangan ng mga pahintulot sa pamamahala ng service account para makagawa ng mga service account. May ganitong mga pahintulot ang mga may-ari ng organisasyon at proyekto.

Gumawa ng service account

1. Piliin ang proyekto sa tagapili ng proyekto.

2. Pumunta sa mga setting ng organisasyon at piliin ang proyekto.

3. Buksan ang Mga Miyembro at piliin ang + Service account.

4. Maglagay ng natatanging service account ID gamit ang mga titik, numero, at gitling.

5. Piliin ang Gumawa.

Pareho ang format ng ID, gawin mo man ang service account mula sa mga setting sa antas ng organisasyon o proyekto.

Ang service account na ginawa para sa isang proyekto ay para lang sa proyektong iyon at hindi magagamit sa labas nito.

I-save ang secret key

Kapag ginawa ang service account, agad na gumagawa ng API key at ipinapakita ang secret key nito. I-save ang secret key sa isang ligtas na lugar. Hindi mo na ito muling makikita sa pamamagitan ng iyong OpenAI account. Kung mawala ito, bumuo ng bagong key.

Bilang default, maaaring magbasa at magsulat ang service account key sa lahat ng API resource sa proyekto nito. Maaari mong baguhin ang mga pahintulot na iyon pagkatapos sa mga setting ng Mga API Key ng proyekto.

Lumilitaw ang mga service account kasama ng mga user sa mga setting ng Mga Miyembro ng proyekto. Pamahalaan ang access nila sa proyekto gamit ang parehong mga hakbang sa pagbabago ng tungkulin at pag-aalis na ginagamit para sa iba pang miyembro ng proyekto.

Lumilitaw rin ang lahat ng service account kasama ng mga user sa pahina ng Mga Miyembro ng organisasyon, kasama ang mga account na ginawa mula sa mga setting sa antas ng organisasyon at proyekto.

Mula sa menu ng Mga Miyembro ng organisasyon, maaari mong baguhin ang tungkulin ng service account o piliin ang Alisin.

Gumawa at mamahala ng mga API key

May sariling mga API key ang bawat proyekto:

1. Pumunta sa mga setting ng organisasyon.

2. Piliin ang proyekto, pagkatapos ay buksan ang Mga API Key.

3. Piliin ang + Gumawa ng bagong secret key para gumawa ng key, o piliin ang icon ng pag-edit sa tabi ng kasalukuyang key para baguhin ang mga pahintulot nito.

Piliin ang mga pahintulot ng key

Para sa mga key na pag-aari ng user, maaari kang magtakda ng mga pahintulot habang ginagawa ang key o i-edit ang mga ito sa ibang pagkakataon:

• Lahat: Buong mga pahintulot. Ito ang default.

• Limitado: Pumili ng mga saklaw para sa mga partikular na resource o endpoint. Nakadepende sa resource ang mga available na opsyon at maaaring kasama rito ang Wala, Pagbasa, Pagsulat, o mga pahintulot na partikular sa request.

• Pagbasa Lang: Mga pahintulot sa pagbasa para sa lahat ng endpoint.

Halimbawa, maaaring hindi isama ng isang limitadong key ang access sa pagbasa at pagsulat sa /v1/assistants endpoint.

Kailangan ng mga pahintulot sa pamamahala ng service account para makagawa ng mga service account key. Kung hindi mo nakikita ang opsyong iyon, hilingin sa isang may-ari ng organisasyon o proyekto na gumawa ng service account key. Hindi ipinapakita ng dialog sa paggawa ng key ang mga kontrol sa pahintulot na ito para sa mga service account key; baguhin ang mga pahintulot ng mga ito pagkatapos sa mga setting ng Mga API Key ng proyekto.

I-configure ang access sa modelo at mga rate limit

Kailangan ng mga pahintulot na pang-administratibo para pamahalaan ang mga rate limit ng proyekto. May ganitong mga pahintulot ang mga may-ari ng organisasyon, at maaari ring pamahalaan ng mga may-ari ng proyekto ang mga rate limit ng proyekto sa pamamagitan ng management API.

1. Pumunta sa mga setting ng organisasyon.

2. Piliin ang proyekto, pagkatapos ay buksan ang Mga Limitasyon.

3. Gamitin ang Paggamit ng modelo para piliin kung aling mga modelo ang magagamit ng proyekto.

4. Magtakda ng rate limit para sa bawat modelo kung kinakailangan.

Magtakda ng mga limitasyon sa gastos at alerto

Available ang mga buwanang limitasyon sa gastos sa API sa antas ng organisasyon at proyekto. Kailangan mo ng pahintulot na pamahalaan ang mga setting ng kaukulang organisasyon o proyekto bago baguhin ang isang limitasyon.

Maaaring gamitin ang limitasyon sa gastos para subaybayan ang paggastos nang hindi pinapatigil ang mga request. I-on ang Magpatupad ng mahigpit na limitasyon kung gusto mong mabigo ang mga API request kapag umabot na sa limitasyon ang nasubaybayang gastos. Hindi agad naipapatupad ang limitasyon, kaya maaaring bahagyang lumampas ang naitalang gastos sa itinakdang halaga.

Inaabisuhan ka ng mga alerto sa gastos kapag naabot ang isang threshold; hindi nito pinapatigil ang mga request.

Magtakda ng limitasyon sa gastos ng organisasyon

1. Pumunta sa mga setting ng organisasyon.

2. Buksan ang Mga Limitasyon at hanapin ang Gastos.

Magtakda ng limitasyon sa gastos ng proyekto

1. Pumunta sa mga setting ng organisasyon.

2. Piliin ang proyekto, pagkatapos ay buksan ang Mga Limitasyon.

3. Itakda ang mga halaga para sa Limitasyon sa buwanang gastos at Mag-alerto kapag umabot ang gastos sa.

4. I-on ang Magpatupad ng mahigpit na limitasyon kung gusto mong patigilin ang trapiko sa API kapag naabot na ang limitasyon ng nasubaybayang gastos.

Maaari mo ring baguhin ang Paggamit ng modelo sa pahinang ito.

Pamahalaan ang mga alerto sa gastos

Kapag gumawa ka ng limitasyon sa gastos ng proyekto, bilang default ay gumagawa rin ito ng alerto sa 100% ng limitasyon. Piliin ang Magdagdag ng Alerto para magdagdag ng mga alerto sa iba pang threshold.

Nakatatanggap ang mga may-ari ng organisasyon at proyekto ng mga alerto sa gastos ng proyekto. Maaari kang magdagdag ng iba pang tatanggap ng email sa mga setting ng alerto.

Para sa mga kasalukuyang hakbang sa pag-configure at kung paano ipinapatupad ang mga limitasyon, tingnan ang gabay sa mga limitasyon sa gastos.

Tingnan ang paggamit at pagsingil

Maaaring hatiin ayon sa proyekto ang aktibidad sa paggamit, at maaari mong tingnan ang pagsingil at magtakda ng mga limitasyon sa gastos para sa bawat proyekto.

Nakadepende ang access sa Dashboard ng Paggamit ng isang proyekto sa iyong tungkulin sa organisasyon at sa mga setting ng visibility ng Dashboard ng Paggamit. Hindi sapat ang pagiging may-ari ng proyekto para magkaroon ng access.

Kung hindi mo makita ang Dashboard ng Paggamit ng isang proyekto, tingnan kung nakatakda ang visibility sa Makikita ng mga may-ari ng organisasyon.

Pamahalaan ang storage ng file

May quota na 100 GB para sa storage ng file ang bawat proyekto. Kung lumampas ka rito, maaaring lumabas ang error na ito:

Lumampas ka na sa iyong quota sa storage ng file. Limitado sa 100 GB ng mga file ang mga organisasyon. Pakiliitan ang file o makipag-ugnayan sa suporta.

I-delete ang mga hindi ginagamit na file para magbakante ng storage. Maaari mong ilista ang mga nakaimbak na file sa pamamagitan ng API para matukoy ang mga file na hindi mo na kailangan.

Mag-archive ng proyekto

Maaaring mag-archive ng mga proyekto ang mga may-ari ng organisasyon at proyekto mula sa pahina ng Mga Proyekto o sa mga setting ng mismong proyekto. Ilagay ang pangalan ng proyekto kapag hiniling ito para kumpirmahin.

Permanente ang pag-archive: hindi na maibabalik ang isang naka-archive na proyekto.

Para makita ang mga naka-archive na proyekto, buksan ang tab na Naka-archive sa pahina ng Mga Proyekto.

Hindi maaaring i-delete ang mga proyekto. Pinapanatili ng OpenAI ang kasaysayan ng mga ito para masubaybayan ang paggamit at pagsingil.