Szervezetek és munkaterületek
Ezen az oldalon
Csapatod szervezése az AI Studio-ban
Amíg egyedül dolgozol, egyetlen API-kulcs is elegendő. A gondok akkor kezdődnek, amikor három fejlesztő osztozik ugyanazon a fiókon: senki nem tudja, melyik kulcs hajtja meg melyik alkalmazást, a számla egy értelmezhetetlen tömbként érkezik, és amikor valaki elhagyja a csapatot, mindent vissza kell vonnod. Az AI Studio ezt egy kétszintes architektúrával oldja meg: Szervezetek (Organizations) és Munkaterületek (Workspaces). E struktúra megértése elengedhetetlen a számlázás, a jogosultságok és az erőforrások izolálásának kezeléséhez.
A Szervezet / Munkaterület modell
A hierarchia csúcsán a Szervezet áll. Ez automatikusan létrejön a regisztrációkor, és a te entitásodat képviseli – legyen az cég, csapat vagy osztály. Itt fut össze minden: a számlázás, amely aggregálja az összes költséget; az előfizetési csomag kiválasztása (Experiment, Scale vagy Enterprise); a használati korlátok, azaz a globális token- és kéréskvóták; valamint a tagok hozzárendelése, beleértve a meghívásokat és a helyek kezelését. Új szervezet létrehozásához csak egy név és a szolgáltatási feltételek elfogadása szükséges, és semmi nem akadályozza meg, hogy egyetlen felhasználó több szervezethez is tartozzon egyszerre.
A munkaterületek a Szervezeten belüli alrészek, amelyeket projektek, csapatok vagy környezetek szerinti hozzáférés- és költségelkülönítésre terveztek. Minden munkaterület izolálja a saját API-kulcsait, amelyek csak az adott terület erőforrásaihoz férnek hozzá, és megosztják a finomhangolt modelleket és betanítási adatkészleteket a tagok között. A fogyasztás munkaterületenként nyomon követhető marad, így pontosan megmondhatod, mennyibe kerül a támogatási chatbot a belső keresőmotorhoz képest.
Szerepek és jogosultságok kezelése
Három szerep létezik a Szervezet szintjén, szándékosan eltérő hatáskörökkel.
| Szerep | Számlázás | Tagok | Munkaterületek | API-kulcsok |
|---|---|---|---|---|
| Tulajdonos (Owner) | Igen | Igen | Igen | Igen |
| Rendszergazda (Admin) | Nem | Igen | Igen | Igen |
| Tag (Member) | Nem | Nem | Korlátozott | Igen |
Jegyezd meg a középső sort: a Rendszergazda kezeli a csapatokat és a munkaterületeket, de soha nem fér hozzá a számlázáshoz. Ez lehetővé teszi, hogy a technikai adminisztrációt egy ML-vezetőre bízd anélkül, hogy hozzáférést adnál neki a cég hitelkártyájához.
Egy munkaterület létrehozásához tehát Rendszergazda jogosultság szükséges. A szervezeted Admin oldaláról:
- Navigálj a Workspaces szekcióba
- Kattints a Create Workspace gombra
- Adj neki leíró nevet (például:
production,staging,research) - Állítsd be a kezdeti jogosultságokat
Egy együttműködő hozzáadása hasonló logikát követ:
- Menj az Admin > Members menüpontra
- Kattints az Invite gombra
- Írd be az együttműködő e-mail címét
- Rendelj hozzá egy szerepet (Admin, Member)
- Válaszd ki azokat a munkaterületeket, amelyekhez hozzáférést kap
Szervezeti legjobb gyakorlatok
Az első szabály a környezetek szétválasztása. Hozz létre legalább két, ideális esetben három munkaterületet, hogy elkülönítsd a fejlesztésben történő eseményeket attól, ami érinti a felhasználóidat.
Organization "MaStartup"
├── Workspace "development" → dev API-kulcsok, csökkentett kvóták
├── Workspace "staging" → integrációs tesztek
└── Workspace "production" → prod API-kulcsok, magas kvóták
Ez a szétválasztás megakadályozza, hogy egy péntek éjszaka a fejlesztésben írt végtelen ciklus feleméssze a produkciós kvótákat, és azonnal átláthatóvá teszi a környezetek szerinti költségkövetést.
Ezt követi a kulcsok rotációja. Mivel minden kulcs egy munkaterülethez van kötve, egy kulcs szolgáltatáskiesés nélküli cseréje speciális sorrendet igényel: generáld az új kulcsot az érintett munkaterületen, telepítsd az alkalmazásodba, ellenőrizd, hogy a kérések ténylegesen átmennek-e vele, és csak ezután töröld a régit. Az utolsó két lépés felcserélése garantáltan kimaradást okoz.
import os
# Legjobb gyakorlat: API-kulcs környezeti változón keresztül
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
A forráskódba keménykódolt kulcs mindig felkerül egy Git-tárolóba, majd annak előzményeibe, ahol túlél minden tisztítási kísérletedet. Használj környezeti változót már az első sortól kezdve.
Nagy szervezeteknél a governancenek is jót tesz, ha funkcionális csapatonként (adattudomány, backend, termék) egy-egy munkaterületet hozunk létre, plusz egy dedikált munkaterületet a finomhangolásnak, amely központosítja az adatkészleteket ahelyett, hogy hagyná azok duplikálódását. A kifejező munkaterület-nevek sokkal könnyebbé teszik a havi riportálást.
Konkrét forgatókönyv: beállítás
Vegyünk egy tizenöt fős céget, amely bevezeti a Mistralt. A CTO létrehozza a Szervezetet és előfizet a Scale csomagra, majd megnyit három munkaterületet: dev, staging és prod. A fejlesztők Tag hozzáférést kapnak, korlátozva a dev munkaterületre, míg az ML-vezető Rendszergazda hozzáférést kap mindháromhoz. Minden munkaterületnek megvannak a saját, egymástól izolált API-kulcsai, így egy szivárgott fejlesztői kulcs semmit sem veszélyeztet a produkcióban.
Az admin.mistral.ai címen elérhető adminisztrációs irányítópult ezután munkaterületenként jeleníti meg a fogyasztást. Ez az a táblázat, amelyet a CTO a hónap végén megnyit, hogy projektenként allokálja a költségeket, anélkül, hogy bármit instrumentálnia kellene a kódban.
Főbb megállapítások
- A Szervezet a számlázás és a globális menedzsment szintje
- A munkaterületek izolálják az API-kulcsokat, a finomhangolt modelleket és a költségeket
- Mindig válaszd szét a fejlesztési, tesztelési (staging) és produkciós környezeteket külön munkaterületekre
- Az API-kulcsokat környezeti változókban tárold, soha ne a kódban
- Az adminisztrációs irányítópult valós időben lehetővé teszi a fogyasztás munkaterületenkénti nyomon követését