Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Nouda salattu päättely include-parametrilla

Oppitunti 5 / 12 Päivitetty 28. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Käytä xAI:n päättelymallien sisäistä päättelyä
  2. include-parametri
  3. Vastauksen rakenne
  4. Ilman include-parametria: ei päättelyä vastauksessa
  5. Milloin käyttää include-parametria
  6. Salatun päättelyn tallentaminen
  7. Keskeiset asiat

Käytä xAI:n päättelymallien sisäistä päättelyä

Uusimmat xAI:n päättelymallit (grok-4.5, grok-4.20 -perhe) tuottavat sisäistä päättelyä, jota et voi lukea selkokielisenä tekstinä. xAI mahdollistaa kuitenkin tämän päättelyn noutamisen salatussa muodossa käyttämällä include-parametria. Tämä mekanismi mahdollistaa edistyneet käyttötavat, erityisesti päättelyn uudelleenkäytön myöhemmissä pyynnöissä.

include-parametri

Noutaaksesi salatun päättelysisällön lisää "reasoning.encrypted_content" Responses API -pyyntösi include-taulukkoon:

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

Vastauksen rakenne

Vastaus sisältää salatun päättelyn tietyssä muodossa. Tämä sisältö on koodattu bittiavaruus (blob), jonka voit tallentaa mutta et tulkita. Sen sisäinen rakenne on suunnitellusti läpinäkymätön.

# Käy läpi vastauselementit
for item in response.output:
    if item.type == "reasoning":
        # Salattu päättelysisältö
        encrypted = item.encrypted_content
        print(f"Encrypted reasoning size: {len(encrypted)} characters")
    elif item.type == "message":
        # Mallin lopullinen vastaus
        print(f"Response: {item.content[0].text}")

Ilman include-parametria: ei päättelyä vastauksessa

Jos et sisällytä "reasoning.encrypted_content" include-parametriin, vastaus sisältää vain lopputuloksen. Päättely tapahtuu palvelinpuolella, mutta siitä ei palauteta jälkeäkään:

# Ilman include-parametria - vain lopullinen vastaus palautetaan
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze the algorithmic complexity of merge sort."
)
# response.output sisältää vain viestin, ei päättelyä

Päättelytokenit lasketaan ja niistä veloitetaan silti, vaikka include-parametria ei käytettäisi. Ero on siinä, ettet saa salattua sisältöä myöhempää uudelleenkäyttöä varten.

Milloin käyttää include-parametria

Salatun päättelyn noutamiseen liittyy kustannuksia: suuremmat vastaukset ja lisää kaistanleveyttä. Käytä siis include-parametria vain tiettyyn tarkoitukseen, äläkä oletusarvoisesti. Ensisijainen käyttötarkoitus on monivaiheinen keskustelu: jos aiot jatkaa vuorovaikutusta, edellisen vaiheen päättelyn uudelleensyöttäminen säilyttää mallin ajattelun jatkuvuuden. Tämä erottaa etenevän keskustelun itsenäisten kysymysten sarjasta. Thought Cache on yrityslaajennus: pyynnöstä saatavan päättelyn tallentaminen ja sen uudelleenkäyttö samanlaisissa pyynnöissä estää mallia laskemasta kaikkea uudelleen. Kaksi hallintoon liittyvää käyttötapausta jäävät vielä: auditointi, kun vaatimustenmukaisuus edellyttää täydellistä jälkeä jokaisesta tuotetusta vastauksesta, sekä vianetsintä xAI:n tuen kanssa, joka pyytää koko päättelyä analysoidakseen odottamatonta käyttäytymistä.

Salatun päättelyn tallentaminen

Voit tallentaa salatun sisällön kuten minkä tahansa merkkijonon. Tietokannassa TEXT- tai JSONB-kenttä riittää:

import json

# Pura ja tallenna salattu päättely
reasoning_data = None
for item in response.output:
    if item.type == "reasoning":
        reasoning_data = item.encrypted_content

# Tallenna vastauksen kanssa
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"
}

Keskeiset asiat

  • include=["reasoning.encrypted_content"] -parametri noutaa salatun päättelyn xAI:n päättelymalleilta
  • Ilman include-parametria päättely tapahtuu, mutta sitä ei palauteta (tokeneista veloitetaan silti)
  • Salattu sisältö on läpinäkymätön bittiavaruus, jota et voi lukea selkokielisenä tekstinä
  • Voit tallentaa ja uudelleenkäyttää tätä sisältöä myöhemmissä pyynnöissä (seuraavassa oppitunnissa)
  • Käytä include-parametria vain, jos sinulla on erityinen käyttötarkoitus salatulle päättelylle