Aliakset, uusin versio ja kiinnitetyt versiot
Tällä sivulla
Kolme tapaa viitata malliin
Pyynnön model-kenttä hyväksyy kolme nimeämiskäytäntöä määrittämään se, mikä pinnallisesti tarkasteltuna on sama malli. Kyse ei ole pelkästä dokumentaation hienosäädöstä: valitsemastasi käytännöstä riippuen sovelluksesi saa joko täsmälleen saman mallin jokaisella kutsulla kuukausien ajan, tai version, joka voi muuttua ilman erillistä ilmoitusta. Useimmat selittämättömät tuotantoympäristön regressiot – kuten “vastaukset pitenivät, vaikka kukaan ei muuttanut mitään” – johtuvat tästä.
Yksinkertainen alias
Yksinkertainen alias käyttää mallin perusnimeä ilman päätettä:
{
"model": "grok-4.20"
}
Tämä osoittaa mallin viimeisimpään vakaaseen versioon. xAI voi päivittää taustalla olevan version milloin tahansa, ja huomaat muutoksen vain seuraamalla omia tulosteitasi. Tämä joustavuus on juuri sitä, mitä tarvitset kehityksen ja prototyyppauksen aikana: työskentelet aina parhaalla saatavilla olevalla versiolla ilman, että sinun tarvitsee päivittää mitään. Niin kauan kuin iteroint prompteja, tutkit mallin ominaisuuksia etkä tarvitse täsmällistä vastausten toistettavuutta, tämä käytäntö toimii hyvin.
Uusin alias
latest-alias osoittaa edistyneimpään versioon, jota ei ole vielä vakautettu:
{
"model": "grok-4.20-latest"
}
Tässä saamasi sisältö voi muuttua usein ja sisältää edelleen validoitavia muutoksia. Se on arviointityökalu, joka soveltuu tulevien versioiden testaamiseen ennen niiden muuttumista oletusaliakseksi, laatu- tai suorituskykyhyötyjen mittaamiseen sekä migraation valmisteluun informoidusti.
Sen paikka on testiympäristöissä, ei koskaan tuotannossa. Muutos voi tapahtua yön yli, muuttaa prompttisi käyttäytymistä ja tavoittaa käyttäjäsi ilman varoitusta – sinulla ei ole commit-riviä tai tikettiä, jota syyttää ymmärtääksesi, mitä tapahtui.
Kiinnitetty versio
Kiinnitetty versio sisältää tunisteessa päivämäärän:
{
"model": "grok-4.20-0309"
}
Pääte -0309 vastaa julkaisupäivää, tässä tapauksessa 9. maaliskuuta. Tämä versio ei liiku: niin kauan kuin se on aktiivinen, tänään vastaava malli on sama kuin kuuden kuukauden kuluttua. Se on ainoa perusteltavissa oleva vaihtoehto tuotantoon neljästä painavasta syystä. Sovelluksesi käyttäytyminen muuttuu toistettavaksi, mikä tekee integraatio- ja regressiotesteistäsi päteviä pitkällä aikavälillä. Hiljaiset päivitykset eivät voi yllättää sinua. Migraation ajoitus on suunniteltu tiimipäätös, ei jotain, mikä vain tapahtuu sinulle. Ja jos käyttäytyminen muuttuu silti, tiedät syyn olevan päässäsi.
Yksi käytäntö ympäristöä kohden
Paras käytäntö ei ole valita yhden näistä kolmesta välillä, vaan osoittaa kukin omalle ympäristölleen:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Yksinkertainen alias: uusin vakaa
"staging": "grok-4.20-latest", # Uusin: testaa uudet ominaisuudet
"production": "grok-4.20-0309", # Kiinnitetty versio: maksimaalinen vakaus
}[ENVIRONMENT]
Ajattele tätä sanakirjaa varhaisvaroitusjärjestelmänä. Staging-ympäristösi pyörii pysyvästi versiolla latest: jos tuleva muutos rikkoo promptin, integraatiotestisi havaitsevat sen ennen käyttäjiäsi. Tuotantosi pysyy sillä välin kiinnitetyssä versiossa. Havaitset muutokset ylävirrassa kärsimättä niistä alavirrassa.
Siirtyminen yhdestä kiinnitetystä versiosta seuraavaan
Kun uusi kiinnitetty versio ilmestyy – esimerkiksi grok-4.20-0612 – vaihto ansaitsee menetelmän eikä pelkkää merkkijonon muuttamista. Ota ensin uusi versioon käyttöön staging-ympäristössä latest-aliaksen kautta, suorita siellä promptti-testisarjasi ja vertaa tuloksia tällä hetkellä tuotannossa olevan version tuloksiin. Jos vertailu on tyydyttävä, päivitä tuotannon konfiguraatio, seuraa mittareita 48 tunnin ajan – vastauksen laatua, tyytyväisyysastetta, kustannuksia – ja valido migraatio tai palaa edelliseen versioon.
Vertailuvaihe on järjestelmän ydin, ja se olettaa, että olet säilyttänyt paikallaan olevan version tulosteet: ilman tätä referenssiä “vertailu” pelkistyy pelkäksi vaikutelmaksi. Havainnointivaiheeseen kuuluu tarkoituksellisesti myös kustannukset. Uudempi versio voi olla puheliasmpi, tuottaa enemmän output-tokeneita ja nostaa laskuasi useilla prosenteilla yhtä hyväksi koetusta laadusta huolimatta. 48 tuntia riittää yleensä tämän havaitsemiseen, ja edelliseen versioon palaaminen on edelleen vain yksi konfiguraatiorivi.
Keskeiset asiat
- Yksinkertainen alias (
grok-4.20): uusin vakaa versio, tarkoitettu kehitykseen - Uusin alias (
grok-4.20-latest): aivan uusin versio, vain testaamiseen - Kiinnitetty versio (
grok-4.20-0309): muuttumaton, ainoa suositeltu vaihtoehto tuotantoon - Käytä eri käytäntöjä eri ympäristöissä (dev/staging/prod)
- Suunnittele strukturoitu migraatioprosessi siirtyessäsi yhdestä kiinnitetystä versiosta seuraavaan