Aliasy, nejnovější a připnuté verze
Na této stránce
Tři způsoby odkazování na model
Pole model ve tvém požadavku přijímá tři konvence pojmenování pro označení toho, co se na první pohled zdá být stejným modelem. Nejde jen o pedanterii v dokumentaci: podle toho, kterou konvenci zvolíš, bude tvoje aplikace při každém volání měsíce dostávat buď přesně stejný model, nebo verzi, která se může změnit bez upozornění. Většina nevysvětlených regresí v produkci – „naše odpovědi jsou delší, ale nikdo nic neměnil“ – pramení právě z tohoto.
Jednoduchý alias
Jednoduchý alias používá základní název modelu bez přípony:
{
"model": "grok-4.20"
}
Toto odkazuje na nejnovější stabilní verzi modelu. xAI může kdykoli aktualizovat základní verzi a ty se to dozvíš pouze monitorováním vlastních výstupů. Tato flexibilita je přesně to, co chceš během vývoje a prototypování: vždy pracuješ s nejlepší dostupnou verzí, aniž bys musel cokoli aktualizovat. Dokud iteruješ na prompotech, zkoumáš schopnosti modelu a přesná reprodukovatelnost odpovědí není podstatná, tato konvence funguje.
Alias „latest“
Alias latest odkazuje na nejpokročilejší verzi, která ještě nebyla stabilizována:
{
"model": "grok-4.20-latest"
}
To, co zde dostaneš, se může často měnit a zahrnovat změny, které jsou stále ve fázi ověřování. Je to nástroj pro evaluaci, užitečný pro testování nadcházejících verzí předtím, než se stanou výchozím aliasem, pro měření zlepšení kvality nebo výkonu a pro informovanou přípravu migrace.
Patří do testovacích prostředí, nikdy do produkce. Změna se může stát přes noc, alterovat chování tvého promptu a dostat se k uživatelům bez varování – nebudeš mít žádný commit ani ticket, na který bys svalil vinu a pochopil, co se stalo.
Připnutá verze
Připnutá verze zahrnuje v identifikátoru datum:
{
"model": "grok-4.20-0309"
}
Přípona -0309 odpovídá datu vydání, zde 9. března. Tato verze se neposouvá: dokud zůstane aktivní, model odpovídající dnes bude tím samým, který bude odpovídat za šest měsíců. Je to jediná obhajitelná volba pro produkci, a to ze čtyř pádných důvodů. Chování tvé aplikace se stane reprodukovatelným, což činí tvé integrační a regresní testy platnými z dlouhodobého hlediska. Žádné tiché aktualizace tě nemohou zastihnout nepřipraveného. Načasování migrace se stává plánovaným týmovým rozhodnutím, nikoli něčím, co se ti prostě stane. A pokud se chování přesto změní, víš, že příčina je na tvé straně.
Jedna konvence pro každé prostředí
Osvědčený postup nespočívá ve výběru mezi těmito třemi možnostmi, ale v přiřazení každé z nich jejímu prostředí:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Jednoduchý alias: nejnovější stabilní
"staging": "grok-4.20-latest", # Latest: test nových funkcí
"production": "grok-4.20-0309", # Připnutá verze: maximální stabilita
}[ENVIRONMENT]
Ber tento slovník jako systém včasného varování. Tvé stagingové prostředí běží trvale na latest: pokud nadcházející změna rozbije prompt, tvé integrační testy to zachytí dříve než tvoji uživatelé. Tvá produkce mezitím zůstává na připnuté verzi. Změny objevuješ upstream, aniž bys je kdy musel trpět downstream.
Přechod z jedné připnuté verze na další
Když se objeví nová připnutá verze – řekněme grok-4.20-0612 – přepnutí si zaslouží spíše proceduru než pouhou změnu řetězce. Nejprve nasadíš novou verzi do stagingu prostřednictvím aliasu latest, spustíš tam svou sadu testů promptů a poté porovnáš výsledky s těmi z verze aktuálně běžící v produkci. Pokud je porovnání uspokojivé, aktualizuješ produkční konfiguraci, 48 hodin monitoruješ metriky – kvalitu odpovědí, míru spokojenosti, náklady – a migraci validuješ, nebo se vrátíš k předchozí verzi.
Krok porovnání je jádrem systému a předpokládá, že jsi zachoval výstupy z verze, která byla nasazena: bez této reference se „porovnávání“ redukuje na pouhý dojem. Fáze pozorování záměrně zahrnuje náklady. Novější verze může být upovídanější, generovat více výstupních tokenů a zvýšit tvůj účet o několik procent při stejné vnímané kvalitě. Čtyřicet osm hodin obvykle stačí k tomu, aby se to projevilo, a návrat k předchozí verzi zůstává jednoduchou změnou v konfiguraci.
Klíčové poznatky
- Jednoduchý alias (
grok-4.20): nejnovější stabilní verze, pro vývoj - Alias latest (
grok-4.20-latest): verze na hraně možností, pouze pro testování - Připnutá verze (
grok-4.20-0309): neměnná, jediná doporučená volba pro produkci - Používej různé konvence pro různá prostředí (dev/staging/prod)
- Při přechodu z jedné připnuté verze na druhou plánuj strukturovaný migrační proces