Conversazioni a catena
In questa pagina
Conversazioni senza gestire la cronologia
Un vantaggio principale delle API Responses è la possibilità di collegare le conversazioni tramite previous_response_id. Invece di reinviare l’intera cronologia a ogni richiesta, passi semplicemente l’ID della risposta precedente. Il server xAI si occupa di ricostruire il contesto completo.
Prima richiesta
Invia il tuo prompt iniziale. Recupera l'ID della risposta (resp-xxx).
Richieste successive
Passa previous_response_id insieme al tuo nuovo messaggio. Il server ricostruisce il contesto.
Conversazione completa
Collega quanti messaggi desideri. Ogni risposta punta a quella precedente.
Esempio completo in Python
from openai import OpenAI
client = OpenAI(
api_key="xai-...",
base_url="https://api.x.ai/v1"
)
# Turno 1: Introduzione
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
instructions="Sei un insegnante di matematica paziente e chiaro.",
input="Ciao, vorrei capire le derivate."
)
print(response1.output[0].content[0].text)
# Turno 2: Il modello ricorda il contesto
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Puoi farmi un esempio concreto?",
previous_response_id=response1.id
)
print(response2.output[0].content[0].text)
# Turno 3: Approfondimento
response3 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="E come calcolo la derivata di x² + 3x?",
previous_response_id=response2.id
)
print(response3.output[0].content[0].text)
Nota che ogni richiesta dopo la prima contiene solo il nuovo messaggio e il riferimento alla risposta precedente. Il server xAI ricostruisce automaticamente l’intera cronologia.
Equivalente curl
# Turno 1
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.20-0309-reasoning",
"input": "Ciao, spiegami le basi di Python."
}'
# Recupera l'ID dalla risposta: "id": "resp-abc123"
# Turno 2
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.20-0309-reasoning",
"input": "Come si scrive un ciclo for?",
"previous_response_id": "resp-abc123"
}'
Catena e istruzioni
Le instructions (prompt di sistema) definite nella prima richiesta persistono per tutta la conversazione a catena. Non devi ripeterle.
Se modifichi instructions in una richiesta concatenata, le nuove istruzioni sostituiscono quelle precedenti per quella richiesta e per le successive.
Limiti della concatenazione
- La risposta di riferimento deve esistere sul server (o
store: trueo una richiesta recente) - La concatenazione accumula token di cronologia: ogni richiesta viene addebitata per l’intera conversazione
- Non c’è limite al numero di turni, ma si applica la finestra di contesto del modello
Punti chiave
previous_response_idcollega le conversazioni senza reinviare la cronologia- Il server ricostruisce automaticamente il contesto completo
- Le istruzioni di sistema persistono da un turno all’altro
- Ogni turno viene addebitato per l’intera cronologia accumulata
- La risposta di riferimento deve essere stata archiviata sul server