Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Organisaatiot ja työtilat

Oppitunti 2 / 14 Päivitetty 29. heinäkuuta 2026 Edistynyt
Tällä sivulla
  1. Tiimisi rakentaminen AI Studiossa
  2. Organisaatio- ja työtilamalli
  3. Roolien ja käyttöoikeuksien hallinta
  4. Organisaation parhaat käytännöt
  5. Konkreettinen skenaario: asennus
  6. Keskeiset asiat

Tiimisi rakentaminen AI Studiossa

Niin kauan kuin työskentelet yksin, yksi API-avain riittää. Ongelmat alkavat heti, kun kolme kehittäjää jakaa saman tilin: kukaan ei tiedä, mikä avain pyörittää mitäkin sovellusta, lasku saapuu yhtenä selkäänsäkymättömänä kokonaisuutena, ja jos joku lähtee tiimistä, joudut peruuttamaan kaiken. AI Studio ratkaisee tämän kaksitasoisella arkkitehtuurilla: Organisaatiot ja Työtilat. Tämän rakenteen ymmärtäminen on välttämätöntä laskutuksen, käyttöoikeuksien ja resurssien eristämisen hallinnassa.

Organisaatio- ja työtilamalli

Organisaatio on hierarkian huipulla. Se luodaan automaattisesti rekisteröitymisesi yhteydessä ja se edustaa yksikköäsi – yritystä, tiimiä tai osastoa. Tässä kaikki konsolidoituu: laskutus, joka kokoaa kaikki kustannukset; tilaustason valinta (Experiment, Scale tai Enterprise); käyttörajat, eli globaalit token- ja pyyntökiintiöt; sekä jäsenten hallinta, mukaan lukien kutsut ja paikkojen hallinta. Uuden organisaation luominen vaatii vain nimen ja käyttöehtojen hyväksymisen, eikä mikään estä yhtä käyttäjää kuulumasta useampaan organisaatioon samanaikaisesti.

Työtilat ovat organisaation sisäisiä osioita, jotka on suunniteltu erottamaan käyttöoikeudet ja kustannukset projektin, tiimin tai ympäristön mukaan. Jokainen työtila eristää omat API-avaimensa, jotka myöntävät pääsyn vain sen omiin resursseihin, ja jakaa hienosäädettyjä malleja sekä koulutusaineistoja jäsentensä kesken. Kulutus on jäljitettävissä työtilakohtaisesti, joten voit sanoa tarkasti, kuinka paljon tukichatti maksaa verrattuna sisäiseen hakukoneeseen.

Roolien ja käyttöoikeuksien hallinta

Organisaatiotasolla coexistoi kolme roolia, joilla on tarkoituksellisesti erilaiset vaikutuspiirit.

RooliLaskutusJäsenetTyötilatAPI-avaimet
OwnerKylläKylläKylläKyllä
AdminEiKylläKylläKyllä
MemberEiEiRajoitettuKyllä

Muista keskimmäinen rivi: Admin hallinnoi tiimejä ja työtiloja, mutta ei koske laskutukseen. Tämä antaa sinun antaa teknisen hallinnon ML-vastaavalle antamatta heille pääsyä yrityksen luottokorttiin.

Työtilan luominen vaatii siis Admin-oikeudet. Siirry organisaatiosi Admin-sivulta:

  1. Mene kohtaan Workspaces
  2. Napsauta Create Workspace
  3. Anna sille kuvaava nimi (esimerkiksi: production, staging, research)
  4. Määritä alkuperäiset käyttöoikeudet

Yhteistyökumppanin lisääminen noudattaa samanlaista logiikkaa:

  1. Mene kohtaan Admin > Members
  2. Napsauta Invite
  3. Syötä yhteistyökumppanin sähköpostiosoite
  4. Määritä rooli (Admin, Member)
  5. Valitse työtilat, joihin heillä on pääsy

Organisaation parhaat käytännöt

Ensimmäinen sääntö on erottaa ympäristöt. Luo vähintään kaksi työtilaa, ihannetapauksessa kolme, eristääksesi kehitysvaiheen siitä, mikä koskettaa käyttäjiäsi.

Organization "MaStartup"
├── Workspace "development"    → dev API-avaimet, pienennetyt kiintiöt
├── Workspace "staging"        → integraatiotestit
└── Workspace "production"     → prod API-avaimet, suuret kiintiöt

Tämä erottelu estää perjantai-iltana kehitysvaiheessa kirjoitetun äärettömän silmukan syömästä tuotantokiintiöitä, ja se tekee kustannusten seurannasta ympäristökohtaisesti välittömästi luettavaa.

Seuraavaksi tulee avainten kierrätys. Koska jokainen avain on sidottu työtilaan, yhden korvaaminen palvelua keskeyttämättä vaatii tietyn järjestyksen: luo uusi avain kyseisessä työtilassa, ota se käyttöön sovelluksessasi, varmista, että pyynnöt kulkevat sen läpi, ja vasta sitten poista vanha. Kahden viimeisen vaiheen kääntäminen takaa katkoksen.

import os

# Paras käytäntö: API-avain ympäristömuuttujan kautta
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

Lähdekoodiin kovakoodattu avain päätyy aina Git-varastoon, sitten kyseisen varaston historiaan, jossa se selviää kaikista siivousyrityksistäsi. Käytä ympäristömuuttujaa aivan ensimmäisestä rivistä alkaen.

Suurissa organisaatioissa hallinto hyötyy myös siitä, että jokaisella toiminnallisella tiimillä – data science, backend, tuote – on oma työtilansa, plus erillinen työtila hienosäädölle, joka keskittää aineistot niiden monistamisen sijaan. Selkeät työtilojen nimet tekevät kuukausiraportoinnista huomattavasti helpompaa.

Konkreettinen skenaario: asennus

Otetaan esimerkiksi viidentoista hengen yritys, joka ottaa Mistralin käyttöön. CTO luo organisaation ja tilaa Scale-tason, avaa sitten kolme työtilaa: dev, staging ja prod. Kehittäjät saavat Member-pääsyn, joka on rajoitettu vain dev-työtilaan, kun taas ML-vastaava saa Admin-pääsyn kaikkiin kolmeen. Jokaisella työtilalla on omat API-avaimensa, eristettynä toisistaan, joten vuotanut kehitysavain ei vaaranna mitään tuotannossa.

Hallintapaneeli, joka on osoitteessa admin.mistral.ai, näyttää sitten kulutuksen työtilakohtaisesti. Tämä on taulukko, jonka CTO avaa kuukauden lopussa kohdentaakseen kustannukset projekteittain ilman, että koodiin tarvitsee lisätä mittaristoa.

Keskeiset asiat

  • Organisaatio on taso laskutukselle ja globaalille hallinnalle
  • Työtilat eristävät API-avaimet, hienosäädettyjen mallien ja kustannukset
  • Erota aina kehitys, testaus ja tuotanto erillisiin työtiloihin
  • Tallenna API-avaimet ympäristömuuttujiin, älä koskaan koodiin
  • Hallintapaneelin avulla voit seurata kulutusta työtilakohtaisesti reaaliajassa