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

API за отговори: Обектът reasoning в детайли

Урок 7 от 12 Обновен 28 юли 2026 г. Програмист
На тази страница
  1. Обектът reasoning в API за отговори
  2. Пълна структура на обекта reasoning
  3. Разлика между обобщение и криптирано разсъждение
  4. Чести комбинации
  5. Кога да пропуснете обекта reasoning
  6. Ключови изводи

Обектът reasoning в API за отговори

API за отговори на xAI предлага детайлен контрол върху процеса на разсъждение чрез обекта reasoning. Този параметър е достъпен единствено в API за отговори (не и в Chat Completions) и Ви позволява да конфигурирате три аспекта на разсъждението: усилие, генериране на обобщение и формат на обобщението.

Пълна структура на обекта reasoning

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Your question here",
  "reasoning": {
    "effort": "medium",
    "generate_summary": true,
    "summary": "auto"
  }
}

effort

Контролира дълбочината на мислене на модела. Възможни са три стойности:

  • low: минимално мислене, подходящо за прости задачи
  • medium: баланс между дълбочина и скорост
  • high: максимално мислене за сложни проблеми

Този параметър е еквивалентът в API за отговори на reasoning_effort от Chat Completions, но с добавена стойност medium.

generate_summary

Булева стойност, която указва дали моделът трябва да генерира обобщение на своето разсъждение в допълнение към крайния отговор.

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Compare the advantages of quicksort and mergesort.",
  "reasoning": {
    "effort": "high",
    "generate_summary": true
  }
}

Когато generate_summary е зададено на true, отговорът съдържа допълнителен елемент с кратко обобщение на процеса на разсъждение. Това обобщение е в обикновен текст (не е криптирано), което го отличава от reasoning.encrypted_content.

summary

Контролира формата на генерираното обобщение. Към момента единствената документирана стойност е "auto", която позволява на модела да избере най-подходящия формат.

{
  "reasoning": {
    "effort": "high",
    "generate_summary": true,
    "summary": "auto"
  }
}

Разлика между обобщение и криптирано разсъждение

Тези два механизма са допълващи се, но различни:

АспектОбобщение (generate_summary)Криптирано (include)
ЧетимостОбикновен текст, разбираемКриптирано, непрозрачно
Основна употребаПоказване на потребителя, одитПовторна употреба в следващи заявки
Активацияreasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
ДетайлностКондензирано обобщениеПълно разсъждение
НаличностСамо в API за отговориСамо в API за отговори

Можете да активирате и двете едновременно, за да получите както четимо обобщение, така и пълното криптирано разсъждение:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Demonstrate the infinitude of prime numbers.",
    reasoning={
        "effort": "high",
        "generate_summary": True,
        "summary": "auto"
    },
    include=["reasoning.encrypted_content"]
)

Чести комбинации

Минимална употреба: Само усилие

{
  "reasoning": {
    "effort": "low"
  }
}

Моделът разсъждава с минимално усилие. Няма върнато обобщение и няма криптирано разсъждение.

Междинна употреба: Усилие + Обобщение

{
  "reasoning": {
    "effort": "medium",
    "generate_summary": true,
    "summary": "auto"
  }
}

Моделът разсъждава и предоставя четимо обобщение. Идеално за приложения, които искат да покажат процеса на мислене на потребителя.

Пълна употреба: Усилие + Обобщение + Криптирано

{
  "reasoning": {
    "effort": "high",
    "generate_summary": true,
    "summary": "auto"
  },
  "include": ["reasoning.encrypted_content"]
}

Максимална конфигурация: дълбоко разсъждение, четимо обобщение и криптирано съдържание за повторна употреба. Запазете това за случаи, когато Ви е необходимо всичко.

Кога да пропуснете обекта reasoning

Ако нямате нужда да контролирате разсъждението, можете просто да пропуснете параметъра reasoning. Моделът ще използва настройките си по подразбиране. Това остава валидно и моделът все пак ще разсъждава (тъй като grok-4.20-0309-reasoning е модел за разсъждение по своята същност).

Ключови изводи

  • Обектът reasoning е достъпен само в API за отговори
  • effort контролира дълбочината (low, medium, high)
  • generate_summary генерира четимо обобщение на разсъждението (обикновен текст)
  • summary: "auto" позволява на модела да избере формата на обобщението
  • Можете да комбинирате обобщение и криптирано разсъждение в една и съща заявка
  • Пропускането на reasoning е валидно: моделът разсъждава с настройките по подразбиране