Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Mudeli elutsükkel

Õppetund 12 / 14 Värskendatud 29. juuli 2026 Edasijõudnutele
Sellel lehel
  1. Mudeli muutuste ettenägemine
  2. Mudeli kolm olekut
  3. Lõpp-punktid ja nende olek
  4. Mudeli viite eraldamine
  5. Migratsiooniprotsess
  6. Peamised punktid

Mudeli muutuste ettenägemine

Sinu tootmiskeskkonna rakendus sõltub konfiguratsioonis salvestatud kindlast mudeli ID-st. See ID ei ole igavene: käiku lastakse uusi versioone, vanad tunnistatakse iganenuks ja seejärel eemaldatakse. Meeskonnad, kes seda ajakava eiravad, avastavad probleemi alles päeval, mil nende päringud hakkavad massiliselt nurjuma – kuigi nende kasutuselevõttudes pole midagi muutunud. Elutsükli mõistmine muudab selle seisaku planeeritud migratsiooniks.

1

Aktiivne

Mudel on saadaval ja soovitatud tootmiskeskkonnas kasutamiseks. See saab optimeeringuid ja parandusi.

2

Iganenud

Mudel töötab endiselt, kuid see eemaldatakse. Planeeri üleminek järeltulijale niipea, kui sellest teatatakse.

3

Aegunud (eemaldatud)

Mudel on API-st eemaldatud. Igasugune seda ID-d kasutav päring nurjub veatega.

Mudeli kolm olekut

Aktiivne mudel on täielikult töökorras ja see on ainus olek, mida peaksid tootmiskeskkonnas kasutama. xAI võib rakendada väiksemaid optimeeringuid ilma ID-d muutmata: mudel, mida selle nime all täna kutsub, ei ole tingimata bait-baidi täpsusega identne sellega, mis oli kasutusel kolm kuud tagasi – nüanss, mida järgmises õppetükis praktiliselt käsitletakse.

Üleminek iganenud olekusse midagi ei katkesta. Mudel vastab jätkuvalt normaalselt, kuid xAI teatab selle tulevase eemaldamise kohta. See on signaal, mida oled oodanud: alates sellest teatest on sul aken – tavaliselt mitu nädalat –, et ette valmistada, testida ja kasutusele võtta üleminek järeltulijale. Meeskond, kes jälgib iganemisteateid, viib migratsiooni läbi oma tempos; meeskond, kes seda ei tee, peab ruttama.

Aegunud olek on tee lõpp: mudel on kõrvaldatud ja iga selle ID-d sisaldav päring nurjub. Automaatset varuvarianti lähedasele versioonile ega graatsiaperioodi ei ole. Kui sinu rakendus viitab sellel päeval endiselt sellele mudelile, siis see peatub.

Lõpp-punktid ja nende olek

Lõpp-punktid järgivad sarnast loogikat, omades omaenda olekut.

Lõpp-punktOlek
/v1/responsespeamine lõpp-punkt, soovitatud kõigile uutele projektidele
/v1/chat/completionspärandvara, hooldatud ühilduvuse tagamiseks
/v1/images/generationsaktiivne, piltide genereerimine
/v1/tokenize-textaktiivne, tokenite lugemine

Juhtum /v1/chat/completions väärib selgitust, kuna selle pikk eluiga tekitab segadust. Ühilduvus OpenAI vorminguga tegi sellest loomuliku sisenemispunkti kõigile meeskondadele, kes tulid teiselt teenusepakkujalt: muudad baas-URL-i ja võtit ning olemasolev kood töötab. Sellel eelisel on aga varjukülg – see lõpp-punkt ei saa enam uusi funktsioone, kuna arendus keskendub nüüd punktile /v1/responses. Saad seda jätkuvalt kasutada, kuid iga uus võimalus läheb sinust mööda.

Mudeli viite eraldamine

Kogu migratsiooni raskus avaldub enne selle toimumist selles, kuidas sinu kood mudelit nimetab. Kui see on kodeeritud viieteistkümnesse faili, muutub ID muutmine aardejahiks, mille käigus jääb paratamatult midagi tähelepanuta. Kui see on deklareeritud ühes kohas, võtab migratsioon aega minuti:

# config.py
GROK_MODEL = "grok-4.20-0309"  # Fikseeritud versioon tootmiskeskkonnale
GROK_MODEL_FAST = "grok-build-0.1"

# Lihtsustab migratsiooni: muuta tuleb ainult ühte kohta

Proovi seda harjutust oma koodibaasiga: otsi üles kõik mudeli nime sõnasõnalised esinemised. Kui arv on suurem kui üks, on sul tehnilist võlga, mis tuleb lahendada enne järgmist iganemist, mitte pärast seda.

Migratsiooniprotsess

Kui see tsentraliseerimine on paigas, järgib üleminek nelja sammu:

  1. Uuenda välja model oma konfiguratsioonis

  2. Testi olemasolevaid vihjeid uue mudeliga testkeskkonnas

  3. Kohanda vajadusel: uuemad mudelid võivad reageerida erinevalt, varieerudes tooni, pikkuse või vormingu poolest

  4. Kasuta järkjärgulist kasutuselevõttu: alusta liikluse protsendiga enne täielikku üleminekut

  5. samm on kõige alahinnatum. Uuem mudel on üldiselt parem, kuid „parem“ ei tähenda „identset“: üksikasjalikum vastus rikub kalibreeritud kuva, veidi erinev vorming nurjab JSON-i parsimise, ettevaatlikum toon muudab kasutajakogemust. Just seda võimaldabki 4. sammu järkjärguline kasutuselevõtt tuvastada reaalsel liiklusel enne, kui kõik sinu kasutajad seda kannatavad.

Peamised punktid

  • Mudelid läbivad kolm olekut: Aktiivne, Iganenud ja seejärel Aegunud (eemaldatud)
  • Lõpp-punkt /v1/responses on peamine; /v1/chat/completions on pärandvara ja ei saa enam uusi funktsioone
  • Tsentraliseeri mudeli nimi konfiguratsioonifaili, et hõlbustada migratsioone
  • Testi alati oma vihjeid uue mudeliga enne tootmiskeskkonda üleminekut
  • Jälgi iganemisteateid, et planeerida oma migratsioone õigeaegselt