Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Responses API: reasoning-objekti tarkemmin

Oppitunti 7 / 12 Päivitetty 28. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. reasoning-objekti Responses API:ssa
  2. reasoning-objektin täydellinen rakenne
  3. Ero yhteenvedon ja salatun päättelyn välillä
  4. Yleisiä yhdistelmiä
  5. Milloin reasoning-objektin voi jättää pois
  6. Keskeiset asiat

reasoning-objekti Responses API:ssa

xAI:n Responses API tarjoaa hienosäätöisen hallinnan päättelyyn reasoning-objektin avulla. Tämä parametri on käytettävissä vain Responses API:ssa (ei Chat Completionsissa), ja sen avulla voit määrittää kolme päättelyn aspektia: ponnistelutason, yhteenvedon luonnin ja yhteenvedon muodon.

reasoning-objektin täydellinen rakenne

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

effort

Ohjaa mallin ajattelun syvyyttä. Kolme mahdollista arvoa:

  • low: vähäinen ajattelu, sopii yksinkertaisiin tehtäviin
  • medium: tasapaino syvyyden ja nopeuden välillä
  • high: maksimaalinen ajattelu monimutkaisiin ongelmiin

Tämä parametri vastaa Chat Completionsin reasoning_effort-parametria, mutta sisältää lisäksi arvon medium.

generate_summary

Boole-arvo, joka ilmoittaa, tuottaako malli päättelystään yhteenvedon varsinaisen vastauksen lisäksi.

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

Kun generate_summary on asetettu arvoksi true, vastaus sisältää lisäelementin, jossa on tiivis yhteenveto päättelyprosessista. Tämä yhteenveto on pelkkää tekstiä (ei salattua), mikä erottaa sen kentästä reasoning.encrypted_content.

summary

Ohjaa luodun yhteenvedon muotoa. Toistaiseksi ainoa dokumentoitu arvo on "auto", joka antaa mallin valita sopivimman muodon.

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

Ero yhteenvedon ja salatun päättelyn välillä

Nämä kaksi mekanismia täydentävät toisiaan, mutta ovat erillisiä:

AspektiYhteenveto (generate_summary)Salattu (include)
LuettavuusPelkkää tekstiä, ymmärrettäväSalattu, läpinäkymätön
Ensisijainen käyttötarkoitusNäyttö käyttäjälle, auditointiUudelleenkäyttö myöhemmissä pyynnöissä
Aktivointireasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
YksityiskohtaisuusTiivis yhteenvetoKoko päättelyketju
SaatavuusVain Responses APIVain Responses API

Voit ottaa molemmat käyttöön samanaikaisesti saadaksesi sekä luettavan yhteenvedon että koko salatun päättelyn:

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

Yleisiä yhdistelmiä

Minimikäyttö: Vain effort

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

Malli päättelee minimaalisella ponnistelulla. Yhteenvetoa tai salattua päättelyä ei palauteta.

Välikäyttö: effort + yhteenveto

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

Malli päättelee ja tuottaa luettavan yhteenvedon. Ihanteellinen sovelluksille, jotka haluavat näyttää ajatteluprosessin käyttäjälle.

Täysikäyttö: effort + yhteenveto + salattu

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

Maksimaalinen konfiguraatio: syvä päättely, luettava yhteenveto ja uudelleenkäytettävä salattu sisältö. Varaa tämä tapauksiin, joissa tarvitset kaiken.

Milloin reasoning-objektin voi jättää pois

Jos sinun ei tarvitse hallita päättelyä, voit yksinkertaisesti jättää reasoning-parametrin pois. Malli käyttää tällöin oletusasetuksiaan. Tämä on täysin validia, ja malli päättelee silti (koska grok-4.20-0309-reasoning on luonteeltaan päättelymalli).

Keskeiset asiat

  • reasoning-objekti on saatavilla vain Responses API:ssa
  • effort ohjaa syvyyttä (low, medium, high)
  • generate_summary tuottaa luettavan yhteenvedon päättelystä (pelkkää tekstiä)
  • summary: "auto" antaa mallin valita yhteenvedon muodon
  • Voit yhdistää yhteenvedon ja salatun päättelyn samaan pyyntöön
  • reasoning-objektin pois jättäminen on validia: malli päättelee oletusasetuksilla