Aliasy, wersja najnowsza i wersje przypięte
Na tej stronie
Trzy sposoby odwoływania się do modelu
Pole model w Twoim żądaniu akceptuje trzy konwencje nazewnictwa, które wskazują ten sam model na pierwszy rzut oka. To nie jest czepianie się dokumentacji: w zależności od wybranej konwencji, Twoja aplikacja otrzyma albo dokładnie ten sam model przy każdym wywołaniu przez miesiące, albo wersję podatną na zmiany bez powiadomienia. Większość niewyjaśnionych regresji w środowisku produkcyjnym – „nasze odpowiedzi stały się dłuższe, ale nikt nic nie zmieniał“ – wynika właśnie z tego.
Prosty alias
Prosty alias używa podstawowej nazwy modelu, bez sufiksu:
{
"model": "grok-4.20"
}
Wskazuje on na najnowszą stabilną wersję modelu. xAI może zaktualizować wersję bazową w dowolnym momencie, a dowiesz się o tym tylko poprzez monitorowanie własnych wyników. Ta elastyczność jest dokładnie tym, czego potrzebujesz podczas rozwoju i prototypowania: zawsze pracujesz z najlepszą dostępną wersją bez konieczności aktualizacji czegokolwiek. Dopóki iterujesz nad promptami, badasz możliwości modelu, a dokładna powtarzalność odpowiedzi nie ma znaczenia, ta konwencja sprawdza się idealnie.
Alias „latest“
Alias latest wskazuje na najbardziej zaawansowaną wersję, która nie została jeszcze ustabilizowana:
{
"model": "grok-4.20-latest"
}
To, co tutaj otrzymujesz, może zmieniać się często i zawierać zmiany będące wciąż w trakcie walidacji. Jest to narzędzie ewaluacyjne, przydatne do testowania nadchodzących wersji, zanim staną się domyślnym aliasem, mierzenia wzrostu jakości lub wydajności oraz przygotowania świadomej migracji.
Miejsce tego aliasu jest w środowiskach testowych, nigdy w produkcyjnych. Zmiana może nastąpić z dnia na dzień, zmienić zachowanie Twojego promptu i dotrzeć do użytkowników bez ostrzeżenia – nie będziesz mieć linii w commitcie ani zgłoszenia, które pomogłyby zrozumieć, co się stało.
Wersja przypięta
Wersja przypięta zawiera datę w identyfikatorze:
{
"model": "grok-4.20-0309"
}
Sufiks -0309 odpowiada dacie wydania, w tym przypadku 9 marca. Ta wersja się nie zmienia: dopóki pozostaje aktywna, model odpowiadający dziś będzie tym samym modelem odpowiadającym za sześć miesięcy. To jedyna obronna opcja dla środowiska produkcyjnego z czterech solidnych powodów. Zachowanie Twojej aplikacji staje się powtarzalne, co sprawia, że Twoje testy integracyjne i regresyjne są ważne długoterminowo. Żadne ciche aktualizacje nie zaskoczą Cię. Termin migracji staje się zaplanowaną decyzją zespołu, a nie czymś, co Ci się przydarza. A jeśli zachowanie się zmieni, wiesz, że przyczyna leży po Twojej stronie.
Jedna konwencja na środowisko
Najlepszą praktyką nie jest wybór jednej z trzech opcji, lecz przypisanie każdej z nich do odpowiedniego środowiska:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Prosty alias: najnowsza stabilna
"staging": "grok-4.20-latest", # Latest: testowanie nowych funkcji
"production": "grok-4.20-0309", # Wersja przypięta: maksymalna stabilność
}[ENVIRONMENT]
Traktuj ten słownik jak system wczesnego ostrzegania. Twoje środowisko staging działa permanentnie na latest: jeśli nadchodząca zmiana zepsuje prompt, Twoje testy integracyjne wykryją to, zanim zrobią to użytkownicy. Produkcja w tym czasie pozostaje na wersji przypiętej. Wykrywasz zmiany u źródła, nigdy nie cierpiąc z ich powodu na końcu łańcucha.
Przejście z jednej wersji przypiętej do drugiej
Gdy pojawi się nowa wersja przypięta – powiedzmy grok-4.20-0612 – przełączanie się wymaga procedury, a nie tylko zmiany ciągu znaków. Najpierw wdróż nową wersję na stagingu poprzez alias latest, uruchom tam swój zestaw testów promptów, a następnie porównaj wyniki z tymi z wersji obecnie znajdującej się w produkcji. Jeśli porównanie wypadnie zadowalająco, zaktualizuj konfigurację produkcyjną, monitoruj metryki przez 48 godzin – jakość odpowiedzi, wskaźnik satysfakcji, koszt – i zatwierdź migrację lub przywróć poprzednią wersję.
Krok porównawczy jest sednem tego systemu i zakłada, że zachowałeś wyniki działania wersji będącej w użyciu: bez tego odniesienia „porównywanie“ sprowadza się do wrażenia. Faza obserwacji celowo obejmuje koszt. Nowsza wersja może być bardziej rozwlekła, generować więcej tokenów wyjściowych i zwiększyć Twój rachunek o kilka procent przy tej samej postrzeganej jakości. Czterdzieści osiem godzin zazwyczaj wystarcza, aby to zauważyć, a powrót do poprzedniej wersji pozostaje kwestią jednej linii w konfiguracji.
Kluczowe wnioski
- Prosty alias (
grok-4.20): najnowsza stabilna wersja, do rozwoju - Alias latest (
grok-4.20-latest): wersja eksperymentalna, tylko do testów - Wersja przypięta (
grok-4.20-0309): niezmienna, jedyna zalecana opcja dla produkcji - Używaj różnych konwencji dla różnych środowisk (dev/staging/prod)
- Zaplanuj ustrukturyzowany proces migracji przy przechodzeniu z jednej wersji przypiętej do drugiej