API-ul Responses: Obiectul reasoning în detaliu
Pe această pagină
Obiectul reasoning în API-ul Responses
API-ul Responses de la xAI oferă un control fin asupra raționamentului prin intermediul obiectului reasoning. Acest parametru este disponibil exclusiv în API-ul Responses (nu și în Chat Completions) și vă permite să configurați trei aspecte ale raționamentului: efortul, generarea rezumatului și formatul acestuia.
Structura completă a obiectului reasoning
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Controlează profunzimea gândirii modelului. Există trei valori posibile:
low: gândire minimă, potrivită pentru sarcini simplemedium: echilibru între profunzime și vitezăhigh: gândire maximă pentru probleme complexe
Acest parametru este echivalentul în API-ul Responses al parametrului reasoning_effort din Chat Completions, dar cu o valoare suplimentară: medium.
generate_summary
Un boolean care indică dacă modelul trebuie să producă un rezumat al raționamentului său, pe lângă răspunsul final.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Când generate_summary este setat pe true, răspunsul conține un element suplimentar cu un rezumat concis al procesului de raționament. Acest rezumat este în text clar (necriptat), ceea ce îl distinge de reasoning.encrypted_content.
summary
Controlează formatul rezumatului generat. Deocamdată, singura valoare documentată este "auto", care permite modelului să aleagă formatul cel mai adecvat.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Diferența dintre Rezumat și Raționament Criptat
Aceste două mecanisme sunt complementare, dar distincte:
| Aspect | Rezumat (generate_summary) | Criptat (include) |
|---|---|---|
| Lizibilitate | Text clar, inteligibil | Criptat, opac |
| Utilizare principală | Afișare pentru utilizator, audit | Reutilizare în cereri ulterioare |
| Activare | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detaliu | Rezumat condensat | Raționament complet |
| Disponibilitate | Doar API-ul Responses | Doar API-ul Responses |
Puteți activa ambele simultan pentru a obține atât un rezumat lizibil, cât și raționamentul complet criptat:
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"]
)
Combinații frecvente
Utilizare minimă: Doar efort
{
"reasoning": {
"effort": "low"
}
}
Modelul raționează cu un efort minim. Nu se returnează niciun rezumat și niciun raționament criptat.
Utilizare intermediară: Efort + Rezumat
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Modelul raționează și furnizează un rezumat lizibil. Ideal pentru aplicațiile care doresc să afișeze procesul de gândire utilizatorului.
Utilizare completă: Efort + Rezumat + Criptat
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Configurație maximă: raționament profund, rezumat lizibil și conținut criptat pentru reutilizare. Rezervați această opțiune pentru cazurile în care aveți nevoie de toate elementele.
Când să omiteți obiectul reasoning
Dacă nu aveți nevoie să controlați raționamentul, puteți pur și simplu să omiteți parametrul reasoning. Modelul va utiliza setările implicite. Aceasta rămâne o abordare validă, iar modelul va continua să raționeze (deoarece grok-4.20-0309-reasoning este prin natura sa un model de raționament).
Puncte cheie
- Obiectul
reasoningeste disponibil doar în API-ul Responses effortcontrolează profunzimea (low,medium,high)generate_summaryproduce un rezumat lizibil al raționamentului (text clar)summary: "auto"permite modelului să aleagă formatul rezumatului- Puteți combina rezumatul și raționamentul criptat în aceeași cerere
- Omiterea lui
reasoningeste validă: modelul raționează cu setările implicite