Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Conversazioni a catena

Lezione 5 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Conversazioni senza gestire la cronologia
  2. Esempio completo in Python
  3. Equivalente curl
  4. Catena e istruzioni
  5. Limiti della concatenazione
  6. Punti chiave

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.

1

Prima richiesta

Invia il tuo prompt iniziale. Recupera l'ID della risposta (resp-xxx).

2

Richieste successive

Passa previous_response_id insieme al tuo nuovo messaggio. Il server ricostruisce il contesto.

3

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: true o 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_id collega 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