Získání šifrovaného uvažování pomocí include
Na této stránce
Přístup k internímu uvažování modelů xAI
Nejnovější modely pro uvažování od xAI (rodina grok-4.5, grok-4.20) generují interní uvažování, které nelze číst jako prostý text. xAI ti však umožňuje toto uvažování získat v šifrované podobě pomocí parametru include. Tento mechanismus umožňuje pokročilé využití, zejména opětovné použití uvažování v následujících požadavcích.
Parametr include
Chceš-li získat šifrovaný obsah uvažování, přidej "reasoning.encrypted_content" do pole include ve svém požadavku na 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"]
)
Struktura odpovědi
Odpověď obsahuje šifrované uvažování ve specifickém formátu. Tento obsah je zakódovaný blob, který můžeš uložit, ale nemůžeš jej interpretovat. Jeho vnitřní struktura je záměrně neprůhledná.
# Iterace prvky odpovědi
for item in response.output:
if item.type == "reasoning":
# Šifrovaný obsah uvažování
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Konečná odpověď modelu
print(f"Response: {item.content[0].text}")
Bez include: žádné uvažování v odpovědi
Pokud do parametru include nezahrneš "reasoning.encrypted_content", odpověď bude obsahovat pouze konečný výsledek. K uvažování sice dojde na straně serveru, ale žádná jeho stopa se nevrátí:
# Bez include - vrátí se pouze konečná odpověď
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output obsahuje pouze zprávu, žádné uvažování
Tokeny uvažování se stále počítají a účtují, i když nepoužiješ include. Rozdíl spočívá v tom, že nedostaneš šifrovaný obsah pro pozdější opětovné použití.
Kdy použít include
Získávání šifrovaného uvažování má svou cenu – větší odpovědi, vyšší spotřeba šířky pásma – proto používej include pro konkrétní účel, nikoliv jako výchozí nastavení. Hlavním případem použití je vícekolová konverzace: pokud plánuješ ve výměně pokračovat, opětovné vložení uvažování z předchozího kola zachovává kontinuitu myšlenkového procesu modelu. To odlišuje probíhající konverzaci od série nezávislých otázek. Thought cache je rozšířením pro podniky: ukládání uvažování z požadavku pro jeho opětovné použití u podobných požadavků zabrání modelu v opětovném výpočtu všeho. Zůstávají dva případy použití související se správou: audit, kdy compliance vyžaduje úplnou stopu každé vytvořené odpovědi, a ladění s podporou xAI, která si vyžádá úplné uvažování pro analýzu neočekávaného chování.
Ukládání šifrovaného uvažování
Šifrovaný obsah můžeš ukládat jako běžný řetězec. V databázi postačí pole typu TEXT nebo JSONB:
import json
# Extrakce a uložení šifrovaného uvažování
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Uložení spolu s odpovědí
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"
}
Klíčové poznatky
- Parametr
include=["reasoning.encrypted_content"]získává šifrované uvažování z modelů pro uvažování xAI - Bez
includek uvažování dochází, ale není vráceno (tokeny se stále účtují) - Šifrovaný obsah je neprůhledný blob, který nelze číst jako prostý text
- Tento obsah můžeš uložit a znovu použít v následujících požadavcích (v další lekci)
- Používej
includepouze tehdy, máš-li pro šifrované uvažování konkrétní využití