Премини към основното съдържание
Български— Изберете език
Меню

Извличане на криптираните разсъждения с include

Урок 5 от 12 Обновен 28 юли 2026 г. Програмист
На тази страница
  1. Достъп до вътрешните разсъждения на моделите за разсъждения на xAI
  2. Параметърът include
  3. Структура на отговора
  4. Без include: няма разсъждения в отговора
  5. Кога да използвате include
  6. Съхраняване на криптирани разсъждения
  7. Ключови изводи

Достъп до вътрешните разсъждения на моделите за разсъждения на 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 само ако имате конкретна употреба за криптираните разсъждения