Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

API Responses: objekts reasoning detalizēti

Nodarbība 7 no 12 Atjaunota 2026. gada 28. jūlijs Programmētājs
Šajā lapā
  1. Objekts reasoning API Responses
  2. Pilna objekta reasoning struktūra
  3. Atšķirība starp kopsavilkumu un šifrētu spriešanu
  4. Biežākās kombinācijas
  5. Kad izlaist objektu reasoning
  6. Galvenās atziņas

Objekts reasoning API Responses

xAI API Responses piedāvā smalku kontroli pār spriešanu, izmantojot objektu reasoning. Šis parametrs ir pieejams tikai API Responses (nevis Chat Completions) un ļauj konfigurēt trīs spriešanas aspektus: piepūli, kopsavilkuma ģenerēšanu un kopsavilkuma formātu.

Pilna objekta reasoning struktūra

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

effort

Kontrolē modeļa domāšanas dziļumu. Iespējamas trīs vērtības:

  • low: minimāla domāšana, piemērota vienkāršiem uzdevumiem
  • medium: līdzsvars starp dziļumu un ātrumu
  • high: maksimāla domāšana sarežģītām problēmām

Šis parametrs API Responses ir ekvivalents reasoning_effort pakalpojumā Chat Completions, taču ar papildu vērtību medium.

generate_summary

Būla vērtība, kas norāda, vai modelim papildus galīgajai atbildei jāizveido sava spriešanas procesa kopsavilkums.

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

Kad generate_summary ir iestatīts uz true, atbilde satur papildu elementu ar kodolīgu spriešanas procesa kopsavilkumu. Šis kopsavilkums ir parastā tekstā (nešifrēts), kas to atšķir no reasoning.encrypted_content.

summary

Kontrolē ģenerētā kopsavilkuma formātu. Pagaidām vienīgā dokumentētā vērtība ir "auto", kas ļauj modelim izvēlēties vispiemērotāko formātu.

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

Atšķirība starp kopsavilkumu un šifrētu spriešanu

Šie divi mehānismi ir papildinoši, bet atšķirīgi:

AspektsKopsavilkums (generate_summary)Šifrēts (include)
LasāmībaParasts teksts, saprotamsŠifrēts, neskaidrs
PamatlietojumsLietotāja displejs, auditsAtkārtota izmantošana turpmākos pieprasījumos
Aktivizēšanareasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetalizācijaKondensēts kopsavilkumsPilns spriešanas process
PieejamībaTikai API ResponsesTikai API Responses

Tu vari aktivizēt abus vienlaicīgi, lai iegūtu gan lasāmu kopsavilkumu, gan pilnu šifrētu spriešanu:

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"]
)

Biežākās kombinācijas

Minimāls lietojums: tikai piepūle

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

Modelis veic spriešanu ar minimālu piepūli. Netiek atgriezts ne kopsavilkums, ne šifrēta spriešana.

Vidējs lietojums: piepūle + kopsavilkums

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

Modelis veic spriešanu un sniedz lasāmu kopsavilkumu. Ideāli piemērots lietotnēm, kas vēlas lietotājam parādīt domāšanas procesu.

Pilns lietojums: piepūle + kopsavilkums + šifrēts saturs

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

Maksimāla konfigurācija: dziļa spriešana, lasāms kopsavilkums un šifrēts saturs atkārtotai izmantošanai. Paturēši to gadījumiem, kad tev nepieciešams viss.

Kad izlaist objektu reasoning

Ja tev nav nepieciešams kontrolēt spriešanu, vari vienkārši izlaist parametru reasoning. Modelis izmantos savus noklusējuma iestatījumus. Tas joprojām ir derīgi, un modelis joprojām veiks spriešanu (jo grok-4.20-0309-reasoning pēc savas būtības ir spriešanas modelis).

Galvenās atziņas

  • Objekts reasoning ir pieejams tikai API Responses
  • effort kontrolē dziļumu (low, medium, high)
  • generate_summary ģenerē lasāmu spriešanas kopsavilkumu (parasts teksts)
  • summary: "auto" ļauj modelim izvēlēties kopsavilkuma formātu
  • Tu vari apvienot kopsavilkumu un šifrētu spriešanu vienā pieprasījumā
  • Parametra reasoning izlaišana ir derīga: modelis veic spriešanu ar noklusējuma iestatījumiem