Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Responses API: išsamus apie objektą reasoning

Paskaita 7 iš 12 Atnaujinta 2026 m. liepos 28 d. Kūrėjas
Šiame puslapyje
  1. Objektas reasoning Responses API
  2. Pilna objekto reasoning struktūra
  3. Skirtumas tarp santraukos ir užšifruoto samprotavimo
  4. Dažni deriniai
  5. Kada praleisti objektą reasoning
  6. Svarbiausi punktai

Objektas reasoning Responses API

xAI Responses API suteikia tikslų valdymą samprotavimui per objektą reasoning. Šis parametras galimas tik Responses API (ne Chat Completions) ir leidžia konfigūruoti tris samprotavimo aspektus: pastangų lygį, santraukos generavimą ir santraukos formatą.

Pilna objekto reasoning struktūra

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

effort

Valdo modelio mąstymo gylį. Galimos trys reikšmės:

  • low : minimalus mąstymas, tinkamas paprastoms užduotims
  • medium : balansas tarp gylio ir greičio
  • high : maksimalus mąstymas sudėtingoms problemoms spręsti

Šis parametras yra Responses API atitikmuo reasoning_effort iš Chat Completions, tačiau turi papildomą medium reikšmę.

generate_summary

Būlio reikšmė, nurodanti, ar modelis turi pateikti savo samprotavimų santrauką kartu su galutiniu atsakymu.

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

Kai generate_summary nustatyta į true, atsakyme atsiranda papildomas elementas su glaustu samprotavimo proceso apibūdinimu. Ši santrauka yra paprastuoju tekstu (neužšifruota), o tai ją skiria nuo reasoning.encrypted_content.

summary

Valdo generuojamos santraukos formatą. Šiuo metu vienintelė dokumentuota reikšmė yra "auto", kuri leidžia modeliui pačiam pasirinkti tinkamiausią formatą.

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

Skirtumas tarp santraukos ir užšifruoto samprotavimo

Šie du mechanizmai papildo vienas kitą, tačiau yra skirtingi:

AspektasSantrauka (generate_summary)Užšifruota (include)
SkaitomumasPaprastasis tekstas, suprantamasUžšifruotas, nepermatomas
Pagrindinis naudojimasRodymas naudotojui, auditasPakartotinis naudojimas vėlesniuose užklausose
Aktyvavimasreasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetalumasGlausta santraukaPilnas samprotavimas
PrieinamumasTik Responses APITik Responses API

Gali vienu metu įjungti abu mechanizmus, kad gautum tiek skaitomą santrauką, tiek visą užšifruotą samprotavimą:

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

Dažni deriniai

Minimalus naudojimas: tik pastangos

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

Modelis samprotauja minimaliomis pastangomis. Grąžinama nei santrauka, nei užšifruotas samprotavimas.

Tarpinis naudojimas: pastangos + santrauka

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

Modelis samprotauja ir pateikia skaitomą santrauką. Idealu programoms, kurios nori rodyti mąstymo eigą naudotojui.

Pilnas naudojimas: pastangos + santrauka + užšifravimas

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

Maksimali konfigūracija: gilus samprotavimas, skaitoma santrauka ir užšifruotas turinis pakartotiniam naudojimui. Naudok tai tik tais atvejais, kai tau reikia visko.

Kada praleisti objektą reasoning

Jei tau nereikia valdyti samprotavimo, gali tiesiog nepridėti parametro reasoning. Modelis naudos numatytuosius nustatymus. Tai yra galiojantis veiksmas, ir modelis vis tiek samprotaus (kadangi grok-4.20-0309-reasoning iš esmės yra samprotavimo modelis).

Svarbiausi punktai

  • Objektas reasoning galimas tik Responses API
  • effort valdo gylį (low, medium, high)
  • generate_summary sukuria skaitomą samprotavimo santrauką (paprastasis tekstas)
  • summary: "auto" leidžia modeliui pasirinkti santraukos formatą
  • Gali derinti santrauką ir užšifruotą samprotavimą tame pačiame užklausime
  • Praleidus reasoning, viskas veikia: modelis samprotauja naudodamas numatytuosius nustatymus