Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Szervezetek és munkaterületek

2. lecke 14 közül Frissítve 2026. július 29. Haladó
Ezen az oldalon
  1. Csapatod szervezése az AI Studio-ban
  2. A Szervezet / Munkaterület modell
  3. Szerepek és jogosultságok kezelése
  4. Szervezeti legjobb gyakorlatok
  5. Konkrét forgatókönyv: beállítás
  6. Főbb megállapítások

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.

SzerepSzámlázásTagokMunkaterületekAPI-kulcsok
Tulajdonos (Owner)IgenIgenIgenIgen
Rendszergazda (Admin)NemIgenIgenIgen
Tag (Member)NemNemKorlátozottIgen

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:

  1. Navigálj a Workspaces szekcióba
  2. Kattints a Create Workspace gombra
  3. Adj neki leíró nevet (például: production, staging, research)
  4. Állítsd be a kezdeti jogosultságokat

Egy együttműködő hozzáadása hasonló logikát követ:

  1. Menj az Admin > Members menüpontra
  2. Kattints az Invite gombra
  3. Írd be az együttműködő e-mail címét
  4. Rendelj hozzá egy szerepet (Admin, Member)
  5. 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