Aliasy, najnovšie a pripnuté verzie
Na tejto strane
Tri spôsoby odkazovania na model
Pole model vo tvojej požiadavke akceptuje tri konvencie pomenovania na označenie toho, čo sa na prvý pohľad javí ako ten istý model. Nie je to len pedantstvo v dokumentácii: v závislosti od toho, ktorú konvenciu si vyberieš, bude tvoja aplikácia buď mesiace dostávať presne ten istý model, alebo verziu, ktorá sa môže zmeniť bez upozornenia. Väčšina nevysvetlených regresii v produkcii – „naše odpovede sú dlhšie, ale nikto nič nezmenil“ – pramení práve z tohto.
Jednoduchý alias
Jednoduchý alias používa základný názov modelu bez prípony:
{
"model": "grok-4.20"
}
Toto odkazuje na najnovšiu stabilnú verziu modelu. xAI môže kedykoľvek aktualizovať základnú verziu a ty sa to dozvieš len monitorovaním vlastných výstupov. Táto flexibilita je presne to, čo potrebuješ počas vývoja a prototypovania: vždy pracuješ s najlepšou dostupnou verziou bez nutnosti niečo aktualizovať. Pokiaľ iteruješ na promptoch, skúmaš schopnosti modelu a presná reprodukovateľnosť odpovedí nie je podstatná, táto konvencia funguje.
Alias „latest“
Alias latest odkazuje na najpokročilejšiu verziu, ktorá ešte nebola stabilizovaná:
{
"model": "grok-4.20-latest"
}
To, čo tu dostaneš, sa môže často meniť a zahŕňať zmeny, ktoré sú stále vo fáze validácie. Je to nástroj na evaluáciu, užitočný na testovanie nadchádzajúcich verzií skôr, než sa stanú predvoleným aliasom, na meranie zlepšení kvality alebo výkonu a na informovanú prípravu migrácie.
Patrí do testovacích prostredí, nikdy nie do produkcie. Zmena sa môže udiať cez noc, zmeniť správanie tvojho promptu a dostať sa k používateľom bez varovania – nebudeš mať žiadny commit ani ticket, na ktorý by si mohol zvaliť vinu a pochopiť, čo sa stalo.
Pripnutá verzia
Pripnutá verzia obsahuje v identifikátore dátum:
{
"model": "grok-4.20-0309"
}
Prípona -0309 zodpovedá dátumu vydania, v tomto prípade 9. marec. Táto verzia sa nepohýba: pokiaľ zostane aktívna, model odpovedajúci dnes bude ten istý, ktorý bude odpovedať o šesť mesiacov. Je to jediná obhájiteľná voľba pre produkciu, a to zo štyroch pádnych dôvodov. Správanie tvojej aplikácie sa stáva reprodukovateľným, čo robí tvoje integračné a regresné testy dlhodobo platnými. Žiadne tiché aktualizácie ťa nemôžu zaskočiť. Načasovanie migrácie sa stáva plánovaným tímovým rozhodnutím, nie niečím, čo sa ti jednoducho stane. A ak sa správanie aj tak zmení, vieš, že príčina je na tvojej strane.
Jedna konvencia na jedno prostredie
Najlepšia prax nespočíva vo výbere medzi týmito tromi možnosťami, ale v priradení každej z nich jej vlastnému prostrediu:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Jednoduchý alias: najnovšia stabilná
"staging": "grok-4.20-latest", # Latest: testovanie nových funkcií
"production": "grok-4.20-0309", # Pripnutá verzia: maximálna stabilita
}[ENVIRONMENT]
Cháp tento slovník ako systém včasného varovania. Tvoje staging prostredie beží natrvalo na latest: ak nadchádzajúca zmena pokazí prompt, tvoje integračné testy to zachytia skôr, než sa to dostane k používateľom. Tvoja produkcia medzitým zostáva na pripnutej verzii. Zmeny objavuješ upstream, nikdy však netrpíš ich dôsledkami downstream.
Prechod z jednej pripnutej verzie na ďalšiu
Keď sa objaví nová pripnutá verzia – povedzme grok-4.20-0612 – prepínanie si vyžaduje skôr procedúru než jednoduchú zmenu reťazca. Najprv nasadź novú verziu do stagingu prostredníctvom aliasu latest, spusti tam svoju sadu testov promptov a potom porovnaj výsledky s tými z verzie aktuálne bežiacej v produkcii. Ak je porovnanie uspokojivé, aktualizuj produkčnú konfiguráciu, 48 hodín monitoruj metriky – kvalitu odpovedí, mieru spokojnosti, náklady – a validuj migráciu alebo sa vráť k predchádzajúcej verzii.
Krok porovnania je jadrom celého systému a predpokladá, že si si zachoval výstupy z aktuálne nasadenej verzie: bez tejto referencie sa „porovnávanie“ redukuje na dojem. Fáza pozorovania zámerne zahŕňa aj náklady. Novšia verzia môže byť ukecanejšia, generovať viac výstupných tokenov a zvýšiť tvoju faktúru o niekoľko percent pri rovnakej vnímanej kvalite. Štyridsaťosem hodín zvyčajne stačí na to, aby sa to prejavilo, a návrat k predchádzajúcej verzii zostáva jednoduchou zmenou v konfigurácii.
Kľúčové poznatky
- Jednoduchý alias (
grok-4.20): najnovšia stabilná verzia, určená pre vývoj - Alias latest (
grok-4.20-latest): úplne najnovšia verzia, určená len na testovanie - Pripnutá verzia (
grok-4.20-0309): nemenná, jediná odporúčaná možnosť pre produkciu - Používaj rôzne konvencie pre rôzne prostredia (dev/staging/prod)
- Pri prechode z jednej pripnutej verzie na druhú plánuj štruktúrovaný proces migrácie