Responses API: reasoning-objekti tarkemmin
Tällä sivulla
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äviinmedium: 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ä:
| Aspekti | Yhteenveto (generate_summary) | Salattu (include) |
|---|---|---|
| Luettavuus | Pelkkää tekstiä, ymmärrettävä | Salattu, läpinäkymätön |
| Ensisijainen käyttötarkoitus | Näyttö käyttäjälle, auditointi | Uudelleenkäyttö myöhemmissä pyynnöissä |
| Aktivointi | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Yksityiskohtaisuus | Tiivis yhteenveto | Koko päättelyketju |
| Saatavuus | Vain Responses API | Vain 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:ssaeffortohjaa syvyyttä (low,medium,high)generate_summarytuottaa 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