Hämta krypterad resonemangsförmåga med include
På denna sida
Kom åt intern resonemangsförmåga hos xAI:s resonemangsmodeller
De senaste resonemangsmodellerna från xAI (familjerna grok-4.5 och grok-4.20) genererar intern resonemangsförmåga som du inte kan läsa som vanlig text. xAI låter dig dock hämta denna resonemangsförmåga i krypterad form med hjälp av parametern include. Denna mekanism möjliggör avancerad användning, särskilt återanvändning av resonemang i efterföljande förfrågningar.
Parametern include
För att hämta det krypterade resonemanget lägger du till "reasoning.encrypted_content" i arrayen include i din förfrågan till Responses API:
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort.",
include=["reasoning.encrypted_content"]
)
Svarsstruktur
Svaret innehåller det krypterade resonemanget i ett specifikt format. Detta innehåll är en kodad blob som du kan lagra men inte tolka. Den interna strukturen är avsiktligt ogenomskinlig.
# Iterera genom svarsobjekten
for item in response.output:
if item.type == "reasoning":
# Krypterat resonemangsinnehåll
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Modellens slutgiltiga svar
print(f"Response: {item.content[0].text}")
Utan include: inget resonemang i svaret
Om du inte inkluderar "reasoning.encrypted_content" i parametern include innehåller svaret endast slutresultatet. Resonemanget sker på serversidan, men inget spår returneras:
# Utan include - endast slutsvaret returneras
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output innehåller endast meddelandet, inget resonemang
Resonemangstokens räknas och debiteras ändå, även utan include. Skillnaden är att du inte får det krypterade innehållet för senare återanvändning.
När ska du använda include?
Att hämta krypterat resonemang har en kostnad – större svar och mer bandbredd – så använd include för ett specifikt ändamål, inte som standard. Det främsta användningsområdet är flerstegskonversationer: om du planerar att fortsätta utbytet bevarar återinjicering av resonemanget från föregående steg kontinuiteten i modellens tankegång. Detta skiljer en framåtskridande konversation från en serie oberoende frågor. Thought cache är företagsutökningen: att lagra resonemang från en förfrågan för att återanvända det på liknande förfrågningar undviker att modellen behöver beräkna om allt. Två styrningsrelaterade användningsfall återstår: revision, när regelefterlevnad kräver en komplett spårning av varje producerat svar, och felsökning med xAI:s support, som kommer att begära hela resonemanget för att analysera oväntat beteende.
Lagra krypterat resonemang
Du kan lagra det krypterade innehållet som vilken sträng som helst. I en databas räcker ett fält av typen TEXT eller JSONB:
import json
# Extrahera och lagra krypterat resonemang
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Spara tillsammans med svaret
record = {
"question": "Analyze the complexity of merge sort.",
"response": response.output[-1].content[0].text,
"encrypted_reasoning": reasoning_data,
"model": "grok-4.20-0309-reasoning",
"timestamp": "2026-04-03T10:00:00Z"
}
Viktiga punkter
- Parametern
include=["reasoning.encrypted_content"]hämtar krypterat resonemang från xAI:s resonemangsmodeller - Utan
includesker resonemanget men returneras inte (tokens debiteras ändå) - Det krypterade innehållet är en ogenomskinlig blob som du inte kan läsa som vanlig text
- Du kan lagra och återanvända detta innehåll i efterföljande förfrågningar (i nästa lektion)
- Använd endast
includeom du har ett specifikt användningsområde för det krypterade resonemanget