Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Responses API: reasoning-objektet i detaljer

Lektion 7 af 12 Opdateret 28. juli 2026 Udvikler
På denne side
  1. reasoning-objektet i Responses API
  2. Den fulde struktur af reasoning-objektet
  3. Forskel mellem resumé og krypteret ræsonnement
  4. Almindelige kombinationer
  5. Hvornår du skal udelade reasoning-objektet
  6. Vigtige pointer

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 opgaver
  • medium: balance mellem dybde og hastighed
  • high: 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:

AspektResumé (generate_summary)Krypteret (include)
LæsbarhedKlartekst, forståeligKrypteret, uigennemsigtig
Primær brugVisning til bruger, revisionGenbrug i efterfølgende anmodninger
Aktiveringreasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetaljeringsgradKondenseret resuméFuldt ræsonnement
TilgængelighedKun Responses APIKun 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 API
  • effort styrer dybden (low, medium, high)
  • generate_summary producerer 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