Organisationer och arbetsytor
På denna sida
Strukturera ditt team i AI Studio
Så länge du arbetar ensam räcker en enda API-nyckel. Problemen börjar när tre utvecklare delar samma konto: ingen vet vilken nyckel som driver vilken app, fakturan kommer som ett enda oläsligt block, och den dag någon lämnar teamet måste du återkalla allt. AI Studio löser detta med en tvånivåarkitektur: Organisationer och Arbetsytor. Att förstå denna struktur är avgörande för att hantera fakturering, behörigheter och resursisolering.
Modellen Organisation / Arbetsyta
Organisationen sitter högst upp i hierarkin. Den skapas automatiskt när du registrerar dig och representerar din entitet – företag, team eller avdelning. Här konsolideras allt: fakturering som sammanställer alla kostnader, val av abonnemangsnivå (Experiment, Scale eller Enterprise), användningsgränser vilket innebär globala token- och begärningskvoter, samt medlemstilldelning inklusive inbjudningar och hantering av platser. Att skapa en ny organisation kräver bara ett namn och att du accepterar användarvillkoren, och inget hindrar en enskild användare från att tillhöra flera organisationer samtidigt.
Arbetsytor är undergrupper inom en organisation, designade för att segmentera åtkomst och kostnader per projekt, team eller miljö. Varje arbetsyta isolerar sina API-nycklar, som endast ger åtkomst till dess egna resurser, och delar finjusterade modeller och träningsdataset bland sina medlemmar. Förbrukningen spåras arbetsyta för arbetsyta, så att du exakt kan säga hur mycket supportchattboten kostar jämfört med den interna sökmotorn.
Hantera roller och behörigheter
Tre roller samexisterar på organisationsnivå, med avsiktligt distinkta omfång.
| Roll | Fakturering | Medlemmar | Arbetsytor | API-nycklar |
|---|---|---|---|---|
| Ägare | Ja | Ja | Ja | Ja |
| Admin | Nej | Ja | Ja | Ja |
| Medlem | Nej | Nej | Begränsad | Ja |
Kom ihåg den mellersta raden: en Admin hanterar team och arbetsytor men rör aldrig faktureringen. Detta låter dig överlåta den tekniska administrationen till en ML-ansvarig utan att ge dem tillgång till företagets kreditkort.
Att skapa en arbetsyta kräver därför Admin-behörigheter. Från din organisations sida Admin:
- Gå till sektionen Workspaces
- Klicka på Create Workspace
- Ge den ett beskrivande namn (till exempel:
production,staging,research) - Konfigurera inledande behörigheter
Att lägga till en samarbetspartner följer en liknande logik:
- Gå till Admin > Members
- Klicka på Invite
- Ange samarbetspartnerns e-postadress
- Tilldela en roll (Admin, Member)
- Välj de arbetsytor de ska ha åtkomst till
Bästa praxis för organisationer
Den första regeln är att separera miljöer. Skapa minst två arbetsytor, helst tre, för att isolera vad som händer i utveckling från det som berör dina användare.
Organization "MaStartup"
├── Workspace "development" → dev API keys, reduced quotas
├── Workspace "staging" → integration tests
└── Workspace "production" → prod API keys, high quotas
Denna separation förhindrar att en oändlig loop skriven en fredagskväll i utvecklingsmiljön slukar produktionskvoter, och den gör kostnadsuppföljningen per miljö omedelbart läsbar.
Därefter kommer nyckelrotation. Eftersom varje nyckel är knuten till en arbetsyta krävs en specifik ordning för att byta ut en utan att avbryta tjänsten: generera den nya nyckeln i relevant arbetsyta, distribuera den i din applikation, verifiera att begäranden faktiskt går igenom med den, och först därefter radera den gamla. Att vända på de två sista stegen garanterar ett driftstopp.
import os
# Best practice: API key via environment variable
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
En nyckel som är hårdkodad i källkoden hamnar alltid i ett Git-arkiv, sedan i arkivets historik, där den kommer att överleva alla dina försök att städa upp. Använd en miljövariabel från allra första raden.
I stora organisationer gynnas styrningen också av att ha en arbetsyta per funktionellt team – data science, backend, produkt – plus en dedikerad arbetsyta för finjustering som centraliserar dataset istället för att låta dem dupliceras. Explicita namn på arbetsytor gör månatlig rapportering betydligt enklare.
Konkret scenario: installation
Låt oss ta ett företag med femton anställda som adopterar Mistral. CTO:n skapar organisationen och prenumererar på nivån Scale, öppnar sedan tre arbetsytor: dev, staging och prod. Utvecklare får åtkomst som Medlem begränsad till arbetsyta dev, medan den ML-ansvarige får Admin-åtkomst till alla tre. Varje arbetsyta har sina egna API-nycklar, isolerade från varandra, så att en läckt utvecklingsnyckel inte äventyrar något i produktionen.
Admin-panelen, tillgänglig på admin.mistral.ai, visar sedan förbrukningen per arbetsyta. Detta är tabellen som CTO:n öppnar i slutet av månaden för att fördela kostnader per projekt, utan att behöva instrumentera något i koden.
Viktiga punkter
- Organisationen är nivån för fakturering och global hantering
- Arbetsytor isolerar API-nycklar, finjusterade modeller och kostnader
- Separera alltid utveckling, staging och produktion i distinkta arbetsytor
- Lagra API-nycklar i miljövariabler, aldrig i koden
- Admin-panelen låter dig spåra förbrukning per arbetsyta i realtid