Премини към основното съдържание
Български— Изберете език
Меню

Ниво на усилие за разсъждение: ниско, средно и високо

Урок 4 от 12 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Контрол на дълбочината на разсъждението
  2. Нива на усилие
  3. Върху токени
  4. Избор на правилното ниво
  5. Практически пример: Един и същи въпрос, три нива на усилие
  6. Ключови изводи

Обновено на 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
Структурирано извличане на entitieslow
Решаване на уравнения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
  • Адаптирайте усилието към действителната сложност на задачата, за да оптимизирате разходите