Organizacije in delovni prostori
Na tej strani
Strukturiranje vaše ekipe v AI Studiu
Dokler delate sami, vam zadostuje en sam ključ API. Težave se začnejo, ko trije razvijalci uporabljajo isti račun: nihče ne ve, kateri ključ poganja katero aplikacijo, račun pride kot en nerazločljiv blok, in ko nekdo zapusti ekipo, morate preklicati vse. AI Studio to rešuje z dvonivojsko arhitekturo: organizacije in delovni prostori. Razumevanje te strukture je ključno za upravljanje obračunov, dovoljenj in izolacije virov.
Model organizacije in delovnega prostora
Organizacija stoji na vrhu hierarhije. Ustvari se samodejno ob prijavi in predstavlja vaš entiteto – podjetje, ekipo ali oddelek. Tu se vse združuje: obračunavanje, ki sešteje vse stroške; izbira naročniškega paketa (Experiment, Scale ali Enterprise); omejitve uporabe, kar pomeni globalne kvote žetonov in zahtevkov; ter dodeljevanje članov, vključno z vabili in upravljanjem mest. Ustvarjanje nove organizacije zahteva le ime in sprejem pogojev storitve, nič pa ne preprečuje, da bi bil en uporabnik hkrati član več organizacij.
Delovni prostori so podmnožice znotraj organizacije, zasnovane za razdelitev dostopa in stroškov po projektu, ekipi ali okolju. Vsak delovni prostor izolira svoje ključe API, ki omogočajo dostop le do njegovih lastnih virov, in si med člani deluje prilagojene modele in nabore podatkov za usposabljanje. Poraba ostaja sledljiva za vsak delovni prostor posebej, tako da lahko natančno poveste, koliko stane klepetalni bot za podporo v primerjavi z notranjim iskalnikom.
Upravljanje vlog in dovoljenj
Na ravni organizacije sobivajo tri vloge z namerno različnimi področji pristojnosti.
| Vloga | Obračunavanje | Člani | Delovni prostori | Ključi API |
|---|---|---|---|---|
| Lastnik | Da | Da | Da | Da |
| Skrbnik | Ne | Da | Da | Da |
| Član | Ne | Ne | Omejeno | Da |
Zapomnite si srednjo vrstico: skrbnik upravlja ekipe in delovne prostore, nikoli pa se ne dotakne obračunavanja. To vam omogoča, da tehnično administracijo prepustite vodji strojnega učenja, ne da bi mu dali dostop do podjetniške kreditne kartice.
Ustvarjanje delovnega prostora zato zahteva dovoljenja skrbnika. Na strani Admin vaše organizacije:
- Pojdite v razdelek Workspaces
- Kliknite Create Workspace
- Dajte mu opisno ime (na primer:
production,staging,research) - Konfigurirajte začetna dovoljenja
Dodajanje sodelavca sledi podobni logiki:
- Pojdite na Admin > Members
- Kliknite Invite
- Vnesite e-poštni naslov sodelavca
- Dodelite vlogo (Admin, Member)
- Izberite delovne prostore, do katerih bodo imeli dostop
Najboljše prakse za organizacije
Prvo pravilo je ločevanje okolij. Ustvarite vsaj dva delovna prostora, idealno tri, da izolirate tisto, kar se dogaja v razvoju, od tistega, kar se dotika vaših uporabnikov.
Organization "MaStartup"
├── Workspace "development" → dev API keys, reduced quotas
├── Workspace "staging" → integration tests
└── Workspace "production" → prod API keys, high quotas
Ta ločitev prepreči, da bi neskončna zanka, napisana v petek zvečer v razvojnem okolju, požrla produkcijske kvote, in omogoča takojšnjo berljivost sledenja stroškom po okoljih.
Naslednji korak je rotacija ključev. Ker je vsak ključ povezan z delovnim prostorom, zahteva zamenjava brez prekinitve storitve določen vrstni red: ustvarite nov ključ v ustreznem delovnem prostoru, ga uvedite v svojo aplikacijo, preverite, ali zahtevki z njim dejansko delujejo, in šele nato izbrišite starega. Zamenjava zadnjih dveh korakov zagotavlja izpad storitve.
import os
# Best practice: API key via environment variable
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
Ključ, trdno kodiran v izvorni kodi, bo vedno končal v repozitoriju Git, nato v zgodovini tega repozitorija, kjer bo preživel vse vaše poskuse čiščenja. Uporabite spremenljivko okolja že od prve vrstice naprej.
V velikih organizacijah upravljanje koristi tudi od tega, da ima vsaka funkcionalna ekipa – podatkovna znanost, backend, produkt – svoj delovni prostor, plus namenski delovni prostor za fino prilagajanje, ki centralizira nabore podatkov namesto da bi jim dovolil podvajanje. Eksplicitna imena delovnih prostorov mesečna poročila močno olajšajo.
Konkreten scenarij: nastavitev
Vzemimo petnajstčlansko podjetje, ki uvaja Mistral. Tehnični direktor ustvari organizacijo in se naroči na paket Scale, nato odpre tri delovne prostore: dev, staging in prod. Razvijalci prejmejo dostop člana, omejen na delovni prostor dev, medtem ko vodja strojnega učenja dobi dostop skrbnika do vseh treh. Vsak delovni prostor ima svoje ključe API, medsebojno izolirane, tako da uhajanje razvojnega ključa ne ogrozi ničesar v produkciji.
Nadzorna plošča skrbnika, dostopna na admin.mistral.ai, nato prikaže porabo po delovnih prostorih. To je tabela, ki jo bo tehnični direktor odprl ob koncu meseca za razporeditev stroškov po projektih, ne da bi moral v kodo vgraditi kakršno koli instrumentacijo.
Ključne ugotovitve
- Organizacija je raven za obračunavanje in globalno upravljanje
- Delovni prostori izolirajo ključe API, fino prilagojene modele in stroške
- Vedno ločite razvoj, testno okolje in produkcijo v ločene delovne prostore
- Ključe API shranjujte v spremenljivke okolja, nikoli v kodo
- Nadzorna plošča skrbnika vam omogoča spremljanje porabe po delovnih prostorih v realnem času