OpenAI
Ukurasa huu ulitafsiriwa na mashine. Tazama makala asili ya Kiingereza.

Kusimamia miradi katika jukwaa la API

Ilisasishwa: 5 days ago

Miradi inalenga kuwapa wateja uwezo wa kupanga kazi yao. Mashirika yanaweza kudhibiti ufikiaji na vikomo, kutoa akaunti za huduma (kupitia kiolesura cha mtumiaji), na kufuatilia matumizi ndani ya upeo uliowekewa mipaka katika mradi (k.m. miundo, uwezo, nyuzi, wasaidizi, urekebishaji wa kina, hifadhi, n.k.). Shughuli za matumizi zinaweza kugawanywa kulingana na mradi, na watumiaji wanaweza kuona malipo na kuweka vikomo vya matumizi kwa kila mradi.

Wamiliki wa shirika wanaweza kuona miradi yao yote Iliyo Hai na Iliyowekwa kwenye Kumbukumbu kwenye ukurasa wa Miradi. Pata maelezo zaidi kuhusu majukumu na ruhusa za watumiaji katika Jukwaa la API.

Image

Ni nani anaweza kuunda mradi?

Ni wamiliki wa shirika pekee wanaoweza kuunda mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi.

Ili kubadilisha kati ya mashirika, elekeza kipanya juu ya jina la shirika lako upande wa juu kushoto wa ukurasa na uchague shirika kutoka kwenye orodha:

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

Kwa mashirika yaliyo kwenye mpango wa utozaji uliounganishwa, mashirika madogo hutambuliwa tofauti. Miradi haiwezi kuundwa ndani ya mashirika madogo.

Image

Miradi hufanya kazi vipi?

Kila shirika linajumuisha “Mradi chaguomsingi” ambao hauwezi kufutwa. Unaweza kusanidi vikomo vya viwango, ruhusa za muundo pepe, na vikomo vya matumizi (kuanzia Novemba 2024). Unarithi usanidi kamili wa shirika, kwa hivyo huwezi kuongeza wanachama au akaunti za huduma moja kwa moja kwake.

Ninawezaje kuunda mradi?

Kwanza, elekeza kipanya juu ya jina la mradi kwenye kona ya kushoto ya ukurasa na uchague Create project.

API platform project menu with Create project highlighted under Default project

Toa jina, maelezo, na tovuti ya mradi wako kisha uchague Create.

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

Ninawezaje kuongeza watumiaji kwenye mradi?

Wanachama wapya walioongezwa kwenye shirika hawaongezwi kiotomatiki kwenye “Mradi chaguomsingi”. Wanachama wapya wanaweza kualikwa kwenye mradi wanapoalikwa kwenye shirika (kwa kuwasha kisanduku tiki cha “Alika kwenye mradi chaguomsingi”) au baada ya mwanachama kukubali mwaliko wa shirika.

Watumiaji walioalikwa kupitia Admin API hufuata kanuni zilizoainishwa na mwisho wa /organization/invites.

Ukikumbana na hitilafu unapowaalika watumiaji kwenye mradi kupitia UI au Admin API, thibitisha kwanza kuwa mradi lengwa upo na haujahifadhiwa kwenye kumbukumbu kabla ya kutuma mwaliko tena.

Wamiliki wa shirika huongezwa kiotomatiki kama wamiliki kwenye miradi mipya iliyoundwa ndani ya shirika.

Ni majukumu gani tofauti ya watumiaji ndani ya mashirika na miradi, na yanajumuisha ruhusa gani?

Ingawa Mashirika yana majukumu ya ‘mmiliki’ na ‘msomaji’, miradi ina majukumu ya ‘mmiliki’ na ‘mwanachama’. Wanachama wa mradi ni sawa na wasomaji wa shirika. Tafadhali rejelea jedwali lililo hapa chini kwa maelezo ya kina zaidi kuhusu ruhusa zinazoambatana na kila jukumu la mtumiaji.

JukumuUpeoMaelezo
MmilikiShirikaAnaweza kuunda/kuona miradi yote, watumiaji wote, na funguo zote za API. Ana uwezo wa kufuatilia miradi yote ndani ya shirika kupitia ukurasa wa Miradi. Anaweza kuweka vikomo vya matumizi ya shirika na vikomo vya matumizi ya mradi. Anaweza kutoa ruhusa za kuona taarifa za matumizi za wengine katika shirika. Anaweza kuweka miradi kwenye kumbukumbu.
MsomajiShirikaAnaweza kufanya makisio, kutumia rasilimali, na kuunda funguo katika miradi yake. Anaweza kuongezwa kwenye miradi.
Hawezi kuunda miradi wala kudhibiti watumiaji.
MmilikiMradiAnaweza kuongeza watumiaji wengine kwenye mradi na kubadilisha jina la mradi, pamoja na uwezo wote wa Mwanachama. Anaweza kuweka vikomo vya matumizi ya mradi. Anaweza kuweka mradi kwenye kumbukumbu.
MwanachamaMradiAnaweza kufanya makisio, kutumia rasilimali, na kuunda funguo katika kiwango cha mradi.

Ikiwa mimi si Mmiliki katika shirika, nina ufikiaji wa nini?

Watumiaji ambao si Wamiliki katika shirika wanaweza kuona tu miradi ambayo wao ni wanachama wake. Ni mmiliki wa shirika pekee anayeweza kuona miradi yote, wanachama, na funguo za API katika kiwango cha mradi, na kufikia ukurasa wa Miradi.

  • Ni wanachama wa mradi pekee (na wamiliki wa shirika) wanaoweza kuona miundo iliyoboreshwa kwa urekebishaji finyu iliyoundwa ndani ya mradi huo, nyuzi kutoka kwa Assistants wowote walioundwa, au faili zozote zilizoongezwa.

  • Wanachama wa mradi wanaweza kuona wanachama wengine wote wa mradi huo ni akina nani na majukumu yao (yaani Mmiliki au Mwanachama).

Ninawezaje kusasisha jukumu la mtumiaji kwenye mradi au kumwondoa mtumiaji kwenye mradi?

Ni Mmiliki wa mradi pekee anayeweza kusasisha jukumu la mtumiaji kwenye mradi au kumwondoa mtumiaji kwenye mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi.

Ili kusasisha mtumiaji katika mradi, nenda kwenye mipangilio ya shirika lako, chagua mradi, kisha ubofye Wanachama. Una chaguo la kuweka jukumu la kila mwanachama kuwa Mwanachama au Mmiliki. Unaweza pia kuchagua Ondoa ili kumwondoa mtumiaji kwenye mradi.

Akaunti ya huduma ni nini, na inatofautianaje na akaunti ya kawaida ya mtumiaji?

Akaunti ya huduma hufanya kazi kama mtumiaji-bandia aliyebuniwa kwa ajili ya ufikiaji wa mfumo, tofauti na akaunti za watumiaji binafsi. Ni wamiliki wa shirika na wa mradi pekee wanaoweza kuunda akaunti za huduma.

Akaunti za huduma zimewekewa wigo wa miradi pekee.

Ongeza mwanachama kwenye mradi

Ukibofya kitufe cha + Add member, utaona orodha ya watumiaji katika shirika lako walio na jukumu la Reader. Ikiwa ungependa kuongeza mtumiaji ambaye kwa sasa hayumo katika shirika lako, utahitaji kumwongeza kwenye shirika kwanza (unaweza kuacha kisanduku cha kuteua cha “Ongeza kwenye Mradi Chaguomsingi” bila kuteuliwa ikiwa hutaki kuwapa watumiaji hawa ufikiaji mpana zaidi). Orodha hii haitajumuisha akaunti za huduma. Katika hatua hii, unaweza kuchagua ikiwa jukumu lao litakuwa Owner au Member:

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

Unapoongeza mwanachama wa timu, lazima umpe jukumu la Mwanachama au Mmiliki. Wanachama wa mradi wanaweza kutuma maombi ya API yanayosoma au kurekebisha data, ilhali wamiliki wa mradi wanaweza pia kurekebisha mipangilio ya mradi na vikomo vya matumizi ya mradi, na kudhibiti wanachama wa mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi.

Jinsi ya kuunda akaunti ya huduma kwa mradi

Kwanza nenda kwenye mradi unaotaka kuundia akaunti ya huduma kwa kuchagua kutoka kwenye menyu kunjuzi iliyoko kwenye upau wa urambazaji:

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

Kisha, nenda kwenye mipangilio ya shirika lako -> Mradi -> Wanachama -> bofya + Service account:

Akaunti za huduma zilizoundwa katika kiwango cha mradi ni za kipekee kwa mradi huo na haziwezi kutumika nje ya mradi zilimoundwa ndani yake.

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

Kutaja akaunti ya huduma

Bila kujali kama unaunda akaunti ya huduma katika kiwango cha shirika au unaunda ya kipekee kwa mradi, unapounda akaunti ya huduma unaweza kuunda kitambulisho cha kipekee cha akaunti ya huduma kinachojumuisha herufi, nambari na vistari kuifanya itambulike kwa urahisi.

Hifadhi ufunguo wa API wa akaunti ya huduma

Baada ya kuchagua kitufe cha Unda, ufunguo wa API huundwa mara moja kwa akaunti ya huduma na ufunguo wa siri utaonyeshwa. Hifadhi ufunguo huu wa siri mahali salama na penye ulinzi. Kwa sababu za usalama, hutaweza kuuona tena kupitia akaunti yako ya OpenAI. Ukipoteza ufunguo huu wa siri, utahitaji kutengeneza mpya.

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

Ruhusa za ufunguo wa API wa akaunti ya huduma huwekwa kwa chaguomsingi kusoma na kuandika rasilimali zote za API za mradi. Ruhusa hizi zinaweza kusasishwa katika mipangilio ya Funguo za API ya mradi wako.

Akaunti za huduma huorodheshwa pamoja na wanachama wa mradi kwenye ukurasa wa mipangilio ya wanachama wa mradi wako. Tafadhali rejelea hapa ili ujifunze zaidi kuhusu kusasisha au kuondoa ufikiaji wa akaunti ya huduma kwenye ukurasa wa mipangilio ya wanachama wa mradi wako.

Akaunti zote za huduma katika miradi na mashirika zitaonyeshwa pamoja na watumiaji wako binadamu kwenye ukurasa wa wanachama wa kiwango cha shirika.

Akaunti za huduma hudhibitiwa kama akaunti za kawaida. Kutoka Shirika -> menyu ya Wanachama unaweza Kuondoa akaunti ya huduma au kusasisha jukumu:

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

Ninawezaje kudhibiti funguo za API ndani ya miradi ya shirika langu?

Unaweza kuunda na kudhibiti funguo za API kwa kila mradi kwenye ukurasa wa mipangilio wa mradi huo. Katika mipangilio ya shirika lako, chagua mradi, kisha ubofye Funguo za API.

Ili kuunda ufunguo mpya wa siri, chagua + Create new secret key. Unaweza pia kuchagua aikoni ya Hariri iliyo kando ya ufunguo wa siri ili kuhariri ruhusa zake.

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

Unaweza kuweka ruhusa kwa kila moja ya funguo zako za API unapounda ufunguo mpya wa siri au kwa kuhariri ufunguo uliopo.

Viwango vitatu vya ruhusa vinapatikana: Zote, Zilizozuiwa, na Kusoma Pekee.

  • Zote — Ruhusa kamili zimewekwa kwa ufunguo wa siri. Huu ndio mpangilio chaguomsingi.

  • Zilizozuiwa — Humwezesha mtumiaji kuweka ruhusa za Hakuna, Kusoma, na Kuandika kwa kila mwisho.

    • Kwa mfano, unaweka ufunguo wa API ambao hasa hauna ruhusa ya Kusoma au Kuandika kwenye mwisho wa /v1/assistants:

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Kusoma Pekee — Ruhusa za kusoma zimewekwa kwa miisho yote.

Ufikiaji unasimamiwaje kwa watumiaji walio katika miradi au mashirika mengi?

Watumiaji wanaweza kuwa wanachama wa miradi mingi kadiri inavyohitajika. Ndani ya mradi, watumiaji wanaweza kutengeneza ufunguo binafsi wa API ambao umewekewa wigo na kikomo wa kufikia mradi huo na rasilimali zake.

Ninawezaje kuweka na kudhibiti vikomo vya maombi kwa miradi ya shirika langu?

Ni Mmiliki wa shirika pekee anayeweza kuweka na kudhibiti vikomo vya maombi katika kiwango cha mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi.

Katika mipangilio ya shirika lako, bofya mradi unaotaka kusasisha na uchague Vikomo katika sehemu ya Mradi kwenye orodha ya urambazaji. Unaweza kusasisha Matumizi ya Muundo yako kwenye ukurasa huu.

Matumizi ya muundo hukuwezesha kusanidi miundo inayoweza kutumiwa na mradi, na vikomo vya maombi vinaweza kuwekwa kwa kila muundo inapohitajika.

Ninawezaje kuweka na kudhibiti vikomo vya matumizi kwa miradi ya shirika langu?

Ni Wamiliki wa shirika na Wamiliki wa mradi pekee wanaoweza kuweka na kudhibiti vikomo vya matumizi ya mradi. Tafadhali rejelea majukumu na ruhusa kwa maelezo zaidi. Ili kubadilisha vikomo katika kiwango cha shirika, kwenye mipangilio ya shirika, bofya Vikomo, kisha uteremke hadi Vikomo vya matumizi.

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

Ili kuweka vikomo vya mradi wako, kwenye mipangilio ya shirika, bofya mradi unaotaka kusasisha na uchague Vikomo. Unaweza kusasisha Kikomo cha matumizi ya kila mwezi, Kizingiti cha arifa, na Matumizi ya Muundo.

Kuweka kikomo cha matumizi ya kila mwezi hukuruhusu kuanzisha vizingiti laini vya matumizi kwa mradi wako. Matumizi yanapozidi kikomo hiki ndani ya mwezi fulani wa kalenda (UTC), maombi ya API yataendelea kuchakatwa bila kukatizwa. Kipengele hiki kimeundwa kukusaidia kufuatilia matumizi kupitia arifa za vikomo vya matumizi, lakini hakitekelezi kikomo kigumu cha matumizi. Kikomo cha matumizi ya mradi kinapoundwa, kwa chaguomsingi, arifa itaundwa kwenye kizingiti cha 100%. Arifa za ziada kwenye vizingiti tofauti zinaweza kuwekwa kwa kubofya Ongeza Arifa.

Tafadhali kumbuka kuwa mmiliki/wamiliki wa shirika na mmiliki/wamiliki wa mradi watapokea ujumbe huu kila wakati, na hili haliwezi kubinafsishwa.

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

Ninawezaje kuweka vikomo vya matumizi kwa shirika au mradi wangu?

OpenAI sasa inatumia vikomo vya matumizi ya API vya kila mwezi katika viwango vya shirika na mradi. Kikomo cha matumizi kinaweza kufuatilia matumizi bila utekelezaji, au unaweza kukitekeleza kama kikomo kigumu ili maombi ya API yashindwe baada ya matumizi kufikia kikomo. Kwa hatua na tabia za hivi karibuni za usanidi, angalia Vikomo vya matumizi katika hati za wasanidi programu.

Ninawezaje kufuta au kuhifadhi mradi kwenye kumbukumbu?

Miradi inaweza kuhifadhiwa kwenye kumbukumbu kupitia ukurasa mpya wa orodha ya miradi au kwenye mipangilio ya mradi binafsi. Mradi ukishahifadhiwa kwenye kumbukumbu hauwezi kurejeshwa. Unapoendelea na uhifadhi kwenye kumbukumbu, utaombwa uweke jina la mradi ili kuendelea.

Unaweza kuona orodha ya miradi yote iliyohifadhiwa kwenye kumbukumbu kupitia kichupo cha “Iliyohifadhiwa” kwenye ukurasa huo huo wa orodha ya miradi.

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

Kufuta miradi hakuwezekani; tunahifadhi historia ya miradi yote ili kuhakikisha mwendelezo katika ufuatiliaji wa matumizi na utozaji.

Je, kuna kikomo cha idadi ya miradi ninayoweza kuwa nayo katika shirika langu?

Mashirika yanaweza kuunda hadi miradi 2,000 kwa chaguomsingi.

Je, rasilimali zinaweza kushirikiwa kati ya miradi?

Rasilimali za mradi (kama vile faili, wasaidizi, hifadhi au nyuzi) zimewekewa wigo wa mradi na haziwezi kufikiwa na wanachama wasio wasimamizi nje ya mradi. Zaidi ya hayo, rasilimali haziwezi kuhamishwa kati ya miradi.

Isipokuwa moja ni kwamba fine tunes katika “Mradi chaguomsingi” zinaweza kufikiwa kutoka miradi mingine.

Kiwango cha hifadhi ya faili kwa kila mradi ni kipi?

OpenAI kwa sasa inasaidia kiwango cha hifadhi ya faili cha GB 100 za faili kwa kila mradi.

Iwapo kiwango hiki kitazidishwa, utaona hitilafu ifuatayo:

Umezidi kiwango chako cha hifadhi ya faili. Mashirika yanawekewa kikomo cha GB 100 za faili. Tafadhali punguza ukubwa wa faili au wasiliana na usaidizi.

Tunapendekeza ufute faili zisizotumika zilizohifadhiwa kwenye akaunti yako. Kwa marejeleo, unaweza kutazama na kuorodhesha faili kwa kutumia API.

Mimi ni mmiliki wa mradi, kwa nini sioni Dashibodi ya Matumizi ya mradi wangu?

Mwonekano wa Dashibodi ya Matumizi ya mradi hauhusiani na jukumu la mtumiaji ndani ya mradi. Badala yake, huamuliwa na jukumu lako ndani ya shirika na mipangilio katika https://platform.openai.com/settings/organization/data-controls/visibility

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

Ikiwa huwezi kuona Dashibodi ya Matumizi, huenda mpangilio huu umewekwa kuwa “Inaonekana kwa wamiliki wa shirika”.

Je, makala haya yamekusaidia?