Salt la conținutul principal
Română— Alege o limbă
Meniu

Recuperarea raționamentului criptat cu include

Lecția 5 din 12 Actualizată 28 iulie 2026 Dezvoltator
Pe această pagină
  1. Accesarea raționamentului intern al modelelor de raționament xAI
  2. Parametrul include
  3. Structura răspunsului
  4. Fără include: niciun raționament în răspuns
  5. Când să utilizați include
  6. Stocarea raționamentului criptat
  7. Puncte cheie

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 include doar dacă aveți o utilizare specifică pentru raționamentul criptat