OpenAI
Din il-paġna ġiet tradotta awtomatikament bl-IA. Ara l-artiklu oriġinali bl-Ingliż.

Immaniġġjar tal-proġetti fil-pjattaforma API

Tgħallem kif toħloq u timmaniġġja proġetti tal-API ta’ OpenAI, inklużi membri, rwoli, kontijiet tas-servizz, ċwievet tal-API, limiti tal-użu u baġits.

Aġġornat: 17 days ago

Il-proġetti għandhom l-għan li jagħtu lill-klijenti l-kapaċità jorganizzaw ix-xogħol tagħhom. L-organizzazzjonijiet jistgħu jimmaniġġjaw l-aċċess u l-limiti, jipprovdu kontijiet tas-servizz (permezz tal-UI), u jsegwu l-użu f’ambitu limitat fi ħdan proġett (eż. mudelli, kapaċitajiet, threads, assistants, fine tuning, ħażna, eċċ.). L-attività tal-użu tista’ tinqasam skont il-proġett, u l-utenti jistgħu jaraw il-kontijiet u jistabbilixxu limiti tal-infiq għal kull proġett.

Is-sidien tal-organizzazzjoni jistgħu jaraw il-proġetti Attivi u Arkivjati kollha tagħhom fil-paġna Projects. Tgħallem aktar dwar ir-rwoli tal-utenti u l-permessi fil-Pjattaforma tal-API.

Image

Min jista’ joħloq proġett?

Is-sidien tal-organizzazzjoni biss jistgħu joħolqu proġett. Għal aktar informazzjoni, ara ir-rwoli u l-permessi.

Biex taqleb minn organizzazzjoni għal oħra, poġġi l-pointer fuq isem l-organizzazzjoni tiegħek fin-naħa ta’ fuq tax-xellug tal-paġna u agħżel l-organizzazzjoni mil-lista:

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

Għall-organizzazzjonijiet bi pjan ta’ fatturazzjoni kkonsolidata, is-sottorganizzazzjonijiet jiġu identifikati separatament. Ma jistgħux jinħolqu proġetti fi ħdan sottorganizzazzjonijiet.

Image

Kif jaħdmu l-proġetti?

Kull organizzazzjoni tinkludi “Proġett predefinit” li ma jistax jitħassar. Tista’ tikkonfigura l-limiti tar-rata, il-permessi virtwali tal-mudelli u l-limiti tal-infiq (minn Novembru 2024). Jiret il-konfigurazzjoni sħiħa tal-organizzazzjoni, għalhekk ma tistax iżżidlu direttament membri jew kontijiet tas-servizz.

Kif noħloq proġett?

L-ewwel, poġġi l-pointer fuq isem il-proġett fir-rokna tax-xellug tal-paġna u agħżel Oħloq proġett.

API platform project menu with Create project highlighted under Default project

Daħħal isem, deskrizzjoni u sit web għall-proġett tiegħek, imbagħad agħżel Oħloq.

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

Kif inżid utenti ma’ proġett?

Membri ġodda miżjuda mal-organizzazzjoni ma jiżdidux awtomatikament mal-“Proġett predefinit”. Membri ġodda jistgħu jiġu mistiedna għall-proġett meta jiġu mistiedna għall-organizzazzjoni (billi timmarka l-kaxxa "Stieden għall-proġett predefinit") jew wara li l-membru jaċċetta l-istedina tal-organizzazzjoni.

L-utenti mistiedna permezz tal-API tal-Amministratur isegwu r-regoli deskritti mill-punt ta' tmiem /organization/invites.

Jekk tiltaqa’ ma’ żball meta tistieden utenti għal proġett permezz tal-interfaċċa jew tal-API tal-Amministratur, l-ewwel ikkonferma li l-proġett fil-mira jeżisti u mhuwiex arkivjat, imbagħad erġa’ ibgħat l-istedina.

Is-sidien tal-organizzazzjoni jiżdiedu awtomatikament bħala sidien ta’ proġetti ġodda maħluqa fl-organizzazzjoni.

X’inhuma r-rwoli differenti tal-utenti fl-organizzazzjonijiet u l-proġetti, u xi permessi jinkludu?

Filwaqt li l-organizzazzjonijiet għandhom ir-rwoli ta’ ‘sid’ u ‘qarrej’, il-proġetti għandhom ir-rwoli ta’ ‘sid’ u ‘membru’. Il-membri tal-proġett huma simili għall-qarrejja tal-organizzazzjoni. Ara t-tabella hawn taħt għal deskrizzjoni aktar dettaljata tal-permessi marbuta ma’ kull rwol ta’ utent.

RwolAmbituDeskrizzjoni
SidOrganizzazzjoniJista’ joħloq u jara l-proġetti, l-utenti u ċ-ċwievet tal-API kollha. Jista’ jimmonitorja l-proġetti kollha fl-organizzazzjoni permezz tal-

paġna tal-Proġetti
. Jista’ jistabbilixxi limiti tal-infiq għall-organizzazzjoni u għall-proġetti. Jista’ jagħti lil oħrajn fl-organizzazzjoni permess biex jaraw l-informazzjoni dwar l-użu. Jista’ jarkivja proġetti.
QarrejOrganizzazzjoniJista’ jwettaq inferenza, juża r-riżorsi u joħloq ċwievet fil-proġetti tiegħu. Jista’ jiżdied ma’ proġetti.
Ma jistax joħloq proġetti jew jimmaniġġja utenti.
SidProġettJista’ jżid utenti oħra mal-proġett u jibdel ismu, kif ukoll iwettaq dak kollu li jista’ Membru. Jista’ jistabbilixxi l-limiti tal-infiq tal-proġett. Jista’ jarkivja l-proġett.
MembruProġettJista’ jwettaq inferenza, juża r-riżorsi u joħloq ċwievet fil-livell tal-proġett.

Jekk m’iniex Sid fl-organizzazzjoni, għal xiex għandi aċċess?

Utenti li mhumiex Sidien fl-organizzazzjoni jistgħu jaraw biss il-proġetti li huma membri tagħhom. Is-sid tal-organizzazzjoni biss jista’ jara l-proġetti, il-membri u ċ-ċwievet tal-API kollha fil-livell tal-proġett, u għandu aċċess għall-paġna tal-Proġetti.

  • Il-membri ta’ proġett (u s-sidien tal-organizzazzjoni) biss jistgħu jaraw il-mudelli rfinuti maħluqa fih, it-threads minn kwalunkwe Assistenti maħluqa, jew il-fajls miżjuda.

  • Il-membri ta’ proġett jistgħu jaraw min huma l-membri l-oħra kollha tiegħu u r-rwoli tagħhom (jiġifieri Sid jew Membru).

Kif naġġorna r-rwol ta’ utent fi proġett jew inneħħi utent minn proġett?

Is-Sid ta’ proġett biss jista’ jaġġorna r-rwol ta’ utent fil-proġett jew ineħħi utent minnu. Għal aktar informazzjoni, ara ir-rwoli u l-permessi.

Biex taġġorna utent fi proġett, mur fis-settings tal-organizzazzjoni tiegħek, agħżel il-proġett u kklikkja Membri. Tista’ tissettja r-rwol ta’ kull membru bħala Membru jew Sid. Tista’ wkoll tagħżel Neħħi biex tneħħi lill-utent mill-proġett.

X’inhu kont tas-servizz, u kif huwa differenti minn kont ta’ utent normali?

Kont tas-servizz jaġixxi bħala psewdo-utent maħsub għall-aċċess tas-sistema u huwa distint mill-kontijiet ta’ utenti individwali. Is-sidien tal-organizzazzjoni u tal-proġett biss jistgħu joħolqu kontijiet tas-servizz.

Service accounts huma limitati għall-proġetti biss.

Żid membru ma’ proġett

Jekk tikklikkja l-buttuna + Żid membru, tara lista tal-utenti fl-organizzazzjoni tiegħek bir-rwol ta’ Qarrej. Jekk trid iżżid utent li bħalissa mhuwiex fl-organizzazzjoni tiegħek, l-ewwel trid iżżidu mal-organizzazzjoni (tista’ tħalli l-kaxxa 'Żid mal-Proġett Predefinit" mhux immarkata jekk ma tridx tagħti lil dawn l-utenti aċċess usa’). Din il-lista ma tinkludix kontijiet tas-servizz. F’dan il-pass tista’ tagħżel jekk ir-rwol tagħhom ikunx Sid jew Membru:

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

Meta żżid membru tat-tim, trid tassenjalu r-rwol ta’ Membru jew Sid. Il-membri tal-proġett jistgħu jagħmlu talbiet tal-API li jaqraw jew jimmodifikaw id-data, filwaqt li s-sidien tal-proġett jistgħu wkoll jimmodifikaw is-settings u l-limiti tal-infiq tal-proġett u jimmaniġġjaw il-membri tiegħu. Għal aktar informazzjoni, ara ir-rwoli u l-permessi.

Kif toħloq kont tas-servizz għal proġett

L-ewwel, mur fil-proġett li trid toħloqlu kont tas-servizz billi tagħżlu mil-lista li tinfetaħ fil-bar tan-navigazzjoni:

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

Imbagħad, mur fis-settings tal-organizzazzjoni tiegħek -> Proġett -> Membri -> ikklikkja + Kont tas-servizz:

Service accounts maħluqa fil-livell tal-proġett huma uniċi għall-proġett u ma jistgħux jintużaw barra mill-proġett li fih inħolqu.

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

Kif issemmi l-kont tas-servizz

Kemm jekk toħloq il-kont tas-servizz fil-livell tal-organizzazzjoni kif ukoll jekk toħloq wieħed speċifiku għal proġett, tista’ toħloq ID uniku tal-kont tas-servizz magħmul minn ittri, numri u singijiet biex tidentifikah faċilment.

Issejvja ċ-ċavetta tal-API tal-kont tas-servizz

Wara li tagħżel il-buttuna Oħloq, tinħoloq immedjatament ċavetta tal-API għall-kont tas-servizz u tintwera ċ-ċavetta sigrieta. Issejvja din iċ-ċavetta sigrieta f’post sikur u protett. Għal raġunijiet ta’ sigurtà, ma tkunx tista’ terġa’ taraha mill-kont OpenAI tiegħek. Jekk titlef din iċ-ċavetta sigrieta, ikollok tiġġenera waħda ġdida.

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

B’mod predefinit, il-permessi taċ-ċavetta tal-API tal-kont tas-servizz jippermettu l-qari u l-kitba tar-riżorsi kollha tal-API tal-proġett. Dawn il-permessi jistgħu jiġu aġġornati fis-settings taċ-Ċwievet tal-API tal-proġett tiegħek.

Il-kontijiet tas-servizz jidhru flimkien mal-membri tal-proġett fil-paġna tas-settings tal-membri tal-proġett tiegħek. Ara hawnhekk biex titgħallem aktar dwar kif taġġorna jew tneħħi l-aċċess ta’ kont tas-servizz mill-paġna tas-settings tal-membri tal-proġett tiegħek.

Il-kontijiet tas-servizz kollha kemm fil-proġetti kif ukoll fl-organizzazzjonijiet se jintwerew flimkien mal-utenti umani tiegħek fil-paġna tal-membri fil-livell tal-organizzazzjoni.

Il-kontijiet tas-servizz jiġu mmaniġġjati bħall-kontijiet regolari. Mill-Organizzazzjoni -> menu Membri tista’ Tneħħi kont tas-servizz jew taġġorna r-rwol:

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

Kif nimmaniġġja ċ-ċwievet tal-API fil-proġetti tal-organizzazzjoni tiegħi?

Tista’ toħloq u timmaniġġja ċ-ċwievet tal-API ta’ kull proġett mill-paġna tas-settings tiegħu. Fis-settings tal-organizzazzjoni tiegħek, agħżel il-proġett u kklikkja Ċwievet tal-API.

Biex toħloq ċavetta sigrieta ġdida, agħżel + Oħloq ċavetta sigrieta ġdida. Tista’ wkoll tagħżel l-ikona Editja ħdejn ċavetta sigrieta biex teditja l-permessi tagħha.

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

Tista’ tissettja l-permessi għal kull ċavetta tal-API meta toħloq ċavetta sigrieta ġdida jew billi teditja waħda eżistenti.

Hemm tliet livelli ta’ permessi: Kollha, Ristretti u Qari Biss.

  • Kollha — Il-permessi sħaħ jiġu ssettjati għaċ-ċavetta sigrieta. Dan huwa s-setting predefinit.

  • Ristretti — Jippermetti lill-utent jissettja l-permessi Xejn, Qari u Kitba għal kull punt ta' tmiem.

  • Pereżempju, tista’ toħloq ċavetta tal-API li speċifikament ma jkollhiex permess ta’ Qari jew Kitba fil-punt ta' tmiem /v1/assistants:

Create new secret key dialog in the API platform with Restricted permissions selected
  • Qari Biss — Il-permessi tal-qari jiġu ssettjati għall-punti ta' tmiem kollha.

Kif jiġi mmaniġġjat l-aċċess għal utenti li jagħmlu parti minn diversi proġetti jew organizzazzjonijiet?

L-utenti jistgħu jkunu membri ta’ proġetti kemm ikun meħtieġ. Fi ħdan proġett, l-utenti jistgħu jiġġeneraw ċavetta personali tal-API li tkun limitata għall-aċċess għal dak il-proġett u r-riżorsi tiegħu.

Kif nissettja u nimmaniġġja l-limiti tar-rata għall-proġetti tal-organizzazzjoni tiegħi?

Is-Sid ta’ organizzazzjoni biss jista’ jistabbilixxi u jimmaniġġja l-limiti tar-rata fil-livell tal-proġett. Għal aktar informazzjoni, ara ir-rwoli u l-permessi.

Fis-settings tal-organizzazzjoni tiegħek, ikklikkja l-proġett li trid taġġorna u agħżel Limiti fit-taqsima Proġett tal-lista tan-navigazzjoni. Tista’ taġġorna l-Użu tal-Mudelli tiegħek minn din il-paġna.

L-użu tal-mudelli jippermettilek tikkonfigura liema mudelli jista’ juża l-proġett, u jistgħu jiġu ssettjati limiti tar-rata għal kull mudell skont il-ħtieġa.

Kif nissettja u nimmaniġġja l-limiti tal-infiq għall-proġetti tal-organizzazzjoni tiegħi?

Is-Sidien ta’ organizzazzjoni u s-Sidien ta’ proġett biss jistgħu jistabbilixxu u jimmaniġġjaw il-limiti tal-infiq tal-proġett. Għal aktar informazzjoni, ara ir-rwoli u l-permessi. Biex tibdel il-limiti fil-livell tal-organizzazzjoni, fis-settings tal-organizzazzjoni tiegħek, ikklikkja Limiti, u niżżel sal-Limiti tal-użu.

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

Biex tissettja l-limiti tal-proġett, fis-settings tal-organizzazzjoni tiegħek, ikklikkja l-proġett li trid taġġorna u agħżel Limiti. Tista’ taġġorna l-Limitu tal-infiq ta’ kull xahar, il-Livell limitu għan-notifiki, u l-Użu tal-Mudelli.

Meta tissettja limitu tal-infiq ta’ kull xahar, tista’ tistabbilixxi livelli indikattivi tal-infiq għall-proġett tiegħek. Meta l-użu jaqbeż dan il-limitu matul xahar kalendarju partikolari (UTC), it-talbiet tal-API jibqgħu jiġu pproċessati mingħajr interruzzjoni. Din il-karatteristika tgħinek timmonitorja l-użu permezz ta’ twissijiet dwar il-limitu tal-infiq, iżda ma timponix limitu assolut fuq l-infiq. Meta jinħoloq limitu tal-infiq għal proġett, awtomatikament tinħoloq twissija fil-livell ta’ 100%. Tista’ tissettja twissijiet oħra f’livelli differenti billi tikklikkja Żid Twissija.

Innota li s-sid(ien) tal-organizzazzjoni u s-sid(ien) tal-proġett dejjem jirċievu dawn il-messaġġi u dan ma jistax jiġi personalizzat.

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

Kif nissettja l-limiti tal-infiq għall-organizzazzjoni jew għall-proġett tiegħi?

OpenAI issa tappoġġja limiti ta’ kull xahar fuq l-infiq tal-API kemm fil-livell tal-organizzazzjoni kif ukoll f’dak tal-proġett. Limitu tal-infiq jista’ jimmonitorja l-infiq mingħajr ma jinfurzah, jew tista’ tinfurzah bħala limitu assolut sabiex it-talbiet tal-API ifallu wara li l-infiq jilħaq il-limitu. Għall-aħħar passi tal-konfigurazzjoni u l-imġiba attwali, ara Limiti tal-infiq fid-dokumentazzjoni għall-iżviluppaturi.

Kif inħassar jew narkivja proġett?

Il-proġetti jistgħu jiġu arkivjati mill-paġna l-ġdida tal-lista tal-proġetti jew mis-settings ta’ proġett individwali. Ladarba proġett jiġi arkivjat, ma jistax jiġi rrestawrat. Meta tipproċedi bl-arkivjar, tintalab iddaħħal isem il-proġett biex tkompli.

Tista’ tara lista tal-proġetti arkivjati kollha mit-tab “Arkivjati” fl-istess paġna tal-lista tal-proġetti.

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

Il-proġetti ma jistgħux jitħassru. Aħna nżommu storja tal-proġetti kollha biex niżguraw il-kontinwità fit-traċċar tal-użu u tal-fatturazzjoni.

Hemm limitu fuq l-għadd ta’ proġetti li jista’ jkolli fl-organizzazzjoni tiegħi?

B’mod predefinit, l-organizzazzjonijiet jistgħu joħolqu sa 2,000 proġett.

Ir-riżorsi jistgħu jiġu kondiviżi bejn il-proġetti?

Ir-riżorsi tal-proġett (bħal fajls, assistenti, ħażna jew threads) huma limitati għall-proġett u membri li mhumiex amministraturi u jinsabu barra mill-proġett ma jistgħux jaċċessawhom. Barra minn hekk, ir-riżorsi ma jistgħux jiġu trasferiti bejn il-proġetti.

L-unika eċċezzjoni hija li fine tunes fil-“Proġett default” jistgħu jiġu aċċessati minn proġetti oħra.

X’inhi l-kwota tal-ħażna tal-fajls għal kull proġett?

OpenAI bħalissa tappoġġja kwota ta’ ħażna ta’ fajls ta’ 100 GB għal kull proġett.

Jekk tinqabeż din il-kwota, tara l-iżball li ġej:

Qbiżt il-kwota tal-ħażna tal-fajls tiegħek. L-organizzazzjonijiet huma limitati għal 100 GB ta’ fajls. Jekk jogħġbok naqqas id-daqs tal-fajl jew ikkuntattja lis-support.

Nirrakkomandaw li tħassar fajls mhux użati maħżuna fil-kont tiegħek. Għal referenza, tista’ tara u telenka fajls bil-API.

Jien sid ta’ proġett; għaliex ma nistax nara d-Dashboard tal-Użu tal-proġett tiegħi?

Il-viżibbiltà tad-Dashboard tal-Użu ta’ proġett mhijiex marbuta mar-rwol ta’ utent fi ħdan il-proġett. Minflok, hija ddeterminata mir-rwol tiegħek fl-organizzazzjoni u mis-settings fuq https://platform.openai.com/settings/organization/data-controls/visibility

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

Jekk ma tistax tara Dashboard tal-Użu, dan is-setting x’aktarx huwa ssettjat għal "Viżibbli għas-sidien tal-organizzazzjoni".

Dan l-artiklu kien ta’ għajnuna?