Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Organizacije i radni prostori

Lekcija 2 od 14 Ažurirano 29. srpnja 2026. Napredno
Na ovoj stranici
  1. Strukturiranje tvog tima na AI Studiju
  2. Model Organizacija / Radni prostor
  3. Upravljanje ulogama i dozvolama
  4. Najbolje prakse za organizacije
  5. Konkretni scenarij: postavljanje
  6. Ključne točke

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.

UlogaNaplataČlanoviRadni prostoriAPI ključevi
VlasnikDaDaDaDa
AdministratorNeDaDaDa
ČlanNeNeOgraničenoDa

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:

  1. Idi na odjeljak Workspaces
  2. Klikni Create Workspace
  3. Daj mu opisni naziv (na primjer: production, staging, research)
  4. Konfiguriraj početne dozvole

Dodavanje suradnika slijedi sličnu logiku:

  1. Idi na Admin > Members
  2. Klikni Invite
  3. Unesi e-mail adresu suradnika
  4. Dodijeli ulogu (Admin, Member)
  5. 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