Získanie šifrovaného uvažovania pomocou parametra include
Na tejto strane
Prístup k internému uvažovaniu modelov xAI
Najnovšie modely na uvažovanie od xAI (rodina grok-4.5, grok-4.20) generujú interné uvažovanie, ktoré si nemôžeš prečítať ako obyčajný text. xAI ti však umožňuje získať toto uvažovanie v šifrovanej forme pomocou parametra include. Tento mechanizmus umožňuje pokročilé využitie, najmä opätovné použitie uvažovania v následných požiadavkách.
Parameter include
Ak chceš získať obsah šifrovaného uvažovania, pridaj "reasoning.encrypted_content" do poľa include vo svojej požiadavke API 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"]
)
Štruktúra odpovede
Odpoveď obsahuje šifrované uvažovanie v špecifickom formáte. Tento obsah je zakódovaný blob, ktorý môžeš uložiť, ale nie interpretovať. Jeho vnútorná štruktúra je zámerne nepriehľadná.
# Prechádzanie prvkov odpovede
for item in response.output:
if item.type == "reasoning":
# Šifrovaný obsah uvažovania
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Konečná odpoveď modelu
print(f"Response: {item.content[0].text}")
Bez parametra include: žiadne uvažovanie v odpovedi
Ak do parametra include nezahrnieš "reasoning.encrypted_content", odpoveď bude obsahovať iba konečný výsledok. Uvažovanie prebieha na strane servera, ale žiadna jeho stopa sa nevráti:
# Bez include - vráti sa iba konečná odpoveď
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output obsahuje iba správu, bez uvažovania
Tokeny uvažovania sa stále počítajú a fakturujú, aj keď nepoužiješ include. Rozdiel je v tom, že nedostaneš šifrovaný obsah na neskoršie opätovné použitie.
Kedy použiť include
Získavanie šifrovaného uvažovania so sebou nesie náklady – väčšie odpovede, vyššia spotreba šírky pásma – preto používaj include na konkrétny účel, nie ako predvolené nastavenie. Primárnym prípadom použitia je konverzácia s viacerými kolami: ak plánuješ v výmene pokračovať, opätovné vstreknutie uvažovania z predchádzajúceho kola zachová kontinuitu myšlienkového procesu modelu. To odlišuje prebiehajúcu konverzáciu od série nezávislých otázok. Thought cache je rozšírenie pre podniky: uloženie uvažovania z požiadavky na jeho opätovné použitie pri podobných požiadavkách zabráni modelu všetko znova prepočítavať. Zostávajú dva prípady použitia týkajúce sa správy: audit, keď si dodržiavanie predpisov vyžaduje úplnú stopu každej vyprodukovanej odpovede, a ladenie s podporou xAI, ktorá si vyžiada úplné uvažovanie na analýzu neočakávaného správania.
Ukladanie šifrovaného uvažovania
Šifrovaný obsah môžeš ukladať ako ktorýkoľvek iný reťazec. V databáze stačí pole typu TEXT alebo JSONB:
import json
# Extrakcia a uloženie šifrovaného uvažovania
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Uloženie spolu s odpoveďou
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"
}
Kľúčové poznatky
- Parameter
include=["reasoning.encrypted_content"]získava šifrované uvažovanie z modelov na uvažovanie xAI - Bez
includeuvažovanie prebieha, ale nevracia sa (tokeny sa stále fakturujú) - Šifrovaný obsah je nepriehľadný blob, ktorý si nemôžeš prečítať ako obyčajný text
- Tento obsah môžeš uložiť a opätovne použiť v následných požiadavkách (v ďalšej lekcii)
- Používaj
includelen vtedy, ak máš pre šifrované uvažovanie konkrétny účel