Nouda salattu päättely include-parametrilla
Tällä sivulla
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