Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Získanie šifrovaného uvažovania pomocou parametra include

Lekcia 5 z 12 Aktualizované 28. júla 2026 Vývojár
Na tejto strane
  1. Prístup k internému uvažovaniu modelov xAI
  2. Parameter include
  3. Štruktúra odpovede
  4. Bez parametra include: žiadne uvažovanie v odpovedi
  5. Kedy použiť include
  6. Ukladanie šifrovaného uvažovania
  7. Kľúčové poznatky

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 include uvaž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 include len vtedy, ak máš pre šifrované uvažovanie konkrétny účel