Organisationen und Arbeitsbereiche
Auf dieser Seite
Strukturierung Ihres Teams in AI Studio
Solange Sie allein arbeiten, reicht ein einziger API-Schlüssel. Probleme beginnen, sobald drei Entwickler denselben Account teilen: Niemand weiß, welcher Schlüssel welche Anwendung antreibt, die Rechnung kommt als ein unleserlicher Block an, und wenn jemand das Team verlässt, müssen Sie alles widerrufen. AI Studio löst dies mit einer zweistufigen Architektur: Organisationen und Arbeitsbereiche. Das Verständnis dieser Struktur ist unerlässlich für die Verwaltung von Abrechnungen, Berechtigungen und der Isolierung von Ressourcen.
Das Organisations-/Arbeitsbereichs-Modell
Die Organisation befindet sich an der Spitze der Hierarchie. Sie wird automatisch erstellt, wenn Sie sich registrieren, und repräsentiert Ihre Entität – Firma, Team oder Abteilung. Hier wird alles zusammengeführt: die Abrechnung, die alle Kosten aggregiert; die Auswahl des Abonnement-Typs (Experiment, Scale oder Enterprise); Nutzungslimits, also globale Token- und Anfragekontingente; sowie die Zuordnung von Mitgliedern, einschließlich Einladungen und Sitzungsverwaltung. Die Erstellung einer neuen Organisation erfordert lediglich einen Namen und die Annahme der Nutzungsbedingungen. Es ist nichts daran hindern, dass ein einzelner Benutzer gleichzeitig mehreren Organisationen angehört.
Arbeitsbereiche sind Teilmengen innerhalb einer Organisation, die darauf ausgelegt sind, Zugriff und Kosten nach Projekt, Team oder Umgebung zu segmentieren. Jeder Arbeitsbereich isoliert seine API-Schlüssel, die nur Zugriff auf seine eigenen Ressourcen gewähren, und teilt feinabgestimmte Modelle und Trainingsdatensätze unter seinen Mitgliedern. Der Verbrauch bleibt arbeitsbereichsweise nachvollziehbar, sodass Sie präzise feststellen können, wie viel der Support-Chatbot kostet im Vergleich zum internen Suchmotor.
Verwaltung von Rollen und Berechtigungen
Drei Rollen koexistieren auf der Organisationsebene mit absichtlich unterschiedlichen Bereichen der Zuständigkeit.
| Rolle | Abrechnung | Mitglieder | Arbeitsbereiche | API-Schlüssel |
|---|---|---|---|---|
| Inhaber | Ja | Ja | Ja | Ja |
| Administrator | Nein | Ja | Ja | Ja |
| Mitglied | Nein | Nein | Begrenzt | Ja |
Denken Sie an die mittlere Zeile: Ein Administrator verwaltet Teams und Arbeitsbereiche, berührt aber niemals die Abrechnung. Dies ermöglicht es Ihnen, die technische Administration einem ML-Lead anzuvertrauen, ohne ihm Zugriff auf die Firmenkreditkarte zu gewähren.
Die Erstellung eines Arbeitsbereichs erfordert daher Administrator-Berechtigungen. Über die Administrator-Seite Ihrer Organisation:
- Gehen Sie zum Abschnitt Arbeitsbereiche
- Klicken Sie auf Arbeitsbereich erstellen
- Geben Sie einen beschreibenden Namen ein (beispielsweise:
production,staging,research) - Konfigurieren Sie die Anfangsberechtigungen
Das Hinzufügen eines Mitarbeiters folgt einer ähnlichen Logik:
- Gehen Sie zu Administrator > Mitglieder
- Klicken Sie auf Einladen
- Geben Sie die E-Mail-Adresse des Mitarbeiters ein
- Weisen Sie eine Rolle zu (Administrator, Mitglied)
- Wählen Sie die Arbeitsbereiche aus, auf die sie Zugriff haben sollen
Organisationsbest Practices
Die erste Regel ist die Trennung der Umgebungen. Erstellen Sie mindestens zwei Arbeitsbereiche, idealerweise drei, um zu isolieren, was in der Entwicklung passiert, von dem, was Ihre Benutzer berührt.
Organisation "MaStartup"
├── Arbeitsbereich "development" → dev API-Schlüssel, reduzierte Kontingente
├── Arbeitsbereich "staging" → Integrations-Tests
└── Arbeitsbereich "production" → prod API-Schlüssel, hohe Kontingente
Diese Trennung verhindert, dass ein unendlicher Loop, der am Freitagabend in der Entwicklung geschrieben wurde, die Produktionskontingente verschlingt, und sie macht die Kostenverfolgung nach Umgebung sofort lesbar.
Als Nächstes kommt die Schlüsselrotation. Da jeder Schlüssel an einen Arbeitsbereich gebunden ist, erfordert das Ersetzen eines Schlüssels ohne Unterbrechung des Dienstes eine bestimmte Reihenfolge: Erstellen Sie den neuen Schlüssel im relevanten Arbeitsbereich, deployen Sie ihn in Ihrer Anwendung, überprüfen Sie, dass Anfragen tatsächlich damit durchkommen, und löschen Sie erst dann den alten. Das Umkehren der letzten beiden Schritte garantiert einen Ausfall.
import os
# Best Practice: API-Schlüssel über Umgebungsvariable
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
Ein in den Quelldaten hartcodierter Schlüssel landet immer in einem Git-Repository, dann in der Historie dieses Repositories, wo er allen Ihren Bereinigungsversuchen standhält. Nutzen Sie eine Umgebungsvariable von der allerersten Zeile an.
In großen Organisationen profitiert die Governance auch davon, einen Arbeitsbereich pro funktionalem Team zu haben – Data Science, Backend, Produkt – plus einen dedizierten Arbeitsbereich für das Feinabstimmen, der Datensätze zentralisiert, anstatt dass sie dupliziert werden. Explizite Arbeitsbereichsnamen machen die monatliche Berichterstattung umso einfacher.
Konkretes Szenario: Einrichtung
Nehmen wir eine Firma mit fünfzehn Personen, die Mistral adoptiert. Der CTO erstellt die Organisation und abonniert den Scale-Typ, öffnet dann drei Arbeitsbereiche: dev, staging und prod. Entwickler erhalten Mitgliedszugriff, der auf den dev-Arbeitsbereich beschränkt ist, während der ML-Lead Administratorzugriff auf alle drei erhält. Jeder Arbeitsbereich hat seine eigenen API-Schlüssel, die voneinander isoliert sind, sodass ein geleakter Entwicklungsschlüssel nichts in der Produktion gefährdet.
Das Administratordashboard, das unter admin.mistral.ai erreichbar ist, zeigt dann den Verbrauch nach Arbeitsbereich an. Dies ist die Tabelle, die der CTO am Monatsende öffnet, um Kosten nach Projekten zuzuordnen, ohne dass im Code etwas instrumentiert werden muss.
Wichtige Erkenntnisse
- Die Organisation ist die Ebene für Abrechnung und globale Verwaltung
- Arbeitsbereiche isolieren API-Schlüssel, feinabgestimmte Modelle und Kosten
- Trennen Sie Entwicklung, Staging und Produktion immer in getrennte Arbeitsbereiche
- Speichern Sie API-Schlüssel in Umgebungsvariablen, niemals im Code
- Das Administratordashboard ermöglicht es Ihnen, den Verbrauch nach Arbeitsbereich in Echtzeit zu verfolgen