Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Recuperar o raciocínio encriptado com include

Aula 5 de 12 Atualizada a 28 de julho de 2026 Programador
Nesta página
  1. Aceder ao raciocínio interno dos modelos de raciocínio da xAI
  2. O parâmetro include
  3. Estrutura da resposta
  4. Sem include: sem raciocínio na resposta
  5. Quando utilizar include
  6. Armazenar o raciocínio encriptado
  7. Pontos-chave

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 include apenas se tiver uma utilização específica para o raciocínio encriptado