Organizații și spații de lucru
Pe această pagină
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.
| Rol | Facturare | Membri | Spații de lucru | Chei API |
|---|---|---|---|---|
| Proprietar (Owner) | Da | Da | Da | Da |
| Administrator (Admin) | Nu | Da | Da | Da |
| Membru | Nu | Nu | Limitat | Da |
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ă:
- Accesați secțiunea Workspaces
- Faceți clic pe Create Workspace
- Dați-i un nume descriptiv (de exemplu:
production,staging,research) - Configurați permisiunile inițiale
Adăugarea unui colaborator urmează o logică similară:
- Accesați Admin > Members
- Faceți clic pe Invite
- Introduceți adresa de e-mail a colaboratorului
- Atribuiți un rol (Admin, Member)
- 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