Slapyvardžiai, naujausios ir pritvirtintos versijos
Šiame puslapyje
Trys modelio nurodymo būdai
Tavo užklausos laukas model priima tris pavadinimų konvencijas, kuriomis nurodomas iš pirmo žvilgsnio tas pats modelis. Tai ne tik dokumentacijos smulkmena: priklausomai nuo pasirinktos konvencijos, tavo programa kiekvieno kvietimo metu gaus arba tą patį modelį mėnesių mėnesius, arba versiją, kuri gali pasikeisti be įspėjimo. Dauguma nepaaiškinamų gamybos regresijų – „atsakymai tapo ilgesni, bet niekas nieko nekeitė“ – kyla būtent dėl šios priežasties.
Paprastas slapyvardis
Paprastas slapyvardis naudoja bazinį modelio pavadinimą be jokios priesagos:
{
"model": "grok-4.20"
}
Tai nukreipia į naujausią stabilią modelio versiją. xAI gali bet kada atnaujinti pagrindinę versiją, ir tu apie tai sužinosi tik stebėdamas savo išvestis. Šis lankstumas yra būtent tai, ko tau reikia kūrimo ir prototipų etapuose: visada dirbi su geriausia turima versija nieko neatnaujindamas. Kol iteruoji promptus, tyrinėji modelio galimybes ir tikslus atsakymų atkuriamumas nėra svarbus, ši konvencija puikiai tinka.
Naujausias slapyvardis
Slapyvardis latest nukreipia į pažangiausią versiją, kuri dar nėra stabilizuota:
{
"model": "grok-4.20-latest"
}
Čia gaunamas rezultatas gali dažnai keistis ir apimti pokyčius, kurie vis dar tikrinami. Tai įvertinimo įrankis, naudingas testuojant būsimas versijas prieš joms tampant numatytuoju slapyvardžiu, matuojant kokybės ar našumo pagerėjimą ir ruošiantis informuotai migracijai.
Jam vieta tik testavimo aplinkose, niekada – gamyboje. Pokytis gali įvykti per vieną naktį, pakeisti tavo prompto elgseną ir pasiekti vartotojus be įspėjimo – neturėsi nei commit įrašo, nei užduoties, kuria galėtum remtis norėdamas suprasti, kas nutiko.
Pritvirtinta versija
Pritvirtinta versija identifikatoriuje turi datą:
{
"model": "grok-4.20-0309"
}
Priesaga -0309 atitinka išleidimo datą, šiuo atveju – kovo 9 d. Ši versija nejuda: kol ji lieka aktyvi, modelis, atsakantis šiandien, bus tas pats, kuris atsakys ir po šešių mėnesių. Tai vienintelis pateisinamas pasirinkimas gamybai, ir tam yra keturios tvirtos priežastys. Tavo programos elgsena tampa atkuriama, todėl tavo integracijos ir regresijos testai išlieka validūs ilgalaikėje perspektyvoje. Jokie tyliniai atnaujinimai tavęs nepagaus netikėtai. Migracijos laikas tampa suplanuotu komandos sprendimu, o ne įvykiu, kuris tau tiesiog nutinka. Ir jei elgsena visgi pasikeičia, žinai, kad priežastis slypi tavo pusėje.
Po vieną konvenciją kiekvienai aplinkai
Geriausia praktika – ne rinktis vieną iš trijų, o kiekvieną priskirti konkrečiai aplinkai:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Paprastas slapyvardis: naujausia stabili
"staging": "grok-4.20-latest", # Naujausias: testuoti naujas funkcijas
"production": "grok-4.20-0309", # Pritvirtinta versija: maksimalus stabilumas
}[ENVIRONMENT]
Įsivaizduok šį žodyną kaip ankstyvojo perspėjimo sistemą. Tavo „staging“ aplinka nuolat veikia su latest: jei būsimas pokytis sugadina promptą, tavo integracijos testai tai aptiks dar prieš tai pajuntant vartotojams. Tuo tarpu tavo gamyba lieka pritvirtintoje versijoje. Pokyčius aukštesniame lygmenyje atrandi niekada jų nepatirdamas pas vartotojus.
Perėjimas nuo vienos pritvirtintos versijos prie kitos
Kai pasirodo nauja pritvirtinta versija – pavyzdžiui, grok-4.20-0612 – perjungimas reikalauja procedūros, o ne paprasto eilutės pakeitimo. Pirmiausia dieg naują versiją į „staging“ aplinką naudodamas naujausią slapyvardį, ten paleisk savo promptų testų rinkinį ir palygink rezultatus su dabar gamyboje naudojamos versijos rezultatais. Jei palyginimas tenkina, atnaujink gamybos konfigūraciją, 48 valandas stebėk metrikas – atsakymų kokybę, pasitenkinimo rodiklį, kainą – ir patvirtink migraciją arba grįžk prie ankstesnės versijos.
Palyginimo žingsnis yra visos sistemos šerdis, ir jis daro prielaidą, kad esi išsaugojęs esamos versijos išvestis: be šios nuorodos „palyginimas“ virsta tiesiog įspūdžiu. Stebėjimo fazėje sąmoningai įtraukiama ir kaina. Naujesnė versija gali būti išsamesnė, sugeneruoti daugiau išvesties tokenų ir padidinti tavo sąskaitą keliais procentais, net jei suvokiama kokybė lieka tokia pati. Keturių dešimt keturių valandų paprastai pakanka tai pastebėti, o grįžimas prie ankstesnės versijos lieka paprastu konfigūracijos eilutės pakeitimu.
Svarbiausi punktai
- Paprastas slapyvardis (
grok-4.20): naujausia stabili versija, skirta kūrimui - Naujausias slapyvardis (
grok-4.20-latest): pati naujausia versija, skirta tik testavimui - Pritvirtinta versija (
grok-4.20-0309): nekintama, vienintelė rekomenduojama opcija gamybai - Naudok skirtingas konvencijas skirtingoms aplinkoms (dev/staging/prod)
- Planuok struktūruotą migracijos procesą pereinant nuo vienos pritvirtintos versijos prie kitos