Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Recupera il ragionamento crittografato con include

Lezione 5 di 12 Aggiornata il 28 luglio 2026 Sviluppatore
In questa pagina
  1. Accedi al ragionamento interno dei modelli di ragionamento xAI
  2. Il parametro include
  3. Struttura della risposta
  4. Senza include: nessun ragionamento nella risposta
  5. Quando usare include
  6. Archiviazione del ragionamento crittografato
  7. Punti chiave

Accedi al ragionamento interno dei modelli di ragionamento xAI

I recenti modelli di ragionamento xAI (famiglie grok-4.5, grok-4.20) generano un ragionamento interno che non puoi leggere in testo semplice. Tuttavia, xAI ti permette di recuperare questo ragionamento in forma crittografata utilizzando il parametro include. Questo meccanismo abilita usi avanzati, in particolare il riutilizzo del ragionamento nelle richieste successive.

Il parametro include

Per recuperare il contenuto del ragionamento crittografato, aggiungi "reasoning.encrypted_content" all’array include nella tua richiesta alle 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"]
)

Struttura della risposta

La risposta contiene il ragionamento crittografato in un formato specifico. Questo contenuto è un blob codificato che puoi archiviare ma non interpretare. La sua struttura interna è opaca per progettazione.

# Itera attraverso gli elementi della risposta
for item in response.output:
    if item.type == "reasoning":
        # Contenuto del ragionamento crittografato
        encrypted = item.encrypted_content
        print(f"Encrypted reasoning size: {len(encrypted)} characters")
    elif item.type == "message":
        # Risposta finale del modello
        print(f"Response: {item.content[0].text}")

Senza include: nessun ragionamento nella risposta

Se non includi "reasoning.encrypted_content" nel parametro include, la risposta contiene solo il risultato finale. Il ragionamento avviene lato server, ma non viene restituita alcuna traccia:

# Senza include - viene restituita solo la risposta finale
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze the algorithmic complexity of merge sort."
)
# response.output contiene solo il messaggio, nessun ragionamento

I token di ragionamento vengono comunque conteggiati e fatturati, anche senza include. La differenza è che non ricevi il contenuto crittografato per un successivo riutilizzo.

Quando usare include

Il recupero del ragionamento crittografato ha un costo: risposte più grandi e maggiore bandwidth. Usa quindi include per uno scopo specifico, non come impostazione predefinita. Il caso d’uso principale è la conversazione multi-turno: se prevedi di continuare lo scambio, reiniettare il ragionamento dal turno precedente preserva la continuità del pensiero del modello. Questo distingue una conversazione in evoluzione da una serie di domande indipendenti. La thought cache è l’estensione enterprise: archiviare il ragionamento di una richiesta per riutilizzarlo su richieste simili evita che il modello ricalcoli tutto. Restano due casi d’uso di governance: l’audit, quando la conformità richiede una traccia completa di ogni risposta prodotta, e il debug con il supporto xAI, che richiederà il ragionamento completo per analizzare comportamenti inaspettati.

Archiviazione del ragionamento crittografato

Puoi archiviare il contenuto crittografato come una qualsiasi stringa. In un database, è sufficiente un campo TEXT o JSONB:

import json

# Estrai e archivia il ragionamento crittografato
reasoning_data = None
for item in response.output:
    if item.type == "reasoning":
        reasoning_data = item.encrypted_content

# Salva insieme alla risposta
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"
}

Punti chiave

  • Il parametro include=["reasoning.encrypted_content"] recupera il ragionamento crittografato dai modelli di ragionamento xAI
  • Senza include, il ragionamento avviene ma non viene restituito (i token vengono comunque fatturati)
  • Il contenuto crittografato è un blob opaco che non puoi leggere in testo semplice
  • Puoi archiviare e riutilizzare questo contenuto nelle richieste successive (nella prossima lezione)
  • Usa include solo se hai un uso specifico per il ragionamento crittografato