Organizacije i radni prostori
Na ovoj stranici
Strukturiranje tvog tima na AI Studiju
Dok radiš sam, jedan API ključ je sasvim dovoljan. Problemi nastaju čim tri programera dijele isti račun: nitko ne zna koji ključ pokreće koju aplikaciju, račun stiže kao jedan nerazumljiv blok, a onog dana kada netko napusti tim, moraš opozvati sve. AI Studio rješava ovo dvorazinskom arhitekturom: Organizacije i Radni prostori. Razumijevanje ove strukture ključno je za upravljanje naplatom, dozvolama i izolacijom resursa.
Model Organizacija / Radni prostor
Organizacija se nalazi na vrhu hijerarhije. Stvara se automatski kada se registriraš i predstavlja tvoj entitet – tvrtku, tim ili odjel. Ovdje se sve konsolidira: naplata, koja zbraja sve troškove; odabir razine pretplate (Experiment, Scale ili Enterprise); ograničenja korištenja, odnosno globalne kvote tokena i zahtjeva; te raspodjela članova, uključujući pozivnice i upravljanje mjestima. Stvaranje nove organizacije zahtijeva samo naziv i prihvaćanje uvjeta korištenja, a ništa ne sprječava jednog korisnika da istovremeno pripada više organizacija.
Radni prostori su podskupovi unutar Organizacije, dizajnirani za segmentiranje pristupa i troškova po projektu, timu ili okruženju. Svaki radni prostor izolira svoje API ključeve, koji daju pristup samo njegovim vlastitim resursima, te dijeli fino podešene modele i skupove podataka za obuku među svojim članovima. Potrošnja ostaje pratljiva radni prostor po radni prostor, tako da možeš precizno reći koliko košta chatbot za podršku u usporedbi s internim tražilicom.
Upravljanje ulogama i dozvolama
Tri uloge postoje na razini Organizacije, s namjerno različitim opsezima.
| Uloga | Naplata | Članovi | Radni prostori | API ključevi |
|---|---|---|---|---|
| Vlasnik | Da | Da | Da | Da |
| Administrator | Ne | Da | Da | Da |
| Član | Ne | Ne | Ograničeno | Da |
Zapamti srednji red: Administrator upravlja timovima i radnim prostorima, ali nikada ne dira naplatu. To ti omogućuje da tehničku administraciju predaš voditelju ML-a bez davanja pristupa kreditnoj kartici tvrtke.
Stvaranje radnog prostora stoga zahtijeva administratorske dozvole. Sa stranice Admin tvoje organizacije:
- Idi na odjeljak Workspaces
- Klikni Create Workspace
- Daj mu opisni naziv (na primjer:
production,staging,research) - Konfiguriraj početne dozvole
Dodavanje suradnika slijedi sličnu logiku:
- Idi na Admin > Members
- Klikni Invite
- Unesi e-mail adresu suradnika
- Dodijeli ulogu (Admin, Member)
- Odaberi radne prostore kojima će imati pristup
Najbolje prakse za organizacije
Prvo pravilo je odvajanje okruženja. Stvori barem dva radna prostora, idealno tri, kako bi izolirao ono što se događa u razvoju od onoga što dotiče tvoje korisnike.
Organization "MaStartup"
├── Workspace "development" → dev API keys, reduced quotas
├── Workspace "staging" → integration tests
└── Workspace "production" → prod API keys, high quotas
Ova separacija sprječava da beskonačna petlja napisana petkom navečer u razvoju proguta produkcijske kvote, a praćenje troškova po okruženju čini odmah čitljivim.
Sljedeće je rotiranje ključeva. Budući da je svaki ključ vezan uz radni prostor, zamjena jednog bez prekida usluge zahtijeva specifičan redoslijed: generiraj novi ključ u odgovarajućem radnom prostoru, implementiraj ga u svoju aplikaciju, provjeri prolaze li zahtjevi stvarno s njim, i tek onda obriši stari. Obrnuti redoslijed zadnja dva koraka garantira prekid rada.
import os
# Best practice: API key via environment variable
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
Ključ hardkodiran u izvornom kodu uvijek će završiti u Git repozitoriju, zatim u povijesti tog repozitorija, gdje će preživjeti sve tvoje pokušaje čišćenja. Koristi varijablu okruženja od prve linije.
U velikim organizacijama, upravljanje također ima koristi od toga da ima jedan radni prostor po funkcionalnom timu – znanost o podacima, backend, proizvod – plus namjenski radni prostor za fino podešavanje koji centralizira skupove podataka umjesto da im dopušta dupliciranje. Eksplicitni nazivi radnih prostora mjesečno izvještavanje čine mnogo lakšim.
Konkretni scenarij: postavljanje
Uzmimo tvrtku od petnaest ljudi koja usvaja Mistral. CTO stvara Organizaciju i pretplaćuje se na razinu Scale, zatim otvara tri radna prostora: dev, staging i prod. Programeri dobivaju pristup člana (Member) ograničen na radni prostor dev, dok voditelj ML-a dobiva administratorski pristup sva tri. Svaki radni prostor ima svoje API ključeve, međusobno izolirane, tako da curenje ključa za razvoj ne ugrožava ništa u produkciji.
Nadzorna ploča administratora, dostupna na admin.mistral.ai, zatim prikazuje potrošnju po radnom prostoru. Ovo je tablica koju će CTO otvoriti na kraju mjeseca kako bi raspodijelio troškove po projektu, bez potrebe za instrumentiranjem bilo čega u kodu.
Ključne točke
- Organizacija je razina za naplatu i globalno upravljanje
- Radni prostori izoliraju API ključeve, fino podešene modele i troškove
- Uvijek odvoj razvoj, staging i produkciju u zasebne radne prostore
- Pohrani API ključeve u varijable okruženja, nikada u kod
- Nadzorna ploča administratora omogućuje praćenje potrošnje po radnom prostoru u stvarnom vremenu