Recuperar o raciocínio encriptado com include
Nesta página
Aceder ao raciocínio interno dos modelos de raciocínio da xAI
Os modelos de raciocínio recentes da xAI (famílias grok-4.5 e grok-4.20) geram um raciocínio interno que não consegue ler em texto simples. No entanto, a xAI permite recuperar esse raciocínio sob forma encriptada utilizando o parâmetro include. Este mecanismo possibilita utilizações avançadas, nomeadamente a reutilização do raciocínio em pedidos subsequentes.
O parâmetro include
Para recuperar o conteúdo do raciocínio encriptado, adicione "reasoning.encrypted_content" ao array include no seu pedido à API de Respostas:
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"]
)
Estrutura da resposta
A resposta contém o raciocínio encriptado num formato específico. Este conteúdo é um bloco codificado que pode armazenar, mas não interpretar. A sua estrutura interna é opaca por conceção.
# Iterar pelos elementos da resposta
for item in response.output:
if item.type == "reasoning":
# Conteúdo do raciocínio encriptado
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Resposta final do modelo
print(f"Response: {item.content[0].text}")
Sem include: sem raciocínio na resposta
Se não incluir "reasoning.encrypted_content" no parâmetro include, a resposta contém apenas o resultado final. O raciocínio ocorre no lado do servidor, mas nenhum vestígio é devolvido:
# Sem include - apenas a resposta final é devolvida
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output contém apenas a mensagem, sem raciocínio
Os tokens de raciocínio continuam a ser contados e faturados, mesmo sem o include. A diferença reside no facto de não receber o conteúdo encriptado para reutilização posterior.
Quando utilizar include
A recuperação do raciocínio encriptado tem um custo — respostas maiores, maior largura de banda — por isso, utilize o include para um propósito específico e não por defeito. O caso de uso principal é a conversação em várias turnos: se planeia continuar a troca, reinjetar o raciocínio do turno anterior preserva a continuidade do pensamento do modelo. Isto distingue uma conversa em progresso de uma série de perguntas independentes. A cache de pensamento é a extensão empresarial: armazenar o raciocínio de um pedido para o reutilizar em pedidos semelhantes evita que o modelo tenha de recalcular tudo. Restam dois casos de uso de governança: a auditoria, quando a conformidade exige um registo completo de cada resposta produzida, e a depuração com o suporte da xAI, que solicitará o raciocínio completo para analisar comportamentos inesperados.
Armazenar o raciocínio encriptado
Pode armazenar o conteúdo encriptado como qualquer outra cadeia de caracteres. Numa base de dados, um campo TEXT ou JSONB é suficiente:
import json
# Extrair e armazenar o raciocínio encriptado
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Guardar juntamente com a resposta
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"
}
Pontos-chave
- O parâmetro
include=["reasoning.encrypted_content"]recupera o raciocínio encriptado dos modelos de raciocínio da xAI - Sem o
include, o raciocínio ocorre mas não é devolvido (os tokens são faturados na mesma) - O conteúdo encriptado é um bloco opaco que não consegue ler em texto simples
- Pode armazenar e reutilizar este conteúdo em pedidos subsequentes (na próxima lição)
- Utilize o
includeapenas se tiver uma utilização específica para o raciocínio encriptado