Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Ciclo di vita del modello

Lezione 12 di 14 Aggiornata il 29 luglio 2026 Avanzato
In questa pagina
  1. Anticipare le modifiche ai modelli
  2. I tre stati di un modello
  3. Endpoint e il loro stato
  4. Isolare il riferimento al modello
  5. Processo di migrazione
  6. Punti chiave

Anticipare le modifiche ai modelli

La tua applicazione in produzione dipende da un ID modello specifico memorizzato nella sua configurazione. Questo ID non è permanente: vengono lanciate nuove versioni, quelle vecchie vengono deprecate e poi rimosse. I team che ignorano questa timeline scoprono il problema il giorno in cui le loro richieste iniziano a fallire in massa, anche se nulla è cambiato nei loro deploy. Comprendere il ciclo di vita trasforma questo outage in una migrazione pianificata.

1

Attivo

Il modello è disponibile e raccomandato per l'uso in produzione. Riceve ottimizzazioni e correzioni.

2

Deprecato

Il modello funziona ancora ma verrà rimosso. Pianifica la migrazione verso il successore non appena viene annunciato.

3

Obsoleto (Rimosso)

Il modello viene rimosso dall'API. Qualsiasi richiesta che utilizza questo ID fallirà con un errore.

I tre stati di un modello

Un modello attivo è pienamente operativo ed è l’unico stato che dovresti utilizzare in produzione. xAI può applicare ottimizzazioni minori senza cambiare l’ID: il modello che chiami con questo nome oggi non è necessariamente identico byte per byte a quello di tre mesi fa, una sfumatura che la prossima lezione affronterà praticamente.

Il passaggio allo stato deprecato non rompe nulla. Il modello continua a rispondere normalmente, ma xAI annuncia la sua futura rimozione. Questo è il segnale che stavi aspettando: da questo annuncio, hai una finestra di tempo, solitamente diverse settimane, per preparare, testare e distribuire il passaggio al successore. Un team che monitora gli annunci di deprecazione migra al proprio ritmo; un team che non lo fa migra in fretta e furia.

Lo stato obsoleto è la fine della strada: il modello viene ritirato e qualsiasi richiesta che ne porta l’ID fallisce. Non c’è alcun fallback automatico a una versione vicina, né periodo di grazia. Se la tua applicazione fa ancora riferimento a questo modello in quel giorno, si ferma.

Endpoint e il loro stato

Gli endpoint seguono una logica simile, con il proprio stato.

EndpointStato
/v1/responsesendpoint primario, raccomandato per tutti i nuovi progetti
/v1/chat/completionslegacy, mantenuto per compatibilità
/v1/images/generationsattivo, generazione immagini
/v1/tokenize-textattivo, conteggio token

Il caso di /v1/chat/completions merita una spiegazione, poiché la sua longevità causa confusione. La sua compatibilità con il formato OpenAI lo ha reso il punto di ingresso naturale per tutti i team provenienti da un altro provider: cambi l’URL di base e la chiave, e il codice esistente funziona. Questo vantaggio ha un rovescio della medaglia: l’endpoint non riceve più nuove funzionalità, poiché lo sviluppo si concentra ora su /v1/responses. Puoi continuare a usarlo, ma ogni nuova capacità ti passerà accanto.

Isolare il riferimento al modello

Tutta la difficoltà di una migrazione si gioca prima che accada, nel modo in cui il tuo codice nomina il modello. Se appare hardcoded in quindici file, cambiare l’ID diventa una caccia al tesoro con inevitabili dimenticanze. Se è dichiarato in un unico posto, la migrazione richiede un minuto:

# config.py
GROK_MODEL = "grok-4.20-0309"  # Versione fissa per la produzione
GROK_MODEL_FAST = "grok-build-0.1"

# Facilita la migrazione: un solo posto da modificare

Prova questo esercizio sul tuo codebase: cerca tutte le occorrenze letterali di un nome di modello. Se il conteggio supera uno, hai un debito tecnico da saldare prima della prossima deprecazione, non dopo.

Processo di migrazione

Una volta messa in atto questa centralizzazione, il cambio segue quattro passaggi:

  1. Aggiorna il campo model nella tua configurazione
  2. Testa i tuoi prompt esistenti con il nuovo modello in un ambiente di staging
  3. Regola se necessario: i modelli più recenti possono rispondere in modo diverso, con variazioni di tono, lunghezza o formato
  4. Distribuisci gradualmente: inizia con una percentuale di traffico prima di passare completamente

Il passaggio 3 è il più sottovalutato. Un modello più recente è generalmente migliore, ma “migliore” non significa “identico”: una risposta più dettagliata rompe un display calibrato, un formato leggermente diverso fallisce il parsing JSON, un tono più cauto cambia l’esperienza utente. È proprio questo che la distribuzione graduale del passaggio 4 ti permette di rilevare sul traffico reale prima che tutti i tuoi utenti ne subiscano le conseguenze.

Punti chiave

  • I modelli attraversano tre stati: Attivo, Deprecato, poi Obsoleto (rimosso)
  • L’endpoint /v1/responses è primario; /v1/chat/completions è legacy e non riceve più nuove funzionalità
  • Centralizza il nome del modello in un file di configurazione per facilitare le migrazioni
  • Testa sempre i tuoi prompt con il nuovo modello prima di migrare in produzione
  • Monitora gli annunci di deprecazione per pianificare le migrazioni con anticipo