Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Organizzazzjonijiet u Spazji tax-Xogħol

Lezzjoni 2 / 14 Aġġornat 29 ta’ Lulju 2026 Avvanzat
F'din il-paġna
  1. L-istruttura tat-tim tiegħek fuq AI Studio
  2. Il-mudell Organizzazzjoni / Spazju tax-Xogħol
  3. Ġestjoni tar-rwoli u l-permessi
  4. Prattiki tajbin organizzattivi
  5. Xenarju konkret: setup
  6. Punti Ewlenin

L-istruttura tat-tim tiegħek fuq AI Studio

Sakemm taħdem waħdek, ċavetta API waħda biżżejjed. Il-problemi jibdew hekk kif tliet żviluppaturi jaqsmu l-istess kont: ħadd ma jaf liema ċavetta tħaddem liema app, il-kont jaslu bħala blokk wieħed li ma tifhimx, u l-jum li xi ħadd iħalli t-tim, trid tirrevoka kollox. AI Studio jsolvi dan b’arkitettura fuq żewġ livelli: Organizzazzjonijiet u Spazji tax-Xogħol. Li tifhem din l-istruttura huwa essenzjali biex timmaniġġja l-fatturazzjoni, il-permessi u l-iżolament tar-riżorsi.

Il-mudell Organizzazzjoni / Spazju tax-Xogħol

L-Organizzazzjoni tinsab fil-quċċata tal-ġerarkija. Tinħoloq awtomatikament meta tirreġistra u tirrappreżenta l-entità tiegħek—kumpanija, tim jew dipartiment. Hawnhekk jiġi kkonsolidat kollox: il-fatturazzjoni, li tgħaqqad l-ispejjeż kollha; l-għażla tal-livell ta’ abbonament (Experiment, Scale jew Enterprise); il-limiti tal-użu, jiġifieri l-kwoti globali ta’ token u ta’ talbiet; u l-allokazzjoni tal-membri, inklużi stedina u ġestjoni tas-siġġijiet. Biex toħloq organizzazzjoni ġdida, għandek bżonn biss isem u li taċċetta t-termini tas-servizz, u xejn ma jipprevjeni lil utent wieħed milli jappartjeni għal diversi organizzazzjonijiet fl-istess ħin.

L-Ispazji tax-Xogħol huma sottosettijiet fi ħdan Organizzazzjoni, iddisinjati biex jissegmentaw l-aċċess u l-ispejjeż skont il-proġett, it-tim jew l-ambjent. Kull spazju tax-xogħol jiżola ċ-ċwievet API tiegħu, li jagħtu aċċess biss għar-riżorsi tiegħu stess, u jaqsamu mudelli mwaħħla (fine-tuned) u settijiet ta’ data tat-taħriġ fost il-membri tiegħu. Il-konsum jibqa’ traċċabbli spazju tax-xogħol wara l-ieħor, hekk li tista’ tgħid preċiżament kemm jiswa l-chatbot tas-sostenn meta mqabbel mal-magna ta’ tfittxija interna.

Ġestjoni tar-rwoli u l-permessi

Tliet rwoli jikkoegżistu fil-livell tal-Organizzazzjoni, b’ambiti deliberatament distinti.

RwolFatturazzjoniMembriSpazji tax-XogħolĊwievet API
SidIvaIvaIvaIva
AmministraturLeIvaIvaIva
MembruLeLeLimitatIva

Ftakar fir-ringa tan-nofs: Amministratur jimmaniġġja t-timijiet u l-ispazji tax-xogħol iżda qatt ma jmiss il-fatturazzjoni. Dan jippermettilek li tagħti l-amministrazzjoni teknika lil kap tal-ML mingħajr ma tagħtih aċċess għall-karta tal-kreditu tal-kumpanija.

Għalhekk, il-ħolqien ta’ spazju tax-xogħol jeħtieġ permessi ta’ Amministratur. Mill-paġna Admin tal-organizzazzjoni tiegħek:

  1. Mur fit-taqsima Workspaces
  2. Ikklikkja Create Workspace
  3. Agħtih isem deskrittiv (pereżempju: production, staging, research)
  4. Ikkonfigura l-permessi inizjali

Li żżid kollaboratur isegwi loġika simili:

  1. Mur f’Admin > Members
  2. Ikklikkja Invite
  3. Daħħal l-indirizz email tal-kollaboratur
  4. Assenja rwol (Admin, Member)
  5. Agħżel l-ispazji tax-xogħol li għalihom ikollhom aċċess

Prattiki tajbin organizzattivi

L-ewwel regola hija li tissepara l-ambjenti. Oħloq mill-inqas żewġ spazji tax-xogħol, idealment tlieta, biex tiżola dak li jiġri fl-iżvilupp minn dak li jmiss lill-utenti tiegħek.

Organization "MaStartup"
├── Workspace "development"    → ċwievet API dev, kwoti mnaqqsa
├── Workspace "staging"        → testijiet ta' integrazzjoni
└── Workspace "production"     → ċwievet API prod, kwoti għoljin

Din is-separazzjoni tipprevjeni li ċ-ċiklu infinit miktub il-Ġimgħa filgħaxija fl-iżvilupp jiekol il-kwoti tal-produzzjoni, u tagħmel it-traċċar tal-ispejjeż skont l-ambjent immedjatament leġibbli.

Imbagħad tiġi r-rotazzjoni taċ-ċwievet. Peress li kull ċavetta hija marbuta ma’ spazju tax-xogħol, biex tibdel waħda mingħajr ma tinterrompi s-servizz jeħtieġ ordni speċifika: iġġenera ċ-ċavetta l-ġdida fl-ispazju tax-xogħol rilevanti, iddiplojaha fl-applikazzjoni tiegħek, ivverifika li t-talbiet effettivament jgħaddu biha, u mbagħad biss ħassar dik antika. Li taqleb iż-żewġ passi finali jiggarantixxi interruzzjoni.

import os

# Prattika tajba: ċavetta API permezz ta' varjabbli tal-ambjent
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

Ċavetta mwaħħla direttament fil-kodiċi sors dejjem tispiċċa f’repożitorju Git, imbagħad fl-istorja ta’ dak ir-repożitorju, fejn tibqa’ ħajja minkejja l-attentativi kollha tiegħek biex tnaddaf. Uża varjabbli tal-ambjent mill-ewwel linja.

F’organizzazzjonijiet kbar, il-governanza tibbenefika wkoll milli jkollok spazju tax-xogħol wieħed għal kull tim funzjonali—xjenza tad-data, backend, prodott—flimkien ma’ spazju tax-xogħol iddedikat għall-fine-tuning li jiċċentralizza s-settijiet ta’ data minflok ma jħallihom jirduppjaw. Ismijiet espliċiti tal-ispazji tax-xogħol jagħmlu r-rapportar ta’ kull xahar ferm aktar faċli.

Xenarju konkret: setup

Ħa nieħdu kumpanija ta’ ħmistax-il persuna li qed tadotta Mistral. Is-CTO joħloq l-Organizzazzjoni u jissottoskrivi għall-livell Scale, imbagħad jiftaħ tliet spazji tax-xogħol: dev, staging, u prod. L-iżviluppaturi jirċievu aċċess ta’ Membru limitat għall-ispazju tax-xogħol dev, filwaqt li l-kap tal-ML jikseb aċċess ta’ Admin għat-tlieta kollha. Kull spazju tax-xogħol għandu ċ-ċwievet API tiegħu, iżolati minn xulxin, hekk li ċavetta tal-iżvilupp li tiġi xxukkjata ma tikkomprometti xejn fil-produzzjoni.

Id-dashboard tal-amministratur, aċċessibbli fuq admin.mistral.ai, imbagħad juri l-konsum skont l-ispazju tax-xogħol. Din hija t-tabella li s-CTO se jiftaħ fi tmiem ix-xahar biex jalloka l-ispejjeż skont il-proġett, mingħajr ma jkollu jistrumenta xejn fil-kodiċi.

Punti Ewlenin

  • L-Organizzazzjoni hija l-livell għall-fatturazzjoni u l-ġestjoni globali
  • L-Ispazji tax-Xogħol jiżolaw iċ-ċwievet API, il-mudelli mwaħħla u l-ispejjeż
  • Dejjem ifred l-iżvilupp, l-istaging u l-produzzjoni f’ispazji tax-xogħol distinti
  • Aħżen iċ-ċwievet API f’varjabbli tal-ambjent, qatt fil-kodiċi
  • Id-dashboard tal-amministratur jippermettilek issegwi l-konsum skont l-ispazju tax-xogħol f’ħin reali