Aliasuri, versiunea cea mai recentă și versiunile fixate
Pe această pagină
Trei moduri de a face referire la un model
Câmpul model din cererea dumneavoastră acceptă trei convenții de denumire pentru a desemna ceea ce, la suprafață, pare a fi același model. Aceasta nu este o simplă observație documentară: în funcție de convenția aleasă, aplicația dumneavoastră va primi fie exact același model la fiecare apel timp de luni de zile, fie o versiune susceptibilă de a se modifica fără preaviz. Majoritatea regresilor inexplicabile în producție—„răspunsurile noastre au devenit mai lungi, dar nimeni nu a schimbat nimic“—își au originea aici.
Alias simplu
Aliasul simplu utilizează numele de bază al modelului, fără un sufix:
{
"model": "grok-4.20"
}
Acesta indică cea mai recentă versiune stabilă a modelului. xAI poate actualiza versiunea subiacentă în orice moment, iar dumneavoastră veți afla acest lucru doar monitorizându-vă propriile rezultate. Această flexibilitate este exact ceea ce doriți în timpul dezvoltării și prototipării: lucrați întotdeauna cu cea mai bună versiune disponibilă fără a fi nevoit să actualizați nimic. Atâta timp cât iterați asupra prompturilor, explorați capacitățile modelului și reproductibilitatea exactă a răspunsurilor nu contează, această convenție funcționează.
Aliasul „latest“ (cel mai recent)
Aliasul latest indică cea mai avansată versiune, una care nu a fost încă stabilizată:
{
"model": "grok-4.20-latest"
}
Ceea ce obțineți aici se poate schimba frecvent și poate include modificări aflate încă în proces de validare. Este un instrument de evaluare, util pentru testarea versiunilor viitoare înainte ca acestea să devină aliasul implicit, măsurarea câștigurilor de calitate sau performanță și pregătirea migrării dumneavoastră în cunoștință de cauză.
Acesta își are locul în mediile de testare, niciodată în producție. O modificare poate surveni peste noapte, poate altera comportamentul promptului dumneavoastră și poate ajunge la utilizatorii dumneavoastră fără avertisment—nu veți avea o linie de commit sau un tichet pe care să dați vina pentru a înțelege ce s-a întâmplat.
Versiune fixată (Pinned version)
O versiune fixată include o dată în identificator:
{
"model": "grok-4.20-0309"
}
Sufixul -0309 corespunde datei de lansare, aici 9 martie. Această versiune nu se modifică: atâta timp cât rămâne activă, modelul care răspunde astăzi va fi cel care răspunde și peste șase luni. Este singura opțiune defensabilă pentru producție, din patru motive solide. Comportamentul aplicației dumneavoastră devine reproductibil, făcând testele de integrare și de regresie valide pe termen lung. Nicio actualizare silențioasă nu vă poate lua prin surprindere. Calendarul migrării devine o decizie planificată a echipei, nu ceva ce vi se întâmplă. Și dacă comportamentul se modifică oricum, știți că cauza se află la dumneavoastră.
O convenție per mediu
Cea mai bună practică nu constă în alegerea uneia dintre cele trei, ci în atribuirea fiecăreia mediului său corespunzător:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Alias simplu: cea mai recentă versiune stabilă
"staging": "grok-4.20-latest", # Latest: testarea noilor funcționalități
"production": "grok-4.20-0309", # Versiune fixată: stabilitate maximă
}[ENVIRONMENT]
Considerați acest dicționar ca pe un sistem de avertizare timpurie. Mediul dumneavoastră de staging rulează permanent pe latest: dacă o modificare viitoare strică un prompt, testele de integrare îl detectează înainte ca utilizatorii dumneavoastră să o facă. Între timp, producția rămâne pe o versiune fixată. Descoperiți modificările în amonte fără a le suferi vreodată în aval.
Trecerea de la o versiune fixată la alta
Când apare o nouă versiune fixată—să zicem grok-4.20-0612—trecerea la aceasta merită o procedură, nu o simplă modificare de șir de caractere. Mai întâi, implementați noua versiune în staging prin aliasul latest, rulați acolo suita de teste pentru prompturi, apoi comparați rezultatele cu cele ale versiunii aflate actualmente în producție. Dacă comparația este satisfăcătoare, actualizați configurația de producție, monitorizați metricile timp de 48 de ore—calitatea răspunsului, rata de satisfacție, costul—și validați migrarea sau reveniți la versiunea anterioară.
Pasul de comparare este nucleul sistemului, iar acesta presupune că ați păstrat rezultatele generate de versiunea existentă: fără această referință, „compararea“ se reduce la o simplă impresie. Faza de observație include în mod deliberat costul. O versiune mai nouă ar putea fi mai verbose, ar putea genera mai mulți tokeni de ieșire și ar putea vă crește factura cu câteva procente pentru o calitate percepută egală. Patruzeci și opt de ore sunt de obicei suficiente pentru a observa acest lucru, iar revenirea la versiunea anterioară rămâne o simplă linie de configurare.
Puncte cheie
- Alias simplu (
grok-4.20): cea mai recentă versiune stabilă, pentru dezvoltare - Aliasul latest (
grok-4.20-latest): versiune de ultimă oră, doar pentru testare - Versiune fixată (
grok-4.20-0309): imuabilă, singura opțiune recomandată pentru producție - Utilizați convenții diferite per mediu (dev/staging/prod)
- Planificați un proces de migrare structurat atunci când treceți de la o versiune fixată la alta