Salt la conținutul principal
Română— Alege o limbă
Meniu

Organizații și spații de lucru

Lecția 2 din 14 Actualizată 29 iulie 2026 Avansat
Pe această pagină
  1. Structurarea echipei dumneavoastră în AI Studio
  2. Modelul Organizație / Spațiu de lucru
  3. Gestionarea rolurilor și permisiunilor
  4. Cele mai bune practici organizaționale
  5. Scenariu concret: configurare
  6. Puncte cheie

Structurarea echipei dumneavoastră în AI Studio

Cât timp lucrați singur, o singură cheie API este suficientă. Problemele încep în momentul în care trei dezvoltatori partajează același cont: nimeni nu știe care cheie alimentează care aplicație, factura sosește ca un bloc indecifrabar, iar în ziua în care cineva părăsește echipa, trebuie să revocați totul. AI Studio rezolvă această situație printr-o arhitectură pe două niveluri: Organizații și Spații de lucru (Workspaces). Înțelegerea acestei structuri este esențială pentru gestionarea facturării, a permisiunilor și a izolării resurselor.

Modelul Organizație / Spațiu de lucru

Organizația se află în vârful ierarhiei. Aceasta este creată automat la înregistrare și reprezintă entitatea dumneavoastră—companie, echipă sau departament. Aici se consolidează totul: facturarea, care agregă toate costurile; selecția nivelului de abonament (Experiment, Scale sau Enterprise); limitele de utilizare, adică cotele globale de tokeni și cereri; și alocarea membrilor, inclusiv invitațiile și gestionarea locurilor. Crearea unei noi organizații necesită doar un nume și acceptarea termenilor de utilizare, iar nimic nu împiedică un singur utilizator să aparțină mai multor organizații simultan.

Spațiile de lucru sunt subansambluri în cadrul unei Organizații, concepute pentru a segmenta accesul și costurile pe proiect, echipă sau mediu. Fiecare spațiu de lucru își izolează cheile API, care acordă acces doar la propriile resurse, și partajează modelele ajustate fin (fine-tuned) și seturile de date de antrenament între membrii săi. Consumul rămâne trasabil spațiu cu spațiu, astfel încât puteți spune precis cât costă chatbot-ul de suport comparativ cu motorul de căutare intern.

Gestionarea rolurilor și permisiunilor

Trei roluri coexistă la nivelul Organizației, cu domenii de aplicare deliberat distincte.

RolFacturareMembriSpații de lucruChei API
Proprietar (Owner)DaDaDaDa
Administrator (Admin)NuDaDaDa
MembruNuNuLimitatDa

Rețineți rândul din mijloc: un Administrator gestionează echipele și spațiile de lucru, dar nu atinge niciodată facturarea. Acest lucru vă permite să încredințați administrarea tehnică unui responsabil ML fără a-i oferi acces la cardul de credit al companiei.

Crearea unui spațiu de lucru necesită, prin urmare, permisiuni de Administrator. Din pagina Admin a organizației dumneavoastră:

  1. Accesați secțiunea Workspaces
  2. Faceți clic pe Create Workspace
  3. Dați-i un nume descriptiv (de exemplu: production, staging, research)
  4. Configurați permisiunile inițiale

Adăugarea unui colaborator urmează o logică similară:

  1. Accesați Admin > Members
  2. Faceți clic pe Invite
  3. Introduceți adresa de e-mail a colaboratorului
  4. Atribuiți un rol (Admin, Member)
  5. Selectați spațiile de lucru la care va avea acces

Cele mai bune practici organizaționale

Prima regulă este separarea mediilor. Creați cel puțin două spații de lucru, ideal trei, pentru a izola ceea ce se întâmplă în dezvoltare de ceea ce intră în contact cu utilizatorii dumneavoastră.

Organization "MaStartup"
├── Workspace "development"    → chei API dev, cote reduse
├── Workspace "staging"        → teste de integrare
└── Workspace "production"     → chei API prod, cote mari

Această separare previne ca o buclă infinită scrisă într-o vineri seara în mediul de dezvoltare să devoreze cotele de producție și face urmărirea costurilor pe mediu imediat lizibilă.

Urmează rotația cheilor. Deoarece fiecare cheie este legată de un spațiu de lucru, înlocuirea uneia fără întreruperea serviciului necesită o ordine specifică: generați noua cheie în spațiul de lucru relevant, implementați-o în aplicație, verificați faptul că cererile trec efectiv prin ea și abia apoi ștergeți cheia veche. Inversarea ultimilor doi pași garantează o pană de sistem.

import os

# Best practice: API key via environment variable
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

O cheie inclusă direct în codul sursă va ajunge întotdeauna într-un repository Git, apoi în istoricul acelui repository, unde va supraviețui tuturor încercărilor dumneavoastră de curățare. Utilizați o variabilă de mediu încă de la prima linie.

În organizațiile mari, guvernanța beneficiază, de asemenea, de existența unui spațiu de lucru per echipă funcțională—data science, backend, produs—plus un spațiu de lucru dedicat ajustării fine (fine-tuning) care centralizează seturile de date în loc să le lase să se dubleze. Numele explicite ale spațiilor de lucru fac raportarea lunară cu atât mai ușoară.

Scenariu concret: configurare

Să luăm exemplul unei companii de cincisprezece persoane care adoptă Mistral. CTO creează Organizația și se abonează la nivelul Scale, apoi deschide trei spații de lucru: dev, staging și prod. Dezvoltatorii primesc acces de Membru limitat la spațiul de lucru dev, în timp ce responsabilul ML primește acces de Administrator la toate cele trei. Fiecare spațiu de lucru are propriile chei API, izolate unele de altele, astfel încât o cheie de dezvoltare compromisă nu afectează nimic în producție.

Tabloul de bord de administrare, accesibil la admin.mistral.ai, afișează apoi consumul pe spațiu de lucru. Acesta este tabelul pe care CTO îl va deschide la sfârșitul lunii pentru a aloca costurile pe proiect, fără a fi nevoie să instrumenteze nimic în cod.

Puncte cheie

  • Organizația este nivelul pentru facturare și gestionare globală
  • Spațiile de lucru izolează cheile API, modelele ajustate fin și costurile
  • Separați întotdeauna dezvoltarea, staging-ul și producția în spații de lucru distincte
  • Stocați cheile API în variabile de mediu, niciodată în cod
  • Tabloul de bord de administrare vă permite să urmăriți consumul pe spațiu de lucru în timp real