Salt la conținutul principal
Română— Alege o limbă
Meniu

API-ul Responses: Obiectul reasoning în detaliu

Lecția 7 din 12 Actualizată 28 iulie 2026 Dezvoltator
Pe această pagină
  1. Obiectul reasoning în API-ul Responses
  2. Structura completă a obiectului reasoning
  3. Diferența dintre Rezumat și Raționament Criptat
  4. Combinații frecvente
  5. Când să omiteți obiectul reasoning
  6. Puncte cheie

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 simple
  • medium : 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:

AspectRezumat (generate_summary)Criptat (include)
LizibilitateText clar, inteligibilCriptat, opac
Utilizare principalăAfișare pentru utilizator, auditReutilizare în cereri ulterioare
Activarereasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetaliuRezumat condensatRaționament complet
DisponibilitateDoar API-ul ResponsesDoar 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 reasoning este disponibil doar în API-ul Responses
  • effort controlează profunzimea (low, medium, high)
  • generate_summary produce 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 reasoning este validă: modelul raționează cu setările implicite