Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Organizzazioni e Workspace

Lezione 2 di 14 Aggiornata il 29 luglio 2026 Avanzato
In questa pagina
  1. Strutturare il tuo team su AI Studio
  2. Il modello Organizzazione / Workspace
  3. Gestire ruoli e autorizzazioni
  4. Best practice organizzative
  5. Scenario concreto: configurazione
  6. Punti chiave

Strutturare il tuo team su AI Studio

Finché lavori da solo, una singola chiave API è sufficiente. I problemi iniziano nel momento in cui tre sviluppatori condividono lo stesso account: nessuno sa quale chiave alimenta quale applicazione, la fattura arriva come un blocco indecifrabile e, il giorno in cui qualcuno lascia il team, devi revocare tutto. AI Studio risolve questo problema con un’architettura a due livelli: Organizzazioni e Workspace. Comprendere questa struttura è essenziale per gestire la fatturazione, le autorizzazioni e l’isolamento delle risorse.

Il modello Organizzazione / Workspace

L’Organizzazione si trova al vertice della gerarchia. Viene creata automaticamente al momento della registrazione e rappresenta la tua entità: azienda, team o dipartimento. È qui che tutto viene consolidato: la fatturazione, che aggrega tutti i costi; la selezione del piano di abbonamento (Experiment, Scale o Enterprise); i limiti di utilizzo, ovvero le quote globali di token e richieste; e l’allocazione dei membri, inclusi inviti e gestione dei posti. La creazione di una nuova organizzazione richiede solo un nome e l’accettazione dei termini di servizio; nulla impedisce a un singolo utente di appartenere a più organizzazioni contemporaneamente.

I Workspace sono sottoinsiemi all’interno di un’Organizzazione, progettati per segmentare l’accesso e i costi per progetto, team o ambiente. Ogni workspace isola le proprie chiavi API, che concedono accesso solo alle sue risorse, e condivide modelli fine-tuned e dataset di addestramento tra i suoi membri. Il consumo rimane tracciabile workspace per workspace, così puoi dire con precisione quanto costa il chatbot di supporto rispetto al motore di ricerca interno.

Gestire ruoli e autorizzazioni

Tre ruoli coesistono a livello di Organizzazione, con ambiti deliberatamente distinti.

RuoloFatturazioneMembriWorkspaceChiavi API
ProprietarioSìSìSìSì
AmministratoreNoSìSìSì
MembroNoNoLimitatoSì

Ricorda la riga centrale: un Amministratore gestisce team e workspace ma non tocca mai la fatturazione. Questo ti permette di affidare l’amministrazione tecnica a un responsabile ML senza dargli accesso alla carta di credito aziendale.

La creazione di un workspace richiede quindi le autorizzazioni di Amministratore. Dalla pagina Admin della tua organizzazione:

  1. Vai alla sezione Workspaces
  2. Clicca su Create Workspace
  3. Assegna un nome descrittivo (ad esempio: production, staging, research)
  4. Configura le autorizzazioni iniziali

L’aggiunta di un collaboratore segue una logica simile:

  1. Vai su Admin > Members
  2. Clicca su Invite
  3. Inserisci l’indirizzo email del collaboratore
  4. Assegna un ruolo (Admin, Member)
  5. Seleziona i workspace a cui avrà accesso

Best practice organizzative

La prima regola è separare gli ambienti. Crea almeno due workspace, idealmente tre, per isolare ciò che accade in sviluppo da ciò che tocca i tuoi utenti.

Organization "MaStartup"
├── Workspace "development"    → chiavi API dev, quote ridotte
├── Workspace "staging"        → test di integrazione
└── Workspace "production"     → chiavi API prod, quote elevate

Questa separazione impedisce a un loop infinito scritto di venerdì sera in sviluppo di divorare le quote di produzione e rende immediatamente leggibile il tracciamento dei costi per ambiente.

Segue poi la rotazione delle chiavi. Poiché ogni chiave è legata a un workspace, la sostituzione di una senza interrompere il servizio richiede un ordine specifico: genera la nuova chiave nel workspace pertinente, distribuiscila nella tua applicazione, verifica che le richieste passino effettivamente con essa e solo allora elimina quella vecchia. Invertire gli ultimi due passaggi garantisce un’interruzione del servizio.

import os

# Best practice: chiave API tramite variabile d'ambiente
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

Una chiave codificata direttamente nel codice sorgente finirà sempre in un repository Git, poi nella cronologia di quel repository, dove sopravviverà a tutti i tuoi tentativi di pulizia. Usa una variabile d’ambiente fin dalla prima riga.

Nelle grandi organizzazioni, la governance beneficia anche dell’avere un workspace per team funzionale: data science, backend, prodotto, più un workspace dedicato al fine-tuning che centralizza i dataset invece di lasciarli duplicare. Nomi espliciti dei workspace rendono la rendicontazione mensile molto più semplice.

Scenario concreto: configurazione

Prendiamo un’azienda di quindici persone che adotta Mistral. Il CTO crea l’Organizzazione e si abbona al piano Scale, quindi apre tre workspace: dev, staging e prod. Gli sviluppatori ricevono l’accesso come Membri limitato al workspace dev, mentre il responsabile ML ottiene l’accesso come Amministratore a tutti e tre. Ogni workspace ha le proprie chiavi API, isolate l’una dall’altra, quindi una chiave di sviluppo compromessa non mette a rischio nulla in produzione.

La dashboard di amministrazione, accessibile all’indirizzo admin.mistral.ai, mostra quindi il consumo per workspace. Questa è la tabella che il CTO aprirà a fine mese per allocare i costi per progetto, senza dover strumentare nulla nel codice.

Punti chiave

  • L’Organizzazione è il livello per la fatturazione e la gestione globale
  • I Workspace isolano chiavi API, modelli fine-tuned e costi
  • Separa sempre sviluppo, staging e produzione in workspace distinti
  • Archivia le chiavi API nelle variabili d’ambiente, mai nel codice
  • La dashboard di amministrazione ti permette di tracciare il consumo per workspace in tempo reale