Recuperarea raționamentului criptat cu include
Pe această pagină
Accesarea raționamentului intern al modelelor de raționament xAI
Modelele recente de raționament xAI (familia grok-4.5, grok-4.20) generează un raționament intern pe care nu îl puteți citi în text clar. Totuși, xAI vă permite să recuperați acest raționament sub formă criptată folosind parametrul include. Acest mecanism permite utilizări avansate, în special reutilizarea raționamentului în cererile ulterioare.
Parametrul include
Pentru a recupera conținutul criptat al raționamentului, adăugați "reasoning.encrypted_content" la tabloul include din cererea dvs. către API-ul Responses:
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"]
)
Structura răspunsului
Răspunsul conține raționamentul criptat într-un format specific. Acest conținut este un bloc de date codat pe care îl puteți stoca, dar nu îl puteți interpreta. Structura sa internă este opacă prin design.
# Iterați prin elementele răspunsului
for item in response.output:
if item.type == "reasoning":
# Conținut criptat al raționamentului
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Răspunsul final al modelului
print(f"Response: {item.content[0].text}")
Fără include: niciun raționament în răspuns
Dacă nu includeți "reasoning.encrypted_content" în parametrul include, răspunsul conține doar rezultatul final. Raționamentul are loc pe server, dar nu este returnată nicio urmă:
# Fără include - se returnează doar răspunsul final
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output conține doar mesajul, fără raționament
Token-urile de raționament sunt totuși numărate și facturate, chiar și fără include. Diferența este că nu primiți conținutul criptat pentru reutilizare ulterioară.
Când să utilizați include
Recuperarea raționamentului criptat implică un cost – răspunsuri mai mari, mai multă lățime de bandă – așa că utilizați include pentru un scop specific, nu implicit. Cazul de utilizare principal este conversația multi-tur: dacă intenționați să continuați schimbul, reinjectarea raționamentului din turul anterior păstrează continuitatea gândirii modelului. Aceasta distinge o conversație care progresează de o serie de întrebări independente. Thought cache este extensia pentru întreprinderi: stocarea raționamentului dintr-o cerere pentru a-l reutiliza în cereri similare evită ca modelul să recalculeze totul. Mai rămân două cazuri de utilizare legate de guvernanță: auditul, atunci când conformitatea necesită o urmă completă a fiecărui răspuns produs, și depanarea cu suportul xAI, care va solicita raționamentul complet pentru a analiza comportamentul neașteptat.
Stocarea raționamentului criptat
Puteți stoca conținutul criptat ca pe orice alt șir de caractere. Într-o bază de date, un câmp de tip TEXT sau JSONB este suficient:
import json
# Extrageți și stocați raționamentul criptat
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Salvați împreună cu răspunsul
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"
}
Puncte cheie
- Parametrul
include=["reasoning.encrypted_content"]recuperează raționamentul criptat de la modelele de raționament xAI - Fără
include, raționamentul are loc, dar nu este returnat (token-urile sunt totuși facturate) - Conținutul criptat este un bloc opac pe care nu îl puteți citi în text clar
- Puteți stoca și reutiliza acest conținut în cererile ulterioare (în lecția următoare)
- Utilizați
includedoar dacă aveți o utilizare specifică pentru raționamentul criptat