Responses API: reasoning-objektet i detaljer
På denne side
reasoning-objektet i Responses API
xAI’s Responses API giver dig finmasket kontrol over ræsonnement via reasoning-objektet. Denne parameter findes kun i Responses API (ikke i Chat Completions) og lader dig konfigurere tre aspekter af ræsonnement: indsats, generering af resumé og resuméformat.
Den fulde struktur af reasoning-objektet
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Styrer modellens dybde i tankegangen. Tre mulige værdier:
low: minimal tankegang, velegnet til simple opgavermedium: balance mellem dybde og hastighedhigh: maksimal tankegang til komplekse problemer
Denne parameter svarer til reasoning_effort i Chat Completions, men med en ekstra værdi: medium.
generate_summary
En boolean, der angiver, om modellen skal producere et resumé af sin tankegang ud over det endelige svar.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Når generate_summary er sat til true, indeholder svaret et yderligere element med et koncist resumé af ræsonnementsprocessen. Dette resumé er i klartekst (ikke krypteret), hvilket adskiller det fra reasoning.encrypted_content.
summary
Styrer formatet på det genererede resumé. Indtil videre er den eneste dokumenterede værdi "auto", hvilket lader modellen vælge det mest passende format.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Forskel mellem resumé og krypteret ræsonnement
Disse to mekanismer supplerer hinanden, men er forskellige:
| Aspekt | Resumé (generate_summary) | Krypteret (include) |
|---|---|---|
| Læsbarhed | Klartekst, forståelig | Krypteret, uigennemsigtig |
| Primær brug | Visning til bruger, revision | Genbrug i efterfølgende anmodninger |
| Aktivering | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detaljeringsgrad | Kondenseret resumé | Fuldt ræsonnement |
| Tilgængelighed | Kun Responses API | Kun Responses API |
Du kan aktivere begge samtidig for at få både et læsbart resumé og det fulde krypterede ræsonnement:
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"]
)
Almindelige kombinationer
Minimal brug: Kun indsats
{
"reasoning": {
"effort": "low"
}
}
Modellen ræsonnerer med minimal indsats. Intet resumé, intet krypteret ræsonnement returneres.
Mellembrug: Indsats + resumé
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Modellen ræsonnerer og leverer et læsbart resumé. Ideelt til applikationer, der ønsker at vise tankeprocessen til brugeren.
Fuld brug: Indsats + resumé + krypteret
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Maksimal konfiguration: dybt ræsonnement, læsbart resumé og krypteret indhold til genbrug. Brug dette, når du har brug for det hele.
Hvornår du skal udelade reasoning-objektet
Hvis du ikke behøver at styre ræsonnementet, kan du blot udelade reasoning-parameteren. Modellen vil bruge sine standardindstillinger. Dette er stadig gyldigt, og modellen vil stadig ræsonnere (da grok-4.20-0309-reasoning pr. definition er en ræsonnementsmodel).
Vigtige pointer
reasoning-objektet findes kun i Responses APIeffortstyrer dybden (low,medium,high)generate_summaryproducerer et læsbart resumé af ræsonnementet (klartekst)summary: "auto"lader modellen vælge resuméformatet- Du kan kombinere resumé og krypteret ræsonnement i samme anmodning
- Det er gyldigt at udelade
reasoning: modellen ræsonnerer med standardindstillinger