Vai al contenuto principale
Italiano— Scegli una lingua
Menu

GET e DELETE: Gestione delle risposte

Lezione 7 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Oltre la creazione
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Best Practices
  5. Punti chiave

Oltre la creazione

Le API Responses non si limitano alla creazione di risposte. Due endpoint complementari ti permettono di recuperare ed eliminare le risposte archiviate. Queste operazioni sono essenziali per costruire applicazioni robuste con gestione della cronologia.

GET /v1/responses/{id}

Recuperare una risposta

curl https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

L’API restituisce esattamente lo stesso oggetto JSON creato durante la generazione:

{
  "id": "resp-abc123def456",
  "object": "response",
  "created_at": 1712000000,
  "status": "completed",
  "model": "grok-4.20-0309-reasoning",
  "output": [...],
  "usage": {...}
}

Casi d’uso pratici

Ripresa della conversazione: La tua applicazione archivia l’ultimo response_id nella sessione utente. Al momento della riconnessione, recuperi la risposta per visualizzare il contesto precedente.

# L'utente torna dopo una pausa
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Visualizza l'ultimo scambio
print(f"Ultima risposta: {previous.output[0].content[0].text[:200]}...")

# Prosegui la conversazione
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Dove eravamo rimasti?",
    previous_response_id=last_response_id
)

Audit dei costi: Itera attraverso le tue risposte archiviate per analizzare il consumo per utente o funzionalità.

response = client.responses.retrieve("resp-abc123")
cost_usd = response.usage.cost_in_nano_usd / 1e9
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens
print(f"Costo: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")

Gestione degli errori

Se la risposta non esiste (eliminata o scaduta), l’API restituisce un errore 404:

{
  "error": {
    "message": "Response not found",
    "type": "not_found_error"
  }
}

Gestisci questo caso nel tuo codice:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Risposta non trovata: {e}")
    # Avvia una nuova conversazione

DELETE /v1/responses/{id}

Eliminare una risposta

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

L’eliminazione restituisce uno stato 200 in caso di successo. L’operazione è irreversibile.

Impatto sulle conversazioni concatenate

Quando elimini una risposta referenziata da altre tramite previous_response_id, il contesto di quella risposta scompare dalla catena. Le risposte successive non vengono eliminate, ma perdono l’accesso al contesto precedente.

resp-1 → resp-2 → resp-3 → resp-4
         ↑ eliminata

Se elimini resp-2, resp-3 e resp-4 esistono ancora, ma il contesto di resp-1 e resp-2 non è più accessibile per nuove richieste concatenate.

Pulizia automatizzata

Per le applicazioni in produzione, implementa una pulizia periodica:

import datetime

def cleanup_old_responses(response_ids, max_age_days=7):
    for rid in response_ids:
        try:
            resp = client.responses.retrieve(rid)
            age = datetime.datetime.now().timestamp() - resp.created_at
            if age > max_age_days * 86400:
                client.responses.delete(rid)
                print(f"Eliminata: {rid}")
        except Exception:
            pass  # Già eliminata o scaduta

Best Practices

  • Archivia gli ID: mantieni i response_id nel tuo database insieme ai metadati della conversazione
  • Pulisci regolarmente: non aspettare la scadenza automatica di 30 giorni per i dati sensibili
  • Gestisci i 404: una risposta può scomparire tra una richiesta e l’altra (scadenza, eliminazione manuale)
  • Documenta le tue catene: per il debug, traccia i collegamenti previous_response_id tra le tue risposte

Punti chiave

  • GET /v1/responses/{id} recupera una risposta con tutto il suo contenuto e i metadati
  • DELETE /v1/responses/{id} elimina permanentemente una risposta: operazione irreversibile
  • L’eliminazione di una risposta intermedia interrompe il contesto della catena di conversazione
  • Gestisci gli errori 404: le risposte scadono automaticamente dopo 30 giorni
  • Mantieni i response_id nel tuo database per la tracciabilità