API за отговори: Обектът reasoning в детайли
На тази страница
Обектът 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: true | include: ["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е валидно: моделът разсъждава с настройките по подразбиране