Ragionamento crittografato
In questa pagina
- Ragionamento interno nei modelli Grok
- Perché il ragionamento è crittografato?
- Recupero del ragionamento crittografato
- Riutilizzo del ragionamento in una conversazione
- Ragionamento crittografato vs concatenazione classica
- Quando utilizzare il ragionamento crittografato?
- Impatto sulla fatturazione
- Punti chiave
Ragionamento interno nei modelli Grok
I recenti modelli di ragionamento (come grok-4.20-0309-reasoning) eseguono un ragionamento interno prima di generare la risposta. Questo processo di pensiero, normalmente invisibile, può essere recuperato in forma crittografata utilizzando il parametro include. Puoi quindi reinserirlo nelle richieste successive per mantenere la continuità del ragionamento.
Perché il ragionamento è crittografato?
Il ragionamento interno contiene il processo di pensiero grezzo del modello: passaggi intermedi, ipotesi testate, percorsi abbandonati. xAI crittografa questi contenuti per due motivi:
- Proprietà intellettuale: il ragionamento rivela il funzionamento interno del modello
- Continuità: il contenuto crittografato può essere riutilizzato dal modello per riprendere il suo processo di pensiero
Non puoi leggere il contenuto crittografato, ma il modello può decifrarlo e utilizzarlo.
Recupero del ragionamento crittografato
Aggiungi include=["reasoning.encrypted_content"] alla tua richiesta:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this problem: if a train leaves Paris at 2 PM at 200 km/h "
"and another from Lyon at 3 PM at 300 km/h, when do they meet?",
include=["reasoning.encrypted_content"]
)
La risposta conterrà un campo aggiuntivo con il ragionamento crittografato:
{
"output": [
{
"type": "reasoning",
"encrypted_content": "eyJhbGciOiJSU0EtT0FFUCIsImVuYyI6..."
},
{
"type": "message",
"content": [{"type": "output_text", "text": "The two trains meet at..."}]
}
]
}
Riutilizzo del ragionamento in una conversazione
Il vantaggio principale del ragionamento crittografato è la possibilità di reinserirlo nelle richieste successive. Questo permette al modello di riprendere esattamente da dove aveva interrotto il suo processo di pensiero:
# Richiesta 1: problema iniziale
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Prove that the square root of 2 is irrational.",
include=["reasoning.encrypted_content"]
)
# Estrazione del ragionamento crittografato
encrypted = None
for item in response1.output:
if item.type == "reasoning":
encrypted = item.encrypted_content
break
# Richiesta 2: approfondimento mantenendo il ragionamento
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Can you generalize this proof to roots of prime numbers?",
previous_response_id=response1.id,
include=["reasoning.encrypted_content"]
)
Ragionamento crittografato vs concatenazione classica
| Approccio | Contesto testuale | Continuità del ragionamento |
|---|---|---|
Solo previous_response_id | Sì | No — il modello riavvia il suo ragionamento |
previous_response_id + ragionamento crittografato | Sì | Sì — il modello riprende la sua catena di pensiero |
La differenza è sottile ma importante per compiti di ragionamento complessi. Con il contenuto crittografato, il modello non si limita a rileggere il contesto: riprende il suo processo di pensiero interno.
Quando utilizzare il ragionamento crittografato?
Consigliato
Il filo conduttore di questi casi d’uso è sempre lo stesso: una conversazione in cui il turno N+1 deve basarsi sul ragionamento del turno N. Un problema matematico risolto in più passaggi perde ogni coerenza se il modello dimentica il suo percorso tra due messaggi; un’analisi logica condotta attraverso approfondimenti successivi ha bisogno delle sue ipotesi intermedie; il debug iterativo («cosa succede se testiamo con questo valore?») ha senso solo se il modello ricorda ciò che ha già eliminato. Più in generale, non appena noti che la qualità del ragionamento degrada da un turno all’altro nelle tue conversazioni, questo è il segnale che il contesto di ragionamento è andato perso: reiniettare il ragionamento crittografato è proprio la soluzione.
Non necessario
- Conversazioni semplici (domande e risposte fattuali)
- Generazione di contenuti creativi
- Compiti che non richiedono un ragionamento strutturato
Impatto sulla fatturazione
I token di ragionamento crittografato sono conteggiati in output_tokens_details.reasoning_tokens. Sono fatturati alla stessa tariffa dei token di output standard. Il volume di ragionamento può essere significativo, talvolta da 2 a 5 volte superiore alla risposta visibile.
Punti chiave
- Il ragionamento crittografato si recupera con
include=["reasoning.encrypted_content"] - Il contenuto è crittografato: non puoi leggerlo, ma il modello può riutilizzarlo
- Combinato con
previous_response_id, mantiene la continuità della catena di pensiero - Utile per compiti di ragionamento complessi in più passaggi
- I token di ragionamento sono fatturati anche se invisibili nella risposta