Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Mallin elinkaari

Oppitunti 12 / 14 Päivitetty 29. heinäkuuta 2026 Edistynyt
Tällä sivulla
  1. Mallimuutosten ennakointi
  2. Mallin kolme tilaa
  3. Päätepisteet ja niiden tila
  4. Malliviitteen eristäminen
  5. Migraatioprosessi
  6. Keskeiset asiat

Mallimuutosten ennakointi

Tuotantoympäristön sovelluksesi riippuu määrityksistään löytyvästä tietystä mallitunnisteesta. Tämä tunniste ei ole pysyvä: uusia versioita julkaistaan, vanhoja poistetaan käytöstä ja lopulta ne poistetaan kokonaan. Tiimit, jotka jättävät tämän aikataulun huomiotta, kohtaavat ongelman vasta sinä päivänä, kun niiden pyynnöt alkavat epäonnistua massiivisesti – vaikka mikään ei olisi muuttunut niiden käyttöönotoissa. Elinkaaren ymmärtäminen muuttaa tämän katkoksen suunnitelluksi migraatioksi.

1

Aktiivinen

Malli on saatavilla ja sitä suositellaan käytettäväksi tuotannossa. Siihen tehdään optimointeja ja korjauksia.

2

Poistettu käytöstä

Malli toimii edelleen, mutta se tullaan poistamaan. Suunnittele siirtyminen seuraajaan heti, kun tästä ilmoitetaan.

3

Vanhentunut (poistettu)

Malli on poistettu rajapinnasta. Mikä tahansa tätä tunnista käyttävä pyyntö epäonnistuu virheellä.

Mallin kolme tilaa

Aktiivinen malli on täysin toimintakykyinen, ja tämä on ainoa tila, jota sinun pitäisi käyttää tuotannossa. xAI voi tehdä pieniä optimointeja muuttamatta tunnista: malli, jota kutsut tällä nimellä tänään, ei välttämättä ole tavu tavulta identtinen kolme kuukautta sitten olleen kanssa – tämä vivahde käsitellään käytännössä seuraavassa oppitunnissa.

Siirtyminen käytöstä poistettuun tilaan ei riko mitään. Malli vastaa edelleen normaalisti, mutta xAI ilmoittaa sen tulevasta poistamisesta. Tämä on odottamasi signaali: tästä ilmoituksesta alkaen sinulla on aikaa – yleensä useita viikkoja – valmistautua, testata ja ottaa käyttöön siirtyminen seuraajaan. Tiimi, joka seuraa käytöstäpoistoilmoituksia, migroi omassa tahdissaan; tiimi, joka ei seuraa, joutuu migroimaan kiireessä.

Vanhentunut tila on tien pää: malli on vedetty pois, ja mikä tahansa sen tunnista sisältävä pyyntö epäonnistuu. Automaattista paluuta lähiversioon ei ole, eikä armeliaisuusaikaa myönnetä. Jos sovelluksesi viittaa edelleen tähän mallina sinä päivänä, se lakkaa toimimasta.

Päätepisteet ja niiden tila

Päätepisteet noudattavat samanlaista logiikkaa omilla tiloillaan.

PäätepisteTila
/v1/responsesensisijainen päätepiste, suositeltu kaikkiin uusiin projekteihin
/v1/chat/completionsvanhentunut, ylläpidetty yhteensopivuuden vuoksi
/v1/images/generationsaktiivinen, kuvien generointi
/v1/tokenize-textaktiivinen, tokenien laskenta

Tapaus /v1/chat/completions ansaitsee selityksen, sillä sen pitkäikäisyys aiheuttaa sekaannusta. Sen yhteensopivuus OpenAI-muodon kanssa teki siitä luontevan sisäänmenopisteen kaikille muulta tarjoajalta tuleville tiimeille: vaihdat perus-URL-osoitteen ja avaimen, ja olemassa oleva koodi toimii. Tällä edulla on kuitenkin kääntöpuolensa – päätepiste ei enää saa uusia ominaisuuksia, sillä kehitys keskittyy nyt kohteeseen /v1/responses. Voit jatkaa sen käyttöä, mutta jokainen uusi ominaisuus ohittaa sinut.

Malliviitteen eristäminen

Kaikki migraation vaikeus piilee sen toteuttamista edeltävässä vaiheessa, siinä, kuinka koodisi nimeää mallin. Jos se esiintyy kovakoodattuna viidessätoista eri tiedostossa, tunnisteen muuttamisesta tulee väistämättömiä laiminlyöntejä sisältävä aarteenetsintä. Jos se on määritelty yhteen paikkaan, migraatio vie minuutin:

# config.py
GROK_MODEL = "grok-4.20-0309"  # Kiinteä versio tuotantoon
GROK_MODEL_FAST = "grok-build-0.1"

# Helpottaa migraatiota: vain yksi paikka muokattavaksi

Kokeile tätä harjoitusta omassa koodikannassasi: etsi kaikki mallinimen kirjaimelliset esiintymät. Jos määrä ylittää yhden, sinulla on teknistä velkaa, joka on hoidettava ennen seuraavaa käytöstäpoistoa, ei sen jälkeen.

Migraatioprosessi

Kun tämä keskittäminen on tehty, vaihto etenee neljässä vaiheessa:

  1. Päivitä model-kenttä määrityksissäsi
  2. Testaa olemassa olevat kehotteet uudella mallilla testiympäristössä
  3. Säädä tarvittaessa: uudemmat mallit voivat vastata eri tavalla, ja niissä voi olla vaihtelua sävyssä, pituudessa tai muodossa
  4. Ota käyttöön vähitellen: aloita pienellä osuudella liikenteestä ennen täydellistä vaihtoa

Vaihe 3 on aliarvioituin. Uudempi malli on yleensä parempi, mutta “parempi” ei tarkoita “identtistä”: yksityiskohtaisempi vastaus rikkoo kalibroidun näkymän, hieman erilainen muotoilu epäonnistuu JSON-jäsennyksessä, varovaisempi sävy muuttaa käyttäjäkokemusta. Juuri tämä vaiheen 4 vähittäinen käyttöönotto mahdollistaa havaitsemisen todellisessa liikenteessä ennen kuin kaikki käyttäjäsi kärsivät siitä.

Keskeiset asiat

  • Mallit käyvät läpi kolme tilaa: Aktiivinen, Poistettu käytöstä ja sen jälkeen Vanhentunut (poistettu)
  • Päätepiste /v1/responses on ensisijainen; /v1/chat/completions on vanhentunut eikä saa enää uusia ominaisuuksia
  • Keskitä mallin nimi määritystiedostoon migraatioiden helpottamiseksi
  • Testaa kehotteet aina uudella mallilla ennen tuotantoon siirtymistä
  • Seuraa käytöstäpoistoilmoituksia suunnitellaksesi migraatiot ajoissa