Alias, versione Latest e versioni bloccate
In questa pagina
Tre modi per riferirsi a un modello
Il campo model della tua richiesta accetta tre convenzioni di denominazione per indicare quello che, in superficie, è lo stesso modello. Non si tratta di pignoleria documentale: a seconda della convenzione scelta, la tua applicazione riceverà o esattamente lo stesso modello per mesi, o una versione soggetta a modifiche senza preavviso. La maggior parte delle regressioni in produzione inspiegabili—«le nostre risposte sono diventate più lunghe, ma nessuno ha cambiato nulla»—deriva da questo.
Alias semplice
L’alias semplice utilizza il nome base del modello, senza suffisso:
{
"model": "grok-4.20"
}
Questo punta all’ultima versione stabile del modello. xAI può aggiornare la versione sottostante in qualsiasi momento e lo scoprirai solo monitorando i tuoi output. Questa flessibilità è esattamente ciò che desideri durante lo sviluppo e la prototipazione: lavori sempre con la migliore versione disponibile senza dover aggiornare nulla. Finché stai iterando sui prompt, esplorando le capacità del modello e la riproducibilità esatta delle risposte non conta, questa convenzione funziona.
Alias Latest
L’alias latest punta alla versione più avanzata, una che non è ancora stata stabilizzata:
{
"model": "grok-4.20-latest"
}
Ciò che ottieni qui può cambiare frequentemente e includere modifiche ancora in fase di validazione. È uno strumento di valutazione, utile per testare le versioni future prima che diventino l’alias predefinito, misurare guadagni di qualità o prestazioni e preparare la tua migrazione in modo informato.
Appartiene agli ambienti di test, mai alla produzione. Una modifica può avvenire da un giorno all’altro, alterare il comportamento del tuo prompt e raggiungere i tuoi utenti senza preavviso: non avrai una riga di commit o un ticket da incolpare per capire cosa è successo.
Versione bloccata (Pinned)
Una versione bloccata include una data nell’identificatore:
{
"model": "grok-4.20-0309"
}
Il suffisso -0309 corrisponde alla data di rilascio, qui il 9 marzo. Questa versione non si sposta: finché rimane attiva, il modello che risponde oggi sarà quello che risponderà tra sei mesi. È l’unica opzione difendibile per la produzione, per quattro solide ragioni. Il comportamento della tua applicazione diventa riproducibile, rendendo validi a lungo termine i tuoi test di integrazione e di regressione. Nessun aggiornamento silenzioso può coglierti di sorpresa. La tempistica della migrazione diventa una decisione pianificata del team, non qualcosa che ti capita. E se il comportamento cambia comunque, sai che la causa risiede nel tuo lato.
Una convenzione per ambiente
La best practice non consiste nello scegliere tra le tre, ma nell’assegnare ciascuna al proprio ambiente:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Alias semplice: ultima stabile
"staging": "grok-4.20-latest", # Latest: test nuove funzionalità
"production": "grok-4.20-0309", # Versione bloccata: massima stabilità
}[ENVIRONMENT]
Considera questo dizionario come un sistema di allerta precoce. Il tuo staging gira permanentemente su latest: se una modifica futura rompe un prompt, i tuoi test di integrazione lo rilevano prima che lo facciano i tuoi utenti. La tua produzione rimane nel frattempo su una versione bloccata. Scopri le modifiche a monte senza mai subirle a valle.
Passare da una versione bloccata alla successiva
Quando appare una nuova versione bloccata—diciamo grok-4.20-0612—il passaggio merita una procedura piuttosto che un semplice cambio di stringa. Prima distribuisci la nuova versione nello staging tramite l’alias latest, esegui lì la tua suite di test dei prompt, quindi confronta i risultati con quelli della versione attualmente in produzione. Se il confronto è soddisfacente, aggiorna la configurazione di produzione, monitora le metriche per 48 ore—qualità della risposta, tasso di soddisfazione, costo—e valida la migrazione o torna alla versione precedente.
Il passo del confronto è il cuore del sistema e presuppone che tu abbia conservato gli output della versione in essere: senza questo riferimento, «confrontare» si riduce a un’impressione. La fase di osservazione include deliberatamente il costo. Una versione più recente potrebbe essere più verbosa, generare più token di output e aumentare la tua fattura di diverse percentuali a parità di qualità percepita. Quarantotto ore sono solitamente sufficienti per vederlo, e il ritorno alla versione precedente rimane una semplice riga di configurazione.
Punti chiave
- Alias semplice (
grok-4.20): ultima versione stabile, per lo sviluppo - Alias Latest (
grok-4.20-latest): versione all’avanguardia, solo per test - Versione bloccata (
grok-4.20-0309): immutabile, l’unica opzione raccomandata per la produzione - Usa convenzioni diverse per ambiente (dev/staging/prod)
- Pianifica un processo di migrazione strutturato quando passi da una versione bloccata alla successiva