Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Responses API: objekt reasoning lähemalt

Õppetund 7 / 12 Värskendatud 28. juuli 2026 Arendajatele
Sellel lehel
  1. Objekt reasoning Responses API-s
  2. Objekti reasoning täielik struktuur
  3. Erinevus kokkuvõtte ja krüpteeritud arutluse vahel
  4. Levinud kombinatsioonid
  5. Millal jätta objekt reasoning kasutamata
  6. Peamised punktid

Objekt reasoning Responses API-s

xAI Responses API pakub peenekoelist juhtimist arutluse üle objekti reasoning kaudu. See parameeter on saadaval ainult Responses API-s (mitte Chat Completionsis) ja võimaldab konfigureerida arutluse kolme aspekti: pingutus, kokkuvõtte genereerimine ja kokkuvõtte vorming.

Objekti reasoning täielik struktuur

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

effort

Juhib mudeli mõtlemise sügavust. Võimalikud on kolm väärtust:

  • low: minimaalne mõtlemine, sobib lihtsate ülesannete jaoks
  • medium: tasakaal sügavuse ja kiiruse vahel
  • high: maksimaalne mõtlemine keerukate probleemide lahendamiseks

See parameeter on Responses API vaste parameetrile reasoning_effort Chat Completionsis, kuid lisandub väärtus medium.

generate_summary

Boole’i väärtus, mis näitab, kas mudel peaks lisaks lõppvastusele koostama oma arutluskäigu kokkuvõtte.

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

Kui generate_summary on määratud väärtusele true, sisaldab vastus täiendavat elementi, mis koosneb arutlusprotsessi lühikesest kokkuvõttest. See kokkuvõte on lihttekstina (krüpteerimata), mis eristab seda väljast reasoning.encrypted_content.

summary

Juhib genereeritud kokkuvõtte vormingut. Praegu on ainus dokumenteeritud väärtus "auto", mis jätab mudelile võimaluse valida kõige sobivam vorming.

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

Erinevus kokkuvõtte ja krüpteeritud arutluse vahel

Need kaks mehhanismi täiendavad teineteist, kuid on erinevad:

AspektKokkuvõte (generate_summary)Krüpteeritud (include)
LoetavusLihttekst, arusaadavKrüpteeritud, läbipaistmatu
Peamine kasutusviisKasutajale kuvamine, auditeerimineTaaskasutamine järgnevates päringutes
Aktiveeriminereasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
Detailne sisuKondenseeritud kokkuvõteTäielik arutluskäik
SaadavusAinult Responses APIAinult Responses API

Saad mõlemad samaaegselt lubada, et saada nii loetav kokkuvõte kui ka täielik krüpteeritud arutluskäik:

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

Levinud kombinatsioonid

Minimaalne kasutus: ainult pingutus

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

Mudel arutleb minimaalse pingutusega. Kokkuvõtet ega krüpteeritud arutlust ei tagastata.

Vahepealne kasutus: pingutus + kokkuvõte

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

Mudel arutleb ja esitab loetava kokkuvõtte. Ideaalne rakendustele, mis soovivad kasutajale mõtlemisprotsessi näidata.

Täielik kasutus: pingutus + kokkuvõte + krüpteeritud

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

Maksimaalne konfiguratsioon: sügav arutlus, loetav kokkuvõte ja taaskasutamiseks mõeldud krüpteeritud sisu. Kasuta seda juhtudel, kui vajad kõike.

Millal jätta objekt reasoning kasutamata

Kui sa ei pea arutlust juhtima, võid parameetri reasoning lihtsalt ära jätta. Mudel kasutab vaikimisi seadeid. See on täiesti korrektne ja mudel arutleb ikka (kuna grok-4.20-0309-reasoning on oma olemuselt arutlev mudel).

Peamised punktid

  • Objekt reasoning on saadaval ainult Responses API-s
  • effort juhib sügavust (low, medium, high)
  • generate_summary loob arutluskäigu loetava kokkuvõtte (lihttekst)
  • summary: "auto" jätab mudelile kokkuvõtte vormingu valiku
  • Saad samas päringus kombineerida kokkuvõtet ja krüpteeritud arutlust
  • reasoning ärajätmine on lubatud: mudel arutleb vaikimisi seadetega