Aliased, viimased ja fikseeritud versioonid
Sellel lehel
Kolm viisi mudelile viitamiseks
Päringu väli model aktsepteerib mudeli tähistamiseks kolme nimekonventsiooni, mis esmapilgul viitavad samale mudelile. See ei ole pelgalt dokumentatsiooni peenutsemine: sõltuvalt valitud konventsioonist saab sinu rakendus kas iga kutsu korral kuude jooksul täpselt sama mudeli või versiooni, mis võib muutuda ilma hoiatuseta. Enamik seletamatuid tootmisveagu – „vastused muutusid pikemaks, kuigi keegi ei muutnud midagi“ – tuleneb just sellest.
Lihtne alias
Lihtne alias kasutab baasmudeli nime ilma sufiksita:
{
"model": "grok-4.20"
}
See viitab mudeli viimasele stabiilsele versioonile. xAI võib alusversiooni igal ajal uuendada ja sina saad sellest teada ainult oma väljundeid jälgides. See paindlikkus on täpselt see, mida vajad arenduse ja prototüüpimise käigus: töötad alati parima saadaoleva versiooniga, ilma et peaksid midagi uuendama. Seni kord iteratsioonid promptide kallal, uurid mudeli võimekust ja täpne vastuste reprodutseeritavus ei oma tähtsust, toimib see konventsioon suurepäraselt.
Viimase versiooni alias
Alias latest viitab kõige arenenumale versioonile, mida pole veel stabiliseeritud:
{
"model": "grok-4.20-latest"
}
Siin saadav tulemus võib sageli muutuda ja sisaldada veel valideerimisel olevaid muudatusi. See on hindamisvahend, mis on kasulik tulevaste versioonide testimiseks enne nende vaikealiaseks saamist, kvaliteedi või jõudluse paranemise mõõtmiseks ning teadliku migratsiooni ettevalmistamiseks.
See kuulub testkeskkondadesse, mitte kunagi tootmisse. Muudatus võib toimuda üleöö, muuta sinu prompti käitumist ja jõuda kasutajateni ilma hoiatuseta – sul ei ole ühtegi koodiregistri sissekannet ega piletit, millele osutada, et mõista, mis juhtus.
Fikseeritud versioon
Fikseeritud versioon sisaldab identifikaatoris kuupäeva:
{
"model": "grok-4.20-0309"
}
Sufiks -0309 vastab väljalaskekuupäevale, antud juhul 9. märtsile. See versioon ei muutu: seni kuni see on aktiivne, on mudel, mis vastab täna, sama, mis vastab ka kuue kuu pärast. See on ainus põhjendatav valik tootmiskeskkonnale neljal kaalukal põhjusel. Sinu rakenduse käitumine muutub reprodutseeritavaks, muutes sinu integratsiooni- ja regressioonitestid pikaajaliselt kehtivaks. Ükski vaikne uuendus ei saa sind üllatada. Migratsiooni ajastus muutub planeeritud meeskonna otsuseks, mitte sündmuseks, mis sinuga juhtub. Ja kui käitumine siiski muutub, tead, et põhjus on sinu poolt.
Üks konventsioon keskkonna kohta
Parim tava ei seisne mitte kolme variandi vahel valimises, vaid igaühe määramises oma keskkonda:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Lihtne alias: viimane stabiilne
"staging": "grok-4.20-latest", # Viimane: uute funktsioonide testimine
"production": "grok-4.20-0309", # Fikseeritud versioon: maksimaalne stabiilsus
}[ENVIRONMENT]
Mõtle sellele sõnastikule kui varajase hoiatamise süsteemile. Sinu ettevalmistuskeskkond (staging) töötab püsivalt versiooniga latest: kui eelseisev muudatus rikub mõne prompti, tuvastavad sinu integratsioonitestid selle enne kasutajaid. Sinu tootmiskeskkond jääb vahepeal fikseeritud versioonile. Avastad muutused ülesvoolu, kannatamata nende all allavoolu.
Ühelt fikseeritud versioonilt teise liikumine
Kui ilmub uus fikseeritud versioon – näiteks grok-4.20-0612 – väärib üleminek protseduuri, mitte lihtsalt stringi muutmist. Esiteks võta uus versioon kasutusele ettevalmistuskeskkonnas (staging) läbi aliase latest, käivita seal oma promptide testikomplekt ja võrdle tulemusi praegu tootmises oleva versiooni omadega. Kui võrdlus on rahuldav, uuenda tootmiskonfiguratsiooni, jälgi mõõdikuid 48 tundi – vastuse kvaliteet, rahulolu määr, kulud – ja kinnita migratsioon või taandu eelmisele versioonile.
Võrdlusetapp on süsteemi tuum ja see eeldab, et oled säilitanud kehtiva versiooni väljundid: ilma selle referentsita taandub „võrdlemine“ pelgale muljele. Vaatlusfaas hõlmab tahtlikult ka kulusid. Uuem versioon võib olla sõnaohtram, genereerida rohkem väljundtokeneid ja tõsta sinu arvet mitme protsendi võrra sama tajutava kvaliteedi juures. 48 tundi on tavaliselt piisav, et seda märgata, ja eelmisele versioonile naasmine jääb lihtsaks konfiguratsioonireaks.
Peamised punktid
- Lihtne alias (
grok-4.20): viimane stabiilne versioon, mõeldud arenduseks - Viimase versiooni alias (
grok-4.20-latest): kõige uuem versioon, ainult testimiseks - Fikseeritud versioon (
grok-4.20-0309): muutumatu, ainus soovitatav valik tootmiskeskkonnale - Kasuta erinevates keskkondades (dev/staging/prod) erinevaid konventsioone
- Planeeri struktureeritud migratsiooniprotsess ühelt fikseeritud versioonilt teise liikumisel