Aliasi, verzija Latest i fiksne verzije
Na ovoj stranici
Tri načina referenciranja modela
Polje model u tvom zahtjevu prihvaća tri konvencije imenovanja za označavanje onoga što je na prvi pogled isti model. Ovo nije samo sitničarenje u dokumentaciji: ovisno o konvenciji koju odabereš, tvoja aplikacija će ili svaki put mjesecima primati točno isti model, ili verziju podložnu promjenama bez najave. Većina neobjašnjivih regresija u produkciji—„naši su odgovori postali duži, ali nitko ništa nije mijenjao“—proizlazi upravo iz ovoga.
Jednostavni alias
Jednostavni alias koristi osnovno ime modela, bez sufiksa:
{
"model": "grok-4.20"
}
Ovo pokazuje na najnoviju stabilnu verziju modela. xAI može ažurirati temeljnu verziju u bilo kojem trenutku, a ti ćeš to saznati jedino praćenjem vlastitih izlaza. Ta fleksibilnost je upravo ono što želiš tijekom razvoja i izrade prototipova: uvijek radiš s najboljom dostupnom verzijom bez potrebe za ažuriranjem bilo čega. Sve dok iteriraš promptove, istražuješ mogućnosti modela i točna reproduktivnost odgovora nije bitna, ova konvencija funkcionira.
Alias Latest
Alias latest pokazuje na najnapredniju verziju, onu koja još nije stabilizirana:
{
"model": "grok-4.20-latest"
}
Ono što ovdje dobiješ može se često mijenjati i uključivati promjene koje su još u fazi validacije. To je alat za evaluaciju, koristan za testiranje nadolazećih verzija prije nego što postanu zadani alias, mjerenje dobitaka u kvaliteti ili performansama te informirano pripremanje migracije.
Njegovo je mjesto u testnim okruženjima, nikada u produkciji. Promjena se može dogoditi preko noći, alterirati ponašanje tvog prompta i stići do tvojih korisnika bez upozorenja—nećeš imati liniju u commitu niti ticket na koji možeš uprijeti prstom kako bi shvatio što se dogodilo.
Fiksna verzija (Pinned version)
Fiksna verzija uključuje datum u identifikatoru:
{
"model": "grok-4.20-0309"
}
Sufiks -0309 odgovara datumu izdavanja, ovdje 9. ožujka. Ova se verzija ne pomiče: dokle god ostane aktivna, model koji odgovara danas bit će isti onaj koji će odgovarati za šest mjeseci. To je jedina obranjiva opcija za produkciju, iz četiri čvrsta razloga. Ponašanje tvoje aplikacije postaje reproducibilno, čineći tvoje integracijske i regresijske testove valjanima dugoročno. Tebe ne mogu iznenaditi tiha ažuriranja. Vrijeme migracije postaje planska odluka tima, a ne nešto što ti se događa. A ako se ponašanje ipak promijeni, znaš da je uzrok na tvojoj strani.
Jedna konvencija po okruženju
Najbolja praksa nije biranje između ove tri opcije, već dodjeljivanje svake njenom okruženju:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Jednostavni alias: najnovija stabilna
"staging": "grok-4.20-latest", # Latest: testiranje novih značajki
"production": "grok-4.20-0309", # Fiksna verzija: maksimalna stabilnost
}[ENVIRONMENT]
Gledaj na ovaj rječnik kao na sustav ranog upozoravanja. Tvoj staging trajno radi na latest: ako nadolazeća promjena slomi prompt, tvoji integracijski testovi će to uhvatiti prije tvojih korisnika. Tvoja produkcija u međuvremenu ostaje na fiksnoj verziji. Promjene otkrivaš uzvodno, a da ih nikada ne trpiš nizvodno.
Prelazak s jedne fiksne verzije na drugu
Kada se pojavi nova fiksna verzija—recimo grok-4.20-0612—prebacivanje zaslužuje proceduru, a ne jednostavnu promjenu stringa. Prvo deployaj novu verziju u staging putem aliasa latest, pokreni svoj skup testova promptova tamo, a zatim usporedi rezultate s onima iz verzije koja je trenutno u produkciji. Ako je usporedba zadovoljavajuća, ažuriraj produkcijsku konfiguraciju, prati metrike 48 sati—kvalitetu odgovora, stopu zadovoljstva, troškove—i validiraj migraciju ili se vrati na prethodnu verziju.
Korak usporedbe srž je sustava, a pretpostavlja da si sačuvao izlaze verzije koja je na snazi: bez te reference, „usporedba“ se svodi na dojam. Faza promatranja namjerno uključuje troškove. Novija verzija može biti opširnija, generirati više izlaznih tokena i povećati tvoj račun za nekoliko posto uz jednaku percipiranu kvalitetu. Četrdeset osam sati obično je dovoljno da se to uoči, a povratak na prethodnu verziju ostaje jednostavna linija u konfiguraciji.
Ključne točke
- Jednostavni alias (
grok-4.20): najnovija stabilna verzija, za razvoj - Alias Latest (
grok-4.20-latest): verzija na samom rubu inovacija, samo za testiranje - Fiksna verzija (
grok-4.20-0309): nepromjenjiva, jedina preporučena opcija za produkciju - Koristi različite konvencije po okruženju (dev/staging/prod)
- Planiraj strukturirani proces migracije pri prelasku s jedne fiksne verzije na drugu