Životní cyklus modelu
Na této stránce
Předvídání změn modelu
Tvoje produkční aplikace závisí na konkrétním ID modelu uloženém v konfiguraci. Toto ID není trvalé: přicházejí nové verze, staré se označují jako zastaralé a následně se odstraňují. Týmy, které tento časový harmonogram ignorují, zjistí problém až ve chvíli, kdy jim hromadně začnou selhávat požadavky – přestože se v jejich nasazení nic nezměnilo. Pochopení životního cyklu změní tento výpadek v plánovanou migraci.
Aktivní
Model je dostupný a doporučený pro produkční použití. Získává optimalizace a opravy.
Zastaralý (Deprecated)
Model stále funguje, ale bude odstraněn. Jakmile je toto oznámeno, naplánuj si co nejdříve migraci na nástupce.
Zastaralý (Odstraněný)
Model je z API odstraněn. Jakýkoli požadavek používající toto ID skončí chybou.
Tři stavy modelu
Aktivní model je plně funkční a představuje jediný stav, který bys měl používat v produkci. xAI může aplikovat drobné optimalizace beze změny ID: model, který dnes voláš pod tímto názvem, nemusí být bajt po bajtu totožný s modelem před třemi měsíci – tuto nuanci si prakticky rozebereme v další lekci.
Přechod do stavu zastaralý nic nerozbije. Model nadále normálně odpovídá, ale xAI oznamuje jeho budoucí odstranění. To je signál, na který jsi čekal: od tohoto oznámení máš časové okno – obvykle několik týdnů – na přípravu, otestování a nasazení přepnutí na nástupce. Tým, který sleduje oznámení o zastarávání, migruje vlastním tempem; tým, který to nedělá, migruje ve spěchu.
Stav zastaralý (odstraněný) znamená konec cesty: model je stažen a jakýkoli požadavek obsahující jeho ID selže. Neexistuje žádný automatický fallback na blízkou verzi ani žádná lhůta na dohnání. Pokud tvoje aplikace v tento den stále odkazuje na tento model, přestane fungovat.
Koncové body a jejich stav
Koncové body se řídí podobnou logikou s vlastním stavem.
| Koncový bod | Stav |
|---|---|
/v1/responses | primární koncový bod, doporučený pro všechny nové projekty |
/v1/chat/completions | zastaralý, udržovaný kvůli kompatibilitě |
/v1/images/generations | aktivní, generování obrázků |
/v1/tokenize-text | aktivní, počítání tokenů |
Případ /v1/chat/completions si zaslouží vysvětlení, protože jeho dlouhá životnost způsobuje zmatky. Jeho kompatibilita s formátem OpenAI z něj udělala přirozený vstupní bod pro všechny týmy přicházející od jiného poskytovatele: změníš základní URL a klíč a existující kód funguje. Tato výhoda má však nevýhodu – tento koncový bod již nezískává nové funkce, protože vývoj se nyní soustředí na /v1/responses. Můžeš jej nadále používat, ale každá nová schopnost tě mine.
Izolace reference na model
Veškerá obtížnost migrace se odehrává předtím, než k ní dojde, a to ve způsobu, jakým tvůj kód pojmenovává model. Pokud je natvrdo zakódován v patnácti souborech, změna ID se stává honem za pokladem s nevyhnutelnými přehlédnutími. Pokud je deklarován na jednom místě, migrace zabere minutu:
# config.py
GROK_MODEL = "grok-4.20-0309" # Pevná verze pro produkci
GROK_MODEL_FAST = "grok-build-0.1"
# Usnadňuje migraci: pouze jedno místo ke změně
Vyzkoušej si toto cvičení na vlastní kódové základně: vyhledej všechny doslovné výskyty názvu modelu. Pokud je jich více než jeden, máš technický dluh, který musíš vyrovnat před další deprecací, ne až po ní.
Proces migrace
Jakmile je tato centralizace hotová, přepnutí probíhá ve čtyřech krocích:
- Aktualizuj pole
modelve své konfiguraci - Otestuj své stávající prompty s novým modelem ve stagingovém prostředí
- Případně uprav: novější modely mohou odpovídat odlišně, s variacemi v tónu, délce nebo formátu
- Nasaď postupně: začni s procentem provozu, než přepneš úplně
Krok 3 je nejčastěji podceňován. Novější model je obecně lepší, ale „lepší“ neznamená „identický“: podrobnější odpověď rozbije kalibrovaný displej, mírně odlišný formát selže při parsování JSON, opatrnější tón změní uživatelskou zkušenost. Právě to ti umožní krok 4 s postupným nasazením odhalit na reálném provozu dříve, než to pocítí všichni tvoji uživatelé.
Klíčové poznatky
- Modely procházejí třemi stavy: Aktivní, Zastaralý a poté Zastaralý (odstraněný)
- Koncový bod
/v1/responsesje primární;/v1/chat/completionsje zastaralý a již nezískává nové funkce - Centralizuj název modelu v konfiguračním souboru pro usnadnění migrací
- Vždy otestuj své prompty s novým modelem před migrací do produkce
- Sleduj oznámení o zastarávání, abys mohl migrace plánovat s předstihem