Извличане на криптираните разсъждения с include
На тази страница
Достъп до вътрешните разсъждения на моделите за разсъждения на xAI
Съвременните модели за разсъждения на xAI (семейства grok-4.5, grok-4.20) генерират вътрешни разсъждения, които не можете да прочетете като обикновен текст. Въпреки това, xAI Ви позволява да извлечете тези разсъждения в криптиран вид, използвайки параметъра include. Този механизъм позволява усъвършенствани употреби, по-специално повторното използване на разсъжденията в следващи заявки.
Параметърът include
За да извлечете криптираното съдържание на разсъжденията, добавете "reasoning.encrypted_content" към масива include във Вашата заявка към Responses API:
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"]
)
Структура на отговора
Отговорът съдържа криптираните разсъждения в специфичен формат. Това съдържание е кодиран блок данни (blob), който можете да съхранявате, но не и да интерпретирате. Неговата вътрешна структура е непрозрачна по замисъл.
# Iterate through response elements
for item in response.output:
if item.type == "reasoning":
# Encrypted reasoning content
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Model's final response
print(f"Response: {item.content[0].text}")
Без include: няма разсъждения в отговора
Ако не включите "reasoning.encrypted_content" в параметъра include, отговорът съдържа само крайния резултат. Разсъжденията се извършват от страната на сървъра, но никаква следа не се връща:
# Without include - only the final response is returned
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output contains only the message, no reasoning
Токените за разсъждения все още се броят и таксуват, дори без include. Разликата е, че не получавате криптираното съдържание за по-късно повторно използване.
Кога да използвате include
Извличането на криптирани разсъждения има своята цена – по-големи отговори, повече честотна лента – затова използвайте include за конкретна цел, а не по подразбиране. Основният случай на употреба е многократен разговор: ако планирате да продължите обмена, повторното въвеждане на разсъжденията от предишния ход запазва непрекъснатостта на мисловния процес на модела. Това отличава развиващия се разговор от поредица независими въпроси. Кешът на мисълта (Thought cache) е разширението за предприятия: съхраняването на разсъжденията от заявка за повторната им употреба при подобни заявки избягва необходимостта моделът да преизчислява всичко. Остават два случая на употреба, свързани с управлението: одит, когато съответствието изисква пълна следа от всеки произведен отговор, и отстраняване на грешки с поддръжката на xAI, която ще поиска пълните разсъждения, за да анализира неочаквано поведение.
Съхраняване на криптирани разсъждения
Можете да съхранявате криптираното съдържание като всеки друг низ. В база данни е достатъчно поле от тип TEXT или JSONB:
import json
# Extract and store encrypted reasoning
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Save with the response
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"
}
Ключови изводи
- Параметърът
include=["reasoning.encrypted_content"]извлича криптирани разсъждения от моделите за разсъждения на xAI - Без
includeразсъжденията се извършват, но не се връщат (токените все още се таксуват) - Криптираното съдържание е непрозрачен блок данни, който не можете да прочетете като обикновен текст
- Можете да съхранявате и използвате повторно това съдържание в следващи заявки (в следващия урок)
- Използвайте
includeсамо ако имате конкретна употреба за криптираните разсъждения