A titkosított gondolkodás lekérése az include paraméterrel
Ezen az oldalon
Az xAI gondolkodó modelljeinek belső gondolkodásához való hozzáférés
A legújabb xAI gondolkodó modellek (grok-4.5, grok-4.20 család) olyan belső gondolkodási folyamatot generálnak, amelyet nem olvashatsz közvetlenül sima szövegként. Az xAI azonban lehetővé teszi ezen gondolatmenet titkosított formában történő lekérését az include paraméter segítségével. Ez a mechanizmus fejlett felhasználási eseteket tesz lehetővé, különösen a gondolatmenet újrahasznosítását a későbbi kérésekben.
Az include paraméter
A titkosított gondolkodási tartalom lekéréséhez add hozzá a "reasoning.encrypted_content" értéket az include tömbhöz a Responses API kérésedben:
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"]
)
A válasz szerkezete
A válasz egy meghatározott formátumban tartalmazza a titkosított gondolkodást. Ez a tartalom egy kódolt adathalmaz (blob), amelyet tárolhatsz, de nem értelmezhetsz. Belső felépítése szándékosan átláthatatlan.
# Iterálás a válasz elemein
for item in response.output:
if item.type == "reasoning":
# Titkosított gondolkodási tartalom
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# A modell végső válasza
print(f"Response: {item.content[0].text}")
Include nélkül: nincs gondolkodás a válaszban
Ha nem adod hozzá a "reasoning.encrypted_content" elemet az include paraméterhez, a válasz csak a végső eredményt tartalmazza. A gondolkodás szerveroldalon megtörténik, de semmilyen nyoma nem kerül visszaadásra:
# Include nélkül – csak a végső válasz érkezik vissza
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# A response.output csak az üzenetet tartalmazza, gondolkodást nem
A gondolkodási tokeneket ilyenkor is megszámolják és számlázzák, még include hiányában is. A különbség csupán annyi, hogy nem kapod meg a titkosított tartalmat a későbbi újrahasznosításhoz.
Mikor használd az include paramétert?
A titkosított gondolkodás lekérése költséggel jár: nagyobb válaszokat és több sávszélességet igényel, ezért csak konkrét céllal használd, ne alapértelmezettként. Az elsődleges felhasználási eset a többmenetes beszélgetés: ha folytatni tervezed a párbeszédet, az előző menettől származó gondolatmenet visszacsatolása megőrzi a modell gondolkodásának folytonosságát. Ez különbözteti meg az előrehaladó beszélgetést a független kérdések sorozatától. A gondolattár (Thought cache) a vállalati kiterjesztés: egy kérésből származó gondolatmenet tárolása és hasonló kéréseknél történő újrahasznosítása elkerüli, hogy a modellnek mindent újra ki kelljen számítania. Két irányítási (governance) felhasználási eset marad: az auditálás, amikor a megfelelőség megköveteli minden egyes generált válasz teljes nyomon követhetőségét, valamint a hibakeresés az xAI támogatásával, amely a váratlan viselkedés elemzéséhez kéri a teljes gondolatmenetet.
A titkosított gondolkodás tárolása
A titkosított tartalmat bármely szöveges adatként tárolhatod. Adatbázisban egy TEXT vagy JSONB mező is elegendő:
import json
# Titkosított gondolkodás kinyerése és tárolása
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Mentés a válasszal együtt
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"
}
Főbb megállapítások
- Az
include=["reasoning.encrypted_content"]paraméterrel lekérheted a titkosított gondolkodást az xAI gondolkodó modelljeitől includenélkül a gondolkodás megtörténik, de nem kerül visszaadásra (a tokeneket ilyenkor is számlázzák)- A titkosított tartalom egy átláthatatlan adathalmaz, amelyet nem olvashatsz sima szövegként
- Ezt a tartalmat tárolhatod és újrahasznosíthatod a későbbi kérésekben (a következő leckében részletezzük)
- Csak akkor használd az
includeparamétert, ha konkrét célod van a titkosított gondolkodással