Organisaties en werkruimten
Op deze pagina
Uw team structureren in AI Studio
Zolang u alleen werkt, volstaat één API-sleutel. Problemen beginnen zodra drie ontwikkelaars hetzelfde account delen: niemand weet welke sleutel welke app aandrijft, de factuur komt binnen als één onleesbaar blok, en op de dag dat iemand het team verlaat, moet u alles intrekken. AI Studio lost dit op met een architectuur op twee niveaus: Organisaties en Werkruimten. Inzicht in deze structuur is essentieel voor het beheer van facturatie, machtigingen en resource-isolatie.
Het model Organisatie / Werkruimte
De Organisatie staat bovenaan de hiërarchie. Deze wordt automatisch aangemaakt wanneer u zich registreert en vertegenwoordigt uw entiteit—bedrijf, team of afdeling. Hier komt alles samen: facturatie, die alle kosten aggregeert; selectie van het abonnementsniveau (Experiment, Scale of Enterprise); gebruikslimieten, oftewel globale token- en aanvraagquota; en toewijzing van leden, inclusief uitnodigingen en beheer van licenties. Het aanmaken van een nieuwe organisatie vereist slechts een naam en acceptatie van de servicevoorwaarden, en niets verhindert dat een enkele gebruiker tegelijkertijd tot meerdere organisaties behoort.
Werkruimten zijn subsets binnen een Organisatie, ontworpen om toegang en kosten te segmenteren per project, team of omgeving. Elke werkruimte isoleert zijn API-sleutels, die alleen toegang verlenen tot de eigen resources, en deelt fijnafgestemde modellen en trainingsdatasets onder zijn leden. Het verbruik blijft traceerbaar per werkruimte, zodat u precies kunt aangeven hoeveel de support-chatbot kost in vergelijking met de interne zoekmachine.
Rollen en machtigingen beheren
Op organisatieniveau bestaan er drie rollen, met bewust onderscheiden reikwijdtes.
| Rol | Facturatie | Leden | Werkruimten | API-sleutels |
|---|---|---|---|---|
| Eigenaar | Ja | Ja | Ja | Ja |
| Beheerder | Nee | Ja | Ja | Ja |
| Lid | Nee | Nee | Beperkt | Ja |
Onthoud de middelste rij: een Beheerder beheert teams en werkruimten, maar raakt nooit de facturatie aan. Hiermee kunt u technisch beheer overdragen aan een ML-leider zonder hen toegang te geven tot de creditcard van het bedrijf.
Het aanmaken van een werkruimte vereist daarom Beheerdersrechten. Ga vanuit de pagina Beheer van uw organisatie als volgt te werk:
- Ga naar het gedeelte Werkruimten
- Klik op Werkruimte aanmaken
- Geef deze een beschrijvende naam (bijvoorbeeld:
production,staging,research) - Configureer de initiële machtigingen
Het toevoegen van een medewerker volgt een vergelijkbare logica:
- Ga naar Beheer > Leden
- Klik op Uitnodigen
- Voer het e-mailadres van de medewerker in
- Wijs een rol toe (Beheerder, Lid)
- Selecteer de werkruimten waartoe zij toegang krijgen
Best practices voor organisaties
De eerste regel is het scheiden van omgevingen. Maak minimaal twee werkruimten aan, idealiter drie, om te isoleren wat er in ontwikkeling gebeurt van wat uw gebruikers raakt.
Organisatie "MaStartup"
├── Werkruimte "development" → dev API-sleutels, verlaagde quota
├── Werkruimte "staging" → integratietests
└── Werkruimte "production" → prod API-sleutels, hoge quota
Deze scheiding voorkomt dat een oneindige lus die op een vrijdagavond in ontwikkeling is geschreven, de productiequota opslokt, en maakt kostentracking per omgeving direct leesbaar.
Vervolgens komt het roteren van sleutels. Omdat elke sleutel aan een werkruimte is gekoppeld, vereist het vervangen ervan zonder onderbreking van de service een specifieke volgorde: genereer de nieuwe sleutel in de betreffende werkruimte, implementeer deze in uw applicatie, verifieer dat aanvragen er daadwerkelijk mee doorkomen, en verwijder pas daarna de oude. Het omdraaien van de laatste twee stappen garandeert een storing.
import os
# Best practice: API-sleutel via omgevingsvariabele
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
Een sleutel die hard-coded in de broncode staat, belandt altijd in een Git-repository, vervolgens in de geschiedenis van die repository, waar deze al uw opruimpogingen zal overleven. Gebruik vanaf de eerste regel een omgevingsvariabele.
In grote organisaties profiteert governance er ook van om één werkruimte per functioneel team te hebben—data science, backend, product—plus een toegewijde werkruimte voor fine-tuning die datasets centraliseert in plaats van ze te laten dupliceren. Expliciete namen van werkruimten maken maandelijkse rapportage een stuk eenvoudiger.
Concreet scenario: opzet
Laten we uitgaan van een bedrijf van vijftien personen dat Mistral adopteert. De CTO maakt de Organisatie aan en neemt een abonnement op het Scale-niveau, opent vervolgens drie werkruimten: dev, staging en prod. Ontwikkelaars ontvangen Lid-toegang beperkt tot de dev-werkruimte, terwijl de ML-leider Beheerderstoegang krijgt tot alle drie. Elke werkruimte heeft zijn eigen API-sleutels, geïsoleerd van elkaar, zodat een gelekte ontwikkelingssleutel niets in productie compromitteert.
Het beheerdashboard, toegankelijk via admin.mistral.ai, toont vervolgens het verbruik per werkruimte. Dit is de tabel die de CTO aan het einde van de maand opent om kosten per project toe te wijzen, zonder dat er iets in de code hoeft te worden geïnstrumenteerd.
Belangrijkste punten
- De Organisatie is het niveau voor facturatie en globaal beheer
- Werkruimten isoleren API-sleutels, fijnafgestemde modellen en kosten
- Scheid ontwikkeling, staging en productie altijd in afzonderlijke werkruimten
- Bewaar API-sleutels in omgevingsvariabelen, nooit in code
- Met het beheerdashboard kunt u het verbruik per werkruimte in realtime volgen