Псевдоними, най-нови и фиксирани версии
На тази страница
Три начина за препращане към модел
Полето model във Вашата заявка приема три конвенции за именуване, които обозначават на пръв поглед един и същи модел. Това не е просто педантичност в документацията: в зависимост от избраната конвенция, Вашето приложение ще получава или абсолютно същия модел при всяко извикване в продължение на месеци, или версия, податлива на промени без предупреждение. Повечето необясними регресии в продукционна среда – „отговорите станаха по-дълги, но никой нищо не е променял“ – произтичат точно от това.
Обикновен псевдоним
Обикновеният псевдоним използва базовото име на модела без суфикс:
{
"model": "grok-4.20"
}
Това сочи към най-новата стабилна версия на модела. xAI може да актуализира основната версия по всяко време и Вие ще разберете за това само чрез мониторинг на собствените си изходи. Тази гъвкавост е точно това, от което се нуждаете по време на разработка и прототипиране: винаги работите с най-добрата налична версия, без да се налага да актуализирате каквото и да е. Докато迭代ирате върху промптове, изследвате възможностите на модела и точната възпроизводимост на отговорите няма значение, тази конвенция работи отлично.
Псевдоним „най-нов“ (latest)
Псевдонимът latest сочи към най-усъвършенстваната версия, която все още не е стабилизирана:
{
"model": "grok-4.20-latest"
}
Това, което получавате тук, може да се променя често и да включва промени, които все още са във валидация. Това е инструмент за оценка, полезен за тестване на предстоящи версии, преди те да станат псевдоним по подразбиране, за измерване на подобрения в качеството или производителността и за информирана подготовка на миграцията Ви.
Той принадлежи единствено в тестови среди, никога в продукционна. Промяна може да се случи за една нощ, да промени поведението на Вашия промпт и да достигне до потребителите Ви без предупреждение – няма да имате линия в commit или билет за грешка, към които да се апелirate, за да разберете какво се е случило.
Фиксирана версия
Фиксираната версия включва дата в идентификатора:
{
"model": "grok-4.20-0309"
}
Суфиксът -0309 съответства на датата на издаване, в случая 9 март. Тази версия не се мести: докато остава активна, моделът, отговарящ днес, ще бъде същият, който ще отговаря и след шест месеца. Това е единственият защитим вариант за продукционна среда по четири основни причини. Поведението на Вашето приложение става възпроизводимо, което прави интеграционните и регресионните Ви тестове валидни в дългосрочен план. Никакви тихи актуализации не могат да Ви изненадат. Времето за миграция става планирано екипно решение, а не нещо, което Ви се случва. И ако поведението се промени въпреки това, знаете, че причината е във Ваша страна.
Една конвенция за всяка среда
Най-добрата практика не е да избирате между трите, а да присвоите всяка на съответната ѝ среда:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Обикновен псевдоним: най-нова стабилна
"staging": "grok-4.20-latest", # Най-нова: тест на нови функции
"production": "grok-4.20-0309", # Фиксирана версия: максимална стабилност
}[ENVIRONMENT]
Разглеждайте този речник като система за ранно предупреждение. Вашата staging среда работи постоянно на latest: ако предстояща промяна счупи някой промпт, интеграционните Ви тестове ще го хванат, преди това да засегне потребителите Ви. Продукционната Ви среда междувременно остава на фиксирана версия. Вие откривате промени в източника, без никога да страдате от тях в крайната точка.
Преминаване от една фиксирана версия към следващата
Когато се появи нова фиксирана версия – да речем grok-4.20-0612 – превключването заслужава процедура, а не просто промяна на низ. Първо разгърнете новата версия в staging средата чрез псевдонима latest, изпълнете там своя тестов набор от промптове и след това сравнете резултатите с тези от версията, коятоcurrently е в продукционна среда. Ако сравнението е задоволително, актуализирайте продукционната конфигурация, наблюдавайте метриките в продължение на 48 часа – качество на отговорите, процент на удовлетвореност, разходи – и валидирайте миграцията или се върнете към предишната версия.
Стъпката със сравнението е сърцевината на системата и тя предполага, че сте запазили изходите от текущата версия: без тази референтна точка „сравняването“ се свежда до впечатление. Фазата на наблюдение умишлено включва разходите. По-новата версия може да е по-многословна, да генерира повече изходни токени и да увеличи сметката Ви с няколко процента при еднакво възприемано качество. Четиридесет и осем часа обикновено са достатъчни, за да се види това, а връщането към предишната версия остава просто ред в конфигурацията.
Ключови изводи
- Обикновен псевдоним (
grok-4.20): най-нова стабилна версия, за разработка - Псевдоним „най-нов“ (
grok-4.20-latest): експериментална версия, само за тестване - Фиксирана версия (
grok-4.20-0309): непроменлива, единственият препоръчителен вариант за продукционна среда - Използвайте различни конвенции за различните среди (dev/staging/prod)
- Планирайте структуриран процес на миграция при преминаване от една фиксирана версия към друга