Pobieranie zaszyfrowanego rozumowania za pomocą parametru include
Na tej stronie
Dostęp do wewnętrznego rozumowania modeli xAI
Najnowsze modele rozumowania xAI (rodzina grok-4.5, grok-4.20) generują wewnętrzny proces myślowy, którego nie możesz odczytać jako zwykły tekst. xAI umożliwia jednak pobranie tego rozumowania w formie zaszyfrowanej, używając parametru include. Mechanizm ten pozwala na zaawansowane zastosowania, w szczególności na ponowne wykorzystanie rozumowania w kolejnych żądaniach.
Parametr include
Aby pobrać zaszyfrowaną treść rozumowania, dodaj "reasoning.encrypted_content" do tablicy include w swoim żądaniu API Responses:
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 odpowiedzi
Odpowiedź zawiera zaszyfrowane rozumowanie w określonym formacie. Treść ta jest zakodowanym blokiem danych, który możesz przechowywać, ale nie interpretować. Jego wewnętrzna struktura jest celowo nieprzejrzysta.
# Iteracja przez elementy odpowiedzi
for item in response.output:
if item.type == "reasoning":
# Zaszyfrowana treść rozumowania
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Końcowa odpowiedź modelu
print(f"Response: {item.content[0].text}")
Bez parametru include: brak rozumowania w odpowiedzi
Jeśli nie uwzględnisz "reasoning.encrypted_content" w parametrze include, odpowiedź zawiera wyłącznie końcowy wynik. Rozumowanie odbywa się po stronie serwera, ale żaden jego ślad nie jest zwracany:
# Bez include - zwracana jest tylko końcowa odpowiedź
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output zawiera tylko wiadomość, bez rozumowania
Tokeny rozumowania są nadal liczone i rozliczane, nawet bez użycia include. Różnica polega na tym, że nie otrzymujesz zaszyfrowanej treści do późniejszego ponownego wykorzystania.
Kiedy używać parametru include
Pobieranie zaszyfrowanego rozumowania wiąże się z kosztami – większe odpowiedzi, większe zużycie przepustowości – dlatego używaj include w konkretnym celu, a nie domyślnie. Głównym przypadkiem użycia jest konwersacja wieloturowa: jeśli planujesz kontynuować wymianę, ponowne wstrzyknięcie rozumowania z poprzedniego turu zachowuje ciągłość toku myślowego modelu. To odróżnia rozwijającą się rozmowę od serii niezależnych pytań. Pamięć podręczna myśli (Thought cache) to rozszerzenie dla przedsiębiorstw: przechowywanie rozumowania z żądania w celu ponownego wykorzystania go przy podobnych zapytaniach pozwala uniknąć ponownego przeliczania wszystkiego przez model. Pozostają dwa przypadki użycia związane z zarządzaniem: audyt, gdy zgodność z przepisami wymaga pełnego śladu każdej wygenerowanej odpowiedzi, oraz debugowanie z wsparciem xAI, które poprosi o pełne rozumowanie w celu analizy nieoczekiwanego zachowania.
Przechowywanie zaszyfrowanego rozumowania
Możesz przechowywać zaszyfrowaną treść jak dowolny ciąg znaków. W bazie danych wystarczy pole typu TEXT lub JSONB:
import json
# Wyodrębnienie i zapisanie zaszyfrowanego rozumowania
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Zapis wraz z odpowiedzią
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"
}
Kluczowe wnioski
- Parametr
include=["reasoning.encrypted_content"]pobiera zaszyfrowane rozumowanie z modeli rozumowania xAI - Bez
includerozumowanie zachodzi, ale nie jest zwracane (tokeny są nadal rozliczane) - Zaszyfrowana treść to nieprzejrzysty blok danych, którego nie możesz odczytać jako zwykły tekst
- Możesz przechowywać i ponownie wykorzystywać tę treść w kolejnych żądaniach (omówimy to w następnej lekcji)
- Używaj
includetylko wtedy, gdy masz konkretny cel wykorzystania zaszyfrowanego rozumowania