Przejdź do głównej treści
Polski— Wybierz język
Menu

Pobieranie zaszyfrowanego rozumowania za pomocą parametru include

Lekcja 5 z 12 Zaktualizowano 28 lipca 2026 Programista
Na tej stronie
  1. Dostęp do wewnętrznego rozumowania modeli xAI
  2. Parametr include
  3. Struktura odpowiedzi
  4. Bez parametru include: brak rozumowania w odpowiedzi
  5. Kiedy używać parametru include
  6. Przechowywanie zaszyfrowanego rozumowania
  7. Kluczowe wnioski

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 include rozumowanie 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 include tylko wtedy, gdy masz konkretny cel wykorzystania zaszyfrowanego rozumowania