Przejdź do głównej treści
Polski— Wybierz język
Menu

Organizacje i obszary robocze

Lekcja 2 z 14 Zaktualizowano 29 lipca 2026 Zaawansowany
Na tej stronie
  1. Strukturyzowanie zespołu w AI Studio
  2. Model Organizacja / Obszar roboczy
  3. Zarządzanie rolami i uprawnieniami
  4. Najlepsze praktyki organizacyjne
  5. Konkretny scenariusz: konfiguracja
  6. Kluczowe wnioski

Strukturyzowanie zespołu w AI Studio

Dopóki pracujesz sam, wystarczy jeden klucz API. Problemy zaczynają się w momencie, gdy trzech programistów dzieli to samo konto: nikt nie wie, który klucz zasila którą aplikację, faktura przychodzi jako jeden nieczytelny blok, a gdy ktoś opuszcza zespół, musisz unieważnić wszystko. AI Studio rozwiązuje ten problem dzięki architekturze dwupoziomowej: Organizacje i Obszary robocze. Zrozumienie tej struktury jest kluczowe dla zarządzania rozliczeniami, uprawnieniami i izolacją zasobów.

Model Organizacja / Obszar roboczy

Organizacja znajduje się na szczycie hierarchii. Jest tworzona automatycznie podczas rejestracji i reprezentuje Twój podmiot – firmę, zespół lub dział. To tutaj wszystko się konsoliduje: rozliczenia agregujące wszystkie koszty, wybór poziomu subskrypcji (Experiment, Scale lub Enterprise), limity wykorzystania, czyli globalne kwoty tokenów i żądań, oraz przydział członków, obejmujący zaproszenia i zarządzanie miejscami. Utworzenie nowej organizacji wymaga jedynie podania nazwy i zaakceptowania warunków usługi, a nic nie stoi na przeszkodzie, by jeden użytkownik należał jednocześnie do wielu organizacji.

Obszary robocze to podzbiory wewnątrz Organizacji, zaprojektowane do segmentowania dostępu i kosztów według projektu, zespołu lub środowiska. Każdy obszar roboczy izoluje swoje klucze API, które udzielają dostępu wyłącznie do jego własnych zasobów, oraz udostępnia dostrojone modele i zbiory danych treningowych swoim członkom. Zużycie pozostaje możliwe do śledzenia dla każdego obszaru roboczego z osobna, dzięki czemu możesz precyzyjnie określić, ile kosztuje bot wsparcia w porównaniu do wewnętrznej wyszukiwarki.

Zarządzanie rolami i uprawnieniami

Na poziomie Organizacji współistnieją trzy role o celowo różnych zakresach uprawnień.

RolaRozliczeniaCzłonkowieObszary roboczeKlucze API
WłaścicielTakTakTakTak
AdministratorNieTakTakTak
CzłonekNieNieOgraniczoneTak

Zapamiętaj środkowy wiersz: Administrator zarządza zespołami i obszarami roboczymi, ale nigdy nie ma dostępu do rozliczeń. Pozwala to przekazać administrację techniczną liderowi ML, nie dając mu jednocześnie dostępu do firmowej karty kredytowej.

Utworzenie obszaru roboczego wymaga zatem uprawnień Administratora. Ze strony Admin swojej organizacji:

  1. Przejdź do sekcji Workspaces
  2. Kliknij Create Workspace
  3. Nadaj mu opisową nazwę (na przykład: production, staging, research)
  4. Skonfiguruj początkowe uprawnienia

Dodawanie współpracownika przebiega według podobnej logiki:

  1. Przejdź do Admin > Members
  2. Kliknij Invite
  3. Wprowadź adres e-mail współpracownika
  4. Przypisz rolę (Admin, Member)
  5. Wybierz obszary robocze, do których będzie miał dostęp

Najlepsze praktyki organizacyjne

Pierwszą zasadą jest separacja środowisk. Utwórz co najmniej dwa obszary robocze, a idealnie trzy, aby odizolować to, co dzieje się w fazie rozwoju, od tego, co dotyczy użytkowników.

Organization "MaStartup"
├── Workspace "development"    → klucze API dev, zmniejszone limity
├── Workspace "staging"        → testy integracyjne
└── Workspace "production"     → klucze API prod, wysokie limity

Ta separacja zapobiega sytuacji, w której pętla nieskończona napisana w piątek wieczorem w środowisku deweloperskim pochłania limity produkcyjne, a także sprawia, że śledzenie kosztów według środowiska jest natychmiast czytelne.

Kolejnym krokiem jest rotacja kluczy. Ponieważ każdy klucz jest powiązany z konkretnym obszarem roboczym, jego wymiana bez przerywania usługi wymaga zachowania określonej kolejności: wygeneruj nowy klucz w odpowiednim obszarze roboczym, wdróż go w swojej aplikacji, zweryfikuj, czy żądania są przez niego poprawnie obsługiwane, i dopiero wtedy usuń stary klucz. Odwrócenie dwóch ostatnich kroków gwarantuje przerwę w działaniu usługi.

import os

# Najlepsza praktyka: klucz API poprzez zmienną środowiskową
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

Klucz zaszyty na sztywno w kodzie źródłowym zawsze trafi do repozytorium Git, a następnie do jego historii, gdzie przetrwa wszystkie Twoje próby czyszczenia. Używaj zmiennej środowiskowej już od pierwszej linii kodu.

W dużych organizacjach zarządzanie korzysta również z posiadania jednego obszaru roboczego na zespół funkcjonalny – data science, backend, produkt – plus dedykowanego obszaru roboczego do dostrajania, który centralizuje zbiory danych, zamiast pozwalać na ich dublowanie. Jawne nazwy obszarów roboczych znacznie ułatwiają comiesięczne raportowanie.

Konkretny scenariusz: konfiguracja

Weźmy piętnastoosobową firmę wdrażającą rozwiązania Mistral. CTO tworzy Organizację i subscribuje poziom Scale, a następnie otwiera trzy obszary robocze: dev, staging i prod. Programiści otrzymują dostęp jako Członek ograniczony do obszaru roboczego dev, podczas gdy lider ML uzyskuje dostęp Administratora do wszystkich trzech. Każdy obszar roboczy posiada własne, odizolowane od siebie klucze API, więc wyciek klucza deweloperskiego nie zagraża niczemu w środowisku produkcyjnym.

Panel administratora, dostępny pod adresem admin.mistral.ai, wyświetla następnie zużycie według obszaru roboczego. To tabela, którą CTO otworzy na koniec miesiąca, aby przydzielić koszty do projektów, bez konieczności instrumentowania czegokolwiek w kodzie.

Kluczowe wnioski

  • Organizacja to poziom przeznaczony do rozliczeń i zarządzania globalnego
  • Obszary robocze izolują klucze API, dostrojone modele i koszty
  • Zawsze rozdzielaj środowiska development, staging i production na osobne obszary robocze
  • Przechowuj klucze API w zmiennych środowiskowych, nigdy w kodzie
  • Panel administratora pozwala śledzić zużycie w czasie rzeczywistym dla każdego obszaru roboczego