Pridobivanje šifriranega razmišljanja s parametrom include
Na tej strani
Dostop do notranjega razmišljanja modelov xAI
Nedavni modeli za razmišljanje xAI (družini grok-4.5 in grok-4.20) ustvarjajo notranje razmišljanje, ki ga ne moreš brati kot navadno besedilo. Vendar ti xAI omogoča, da to razmišljanje pridobiš v šifrirani obliki z uporabo parametra include. Ta mehanizem omogoča napredne primere uporabe, zlasti ponovno uporabo razmišljanja v poznejših zahtevkih.
Parameter include
Če želiš pridobiti šifrirano vsebino razmišljanja, dodaj "reasoning.encrypted_content" v polje include v svojem zahtevku API za odzive:
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"]
)
Struktura odziva
Odziv vsebuje šifrirano razmišljanje v določeni obliki. Ta vsebina je kodiran blok podatkov, ki ga lahko shraniš, a ne moreš interpretirati. Njegova notranja struktura je namerno neprozorna.
# Iteriraj skozi elemente odziva
for item in response.output:
if item.type == "reasoning":
# Šifrirana vsebina razmišljanja
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Končni odziv modela
print(f"Response: {item.content[0].text}")
Brez parametra include: v odzivu ni razmišljanja
Če v parameter include ne vključiš "reasoning.encrypted_content", odziv vsebuje le končni rezultat. Razmišljanje poteka na strani strežnika, vendar se ne vrne nobena sled:
# Brez include - vrnjen je le končni odziv
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output vsebuje le sporočilo, brez razmišljanja
Žetoni za razmišljanje se še vedno štejejo in zaračunajo, tudi brez parametra include. Razlika je v tem, da ne prejmeš šifrirane vsebine za poznejšo ponovno uporabo.
Kdaj uporabiti include
Pridobivanje šifriranega razmišljanja ima svojo ceno – večji odzivi in večja poraba pasovne širine – zato parameter include uporabi za specifičen namen, ne kot privzeto nastavitev. Primarni primer uporabe je večkratni pogovor: če nameravaš nadaljevati izmenjavo, ponovna vstavitev razmišljanja iz prejšnjega koraka ohrani kontinuiteto razmišljanja modela. To ločuje napredujoč pogovor od niza neodvisnih vprašanj. Predpomnilnik razmišljanja (Thought cache) je razširitev za podjetja: shranjevanje razmišljanja iz zahtevka za ponovno uporabo pri podobnih zahtevkih prepreči, da bi model vse znova izračunal. Ostajata še dva primera uporabe v okviru upravljanja: revizija, ko skladnost zahteva popolno sled vsakega ustvarjenega odziva, in odpravljanje napak s podporo xAI, ki bo zahtevala popolno razmišljanje za analizo nepričakovanega obnašanja.
Shranjevanje šifriranega razmišljanja
Šifrirano vsebino lahko shraniš kot kateri koli drug niz. V zbirki podatkov je dovolj polje tipa TEXT ali JSONB:
import json
# Izloči in shrani šifrirano razmišljanje
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Shrani skupaj z odzivom
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"
}
Ključne ugotovitve
- Parameter
include=["reasoning.encrypted_content"]pridobi šifrirano razmišljanje od modelov za razmišljanje xAI - Brez parametra
includerazmišljanje poteka, vendar ni vrnjeno (žetoni se še vedno zaračunajo) - Šifrirana vsebina je neprozoren blok podatkov, ki ga ne moreš brati kot navadno besedilo
- To vsebino lahko shraniš in ponovno uporabiš v poznejših zahtevkih (v naslednji lekciji)
- Parameter
includeuporabi le, če imaš specifičen namen za šifrirano razmišljanje