Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Responses API: objektet reasoning i detalj

Lektion 7 av 12 Uppdaterad 28 juli 2026 Utvecklare
På denna sida
  1. Objektet reasoning i Responses API
  2. Fullständig struktur för objektet reasoning
  3. Skillnad mellan sammanfattning och krypterat resonemang
  4. Vanliga kombinationer
  5. När du ska utelämna objektet reasoning
  6. Viktiga punkter

Objektet reasoning i Responses API

xAI:s Responses API ger dig finjusterad kontroll över resonemang via objektet reasoning. Denna parameter finns endast tillgänglig i Responses API (inte i Chat Completions) och låter dig konfigurera tre aspekter av resonemanget: ansträngning, generering av sammanfattning och format för sammanfattningen.

Fullständig struktur för objektet reasoning

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

effort

Styr modellens djup i tänkandet. Tre möjliga värden:

  • low : minimalt tänkande, lämpat för enkla uppgifter
  • medium : balans mellan djup och hastighet
  • high : maximalt tänkande för komplexa problem

Denna parameter motsvarar reasoning_effort i Chat Completions, men med det tillagda värdet medium.

generate_summary

En boolesk variabel som anger om modellen ska producera en sammanfattning av sitt resonemang utöver det slutgiltiga svaret.

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

När generate_summary är satt till true innehåller svaret ett ytterligare element med en koncis sammanfattning av resonemangsprocessen. Denna sammanfattning är i klartext (inte krypterad), vilket skiljer den från reasoning.encrypted_content.

summary

Styr formatet på den genererade sammanfattningen. Just nu är det enda dokumenterade värdet "auto", vilket låter modellen välja det mest lämpliga formatet.

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

Skillnad mellan sammanfattning och krypterat resonemang

Dessa två mekanismer kompletterar varandra men är distinkta:

AspektSammanfattning (generate_summary)Krypterat (include)
LäsbarhetKlartext, begripligKrypterad, ogenomskinlig
Primär användningVisning för användare, granskningÅteranvändning i efterföljande förfrågningar
Aktiveringreasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetaljnivåKondenserad sammanfattningFullständigt resonemang
TillgänglighetEndast Responses APIEndast Responses API

Du kan aktivera båda samtidigt för att få både en läsbar sammanfattning och det fullständiga krypterade resonemanget:

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

Vanliga kombinationer

Minimal användning: Endast ansträngning

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

Modellen resonerar med minimal ansträngning. Ingen sammanfattning och inget krypterat resonemang returneras.

Mellannivå: Ansträngning + Sammanfattning

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

Modellen resonerar och tillhandahåller en läsbar sammanfattning. Idealiskt för applikationer som vill visa tankeprocessen för användaren.

Fullständig användning: Ansträngning + Sammanfattning + Krypterat

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

Maximal konfiguration: djupt resonemang, läsbar sammanfattning och krypterat innehåll för återanvändning. Reservera detta för fall där du behöver allt.

När du ska utelämna objektet reasoning

Om du inte behöver styra resonemanget kan du helt enkelt utelämna parametern reasoning. Modellen kommer då att använda sina standardinställningar. Detta är giltigt och modellen kommer fortfarande att resonera (eftersom grok-4.20-0309-reasoning är en resonemangsmodell i grunden).

Viktiga punkter

  • Objektet reasoning finns endast tillgängligt i Responses API
  • effort styr djupet (low, medium, high)
  • generate_summary producerar en läsbar sammanfattning av resonemanget (klartext)
  • summary: "auto" låter modellen välja format för sammanfattningen
  • Du kan kombinera sammanfattning och krypterat resonemang i samma förfrågan
  • Att utelämna reasoning är giltigt: modellen resonerar med standardinställningar