Ниво на усилие за разсъждение: ниско, средно и високо
На тази страница
Обновено на 3 ноември 2026 г. въз основа на справочника за xAI API:
max_completion_tokensограничава само видимия отговор; токените за разсъждение не се броят към този лимит, а параметърът за усилие контролира тяхното количество. Източник: Chat Completions. Добавка от 3 ноември: Предишно уроците свързваха усилието с API (Chat Completions или Responses) и го прилагаха къмgrok-4.20-0309-reasoning, който не го поддържа; според страницата Reasoning на xAI, това зависи от модела (grok-4.7,grok-4.6,grok-4.5,grok-4.20-multi-agent). Примерът също използвашеusage.completion_tokens, което липсва в отговорите на Responses API (output_tokens,output_tokens_details.reasoning_tokens). Източник: Reasoning.
Контрол на дълбочината на разсъждението
Усилието за разсъждение Ви позволява да калибрирате колко мисъл инвестира моделът, преди да отговори. Това е директен лост за балансиране между качество, скорост и консумация на токени.
Моделът определя наличността, а не API. Според документацията на xAI:
| Модел | Дълбочина на разсъждението | Стойности |
|---|---|---|
grok-4.7, grok-4.6 | Дълбочина на разсъждението | low, medium, high (по подразбиране), xhigh |
grok-4.5 | Дълбочина на разсъждението | low, medium, high (по подразбиране); xhigh се третира като high |
grok-4.20-multi-agent | Брой мобилизирани агенти (4 или 16), а не дълбочина | low, medium, high, xhigh |
grok-4.20-0309-reasoning | Не се конфигурира: моделът винаги разсъждава | — |
Разсъждението не може да бъде деактивирано при тези модели: без конфигурация усилието по подразбиране е high. Само името на параметъра се променя в зависимост от API: reasoning_effort на най-горно ниво в Chat Completions и reasoning.effort вътре в обект reasoning при Responses API.
{
"model": "grok-4.7",
"input": "Solve the system of equations: 3x + 2y = 12, x - y = 1",
"reasoning": {
"effort": "medium"
}
}
Нива на усилие
Документацията описва всяко ниво и подходящото му използване:
low: Използва известно разсъждение, оставайки бърз. Подходящо за агентни употреби, чувствителни към латентност, и прости извиквания на инструменти.medium: Повече размисъл, за приложения, по-малко чувствителни към латентност. Подходящо за сложен анализ на данни и разсъждение върху дълги контексти.high(по подразбиране): Много повече токени за разсъждение. Подходящо за много трудни проблеми, сложна математика и логика в няколко стъпки.xhigh: Максимална дълбочина със съответната латентност. Подходящо за най-трудните проблеми, когато качеството е по-важно от времето за отговор.
Най-добрите практики на xAI добавят просто правило: задавайте усилието изрично при всяка заявка и го записвайте в дневника с всеки резултат, за да останат измерванията Ви сравними.
Моделите за разсъждение също отхвърлят три параметъра: presence_penalty, frequency_penalty и stop ще доведат до неуспех на заявката.
Върху токени
Нивото на усилие има пряко въздействие върху консумацията на токени за разсъждение:
low: Малко токени за разсъждение, бърз отговор, ниска ценаmedium: Умерена консумация, добър компромисhighиxhigh: Много токени за разсъждение, по-бавен отговор, висока цена
Тези токени за разсъждение се таксуват като изходни токени (виж Урок 8). Горната граница на изхода (max_completion_tokens в Chat Completions, max_output_tokens в Responses API) ограничава само видимия отговор: разсъждението не се брои към нея, така че усилието контролира тяхното количество.
Избор на правилното ниво
| Задача | Препоръчително усилие |
|---|---|
| Класификация на текст | low |
| Обобщение с анализ | medium |
| Структурирано извличане на entities | low |
| Решаване на уравнения | high |
| Анализ на бъгове в код | high |
| Реформулиране на текст | low |
| Сравнение на опции с предимства/недостатъци | medium |
| Математическо доказателство | high |
Практически пример: Един и същи въпрос, три нива на усилие
for effort in ["low", "medium", "high"]:
response = client.responses.create(
model="grok-4.7",
input="Explain why 0.1 + 0.2 != 0.3 in computing.",
reasoning={"effort": effort},
)
usage = response.usage
print(f"Effort {effort}: {usage.output_tokens} output tokens, "
f"including {usage.output_tokens_details.reasoning_tokens} reasoning tokens")
Разликата между нивата зависи от въпроса: измервайте я във Вашите конкретни случаи, вместо да разчитате на общо съотношение, и записвайте усилието с всеки резултат.
Ключови изводи
- Усилието зависи от модела:
low,medium,high(по подразбиране) иxhighзаgrok-4.7иgrok-4.6, безxhighзаgrok-4.5;grok-4.20-0309-reasoningне го поддържа reasoning_effortв Chat Completions,reasoning.effortв Responses API; разсъждението не може да бъде деактивирано- Нивото на усилие пряко влияе върху броя на токените за разсъждение и следователно върху разходите
- Без конфигурация усилието по подразбиране е
high: задавайте го изрично при всяка заявка, както препоръчва xAI - Адаптирайте усилието към действителната сложност на задачата, за да оптимизирате разходите