Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Krüpteeritud arutluskäigu hankimine parameetriga include

Õppetund 5 / 12 Värskendatud 28. juuli 2026 Arendajatele
Sellel lehel
  1. xAI arutlusmudelite sisemise arutluskäigu juurdepääs
  2. Parameeter include
  3. Vastuse struktuur
  4. Ilma parameetrita include: vastuses puudub arutluskäik
  5. Millal kasutada parameetrit include
  6. Krüpteeritud arutluskäigu salvestamine
  7. Peamised punktid

xAI arutlusmudelite sisemise arutluskäigu juurdepääs

Hiljutised xAI arutlusmudelid (grok-4.5, grok-4.20 perekond) genereerivad sisemist arutluskäiku, mida sa ei saa lihttekstina lugeda. Siiski võimaldab xAI sul seda arutluskäiku krüpteeritud kujul hankida, kasutades parameetrit include. See mehhanism võimaldab täiustatud kasutusviise, eriti arutluskäigu taaskasutamist järgnevates päringutes.

Parameeter include

Krüpteeritud arutluskäigu sisu hankimiseks lisa "reasoning.encrypted_content" massiivi include oma Responses API päringus:

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"]
)

Vastuse struktuur

Vastus sisaldab krüpteeritud arutluskäiku kindlas vormingus. See sisu on kodeeritud plokk, mida saad salvestada, kuid mitte tõlgendada. Selle sisemine struktuur on tahtlikult läbipaistmatu.

# Itereeri läbi vastuse elementide
for item in response.output:
    if item.type == "reasoning":
        # Krüpteeritud arutluskäigu sisu
        encrypted = item.encrypted_content
        print(f"Encrypted reasoning size: {len(encrypted)} characters")
    elif item.type == "message":
        # Mudeli lõplik vastus
        print(f"Response: {item.content[0].text}")

Ilma parameetrita include: vastuses puudub arutluskäik

Kui sa ei lisa "reasoning.encrypted_content" parameetrisse include, sisaldab vastus ainult lõpptulemust. Arutluskäik toimub serveripoolselt, kuid jälgi ei tagastata:

# Ilma include'ita – tagastatakse ainult lõplik vastus
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze the algorithmic complexity of merge sort."
)
# response.output sisaldab ainult sõnumit, arutluskäiku pole

Arutluskäigu tokeneid loendatakse ja nende eest tasutakse ka siis, kui include puudub. Erinevus seisneb selles, et sa ei saa krüpteeritud sisu hilisemaks taaskasutamiseks kätte.

Millal kasutada parameetrit include

Krüpteeritud arutluskäigu hankimisega kaasneb kulu – suuremad vastused ja rohkem ribalaiust – seega kasuta include kindlal eesmärgil, mitte vaikimisi. Peamine kasutusjuhtum on mitmevooruline vestlus: kui plaanid vahetust jätkata, säilitab eelmise vooru arutluskäigu uuesti sisestamine mudeli mõttekäigu järjepidevuse. See eristab arenevat vestlust sõltumatute küsimuste seeriast. Mõttevahemälu (thought cache) on ettevõtte laiendus: päringu arutluskäigu salvestamine ja selle taaskasutamine sarnaste päringute puhul hoiab ära mudeli poolt kõige uuesti arvutamise. Alles jäävad kaks juhtimise kasutusjuhtumit: audit, kui nõuetele vastavus eeldab iga toodetud vastuse täielikku jälge, ja silumine koos xAI toega, mis nõuab ootamatu käitumise analüüsimiseks kogu arutluskäiku.

Krüpteeritud arutluskäigu salvestamine

Saad krüpteeritud sisu salvestada nagu iganes muud stringi. Andmebaasis piisab väljast TEXT või JSONB:

import json

# Ekstraheeri ja salvesta krüpteeritud arutluskäik
reasoning_data = None
for item in response.output:
    if item.type == "reasoning":
        reasoning_data = item.encrypted_content

# Salvesta koos vastusega
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"
}

Peamised punktid

  • Parameeter include=["reasoning.encrypted_content"] hangib krüpteeritud arutluskäigu xAI arutlusmudelitelt
  • Ilma include'ita arutluskäik toimub, kuid seda ei tagastata (tokenite eest tasutakse siiski)
  • Krüpteeritud sisu on läbipaistmatu plokk, mida sa ei saa lihttekstina lugeda
  • Saad seda sisu salvestada ja taaskasutada järgnevates päringutes (järgmises õppetükis)
  • Kasuta include ainult siis, kui sul on krüpteeritud arutluskäigu jaoks konkreetne kasutusviis