Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Získání šifrovaného uvažování pomocí include

Lekce 5 z 12 Aktualizováno 28. července 2026 Vývojář
Na této stránce
  1. Přístup k internímu uvažování modelů xAI
  2. Parametr include
  3. Struktura odpovědi
  4. Bez include: žádné uvažování v odpovědi
  5. Kdy použít include
  6. Ukládání šifrovaného uvažování
  7. Klíčové poznatky

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 include k 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 include pouze tehdy, máš-li pro šifrované uvažování konkrétní využití