Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Pridobivanje šifriranega razmišljanja s parametrom include

Lekcija 5 od 12 Posodobljeno 28. julij 2026 Razvijalec
Na tej strani
  1. Dostop do notranjega razmišljanja modelov xAI
  2. Parameter include
  3. Struktura odziva
  4. Brez parametra include: v odzivu ni razmišljanja
  5. Kdaj uporabiti include
  6. Shranjevanje šifriranega razmišljanja
  7. Ključne ugotovitve

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 include razmiš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 include uporabi le, če imaš specifičen namen za šifrirano razmišljanje