Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Archiviazione e persistenza delle risposte

Lezione 6 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Controlla la durata dei tuoi dati
  2. store: true vs store: false
  3. Recuperare una risposta archiviata
  4. Eliminare una risposta
  5. Casi d’uso dell’archiviazione
  6. Periodo di conservazione
  7. Punti chiave

Controlla la durata dei tuoi dati

Le API Responses includono un archivio integrato: impostando store: true, i server xAI conservano le tue risposte per 30 giorni. Puoi recuperarle, visualizzarle ed eliminarle in qualsiasi momento utilizzando endpoint dedicati.

store: true vs store: false

Modalità archiviata (store: true)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Write a summary of this project.",
  "store": true
}

La risposta persiste per 30 giorni. Puoi:

  • Farvi riferimento con previous_response_id per continuare la conversazione
  • Recuperarla successivamente con GET /v1/responses/{id}
  • Eliminarla con DELETE /v1/responses/{id}

Modalità privata (store: false)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this confidential data.",
  "store": false
}

La risposta non viene conservata dopo la richiesta. Ricevi comunque il risultato nella risposta HTTP, ma diventa inaccessibile successivamente. L’incatenamento tramite previous_response_id non è possibile.

Usa store: false per dati sensibili o quando non hai bisogno di continuare la conversazione.

Recuperare una risposta archiviata

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

L’API restituisce l’oggetto risposta completo, identico a quello ricevuto durante la creazione. Questo è utile per:

  • Auditare le interazioni passate
  • Ricostruire una cronologia delle conversazioni
  • Verificare i costi a posteriori

In Python

# Retrieve a stored response
stored = client.responses.retrieve("resp-abc123")
print(stored.output[0].content[0].text)
print(f"Cost: {stored.usage.cost_in_nano_usd / 1e9:.6f} USD")

Eliminare una risposta

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

L’eliminazione è permanente. Se altre risposte collegate fanno riferimento a questa risposta tramite previous_response_id, il contesto corrispondente non sarà più disponibile.

In Python

client.responses.delete("resp-abc123")

Casi d’uso dell’archiviazione

Chatbot con cronologia

Abilita store: true per tutte le richieste. L’utente può riprendere la conversazione anche dopo aver chiuso il browser, purché tu conservi l’ultimo response_id.

Analisi di dati sensibili

Usa store: false per le richieste contenenti dati personali o riservati. La risposta viene elaborata in memoria e non persiste.

Audit e conformità

Recupera le risposte archiviate per costruire registri di audit. Eliminale quando non sono più necessarie per rispettare le politiche di conservazione.

Periodo di conservazione

Le risposte archiviate vengono eliminate automaticamente dopo 30 giorni. Non puoi estendere questo periodo tramite l’API. Se hai bisogno di una cronologia più lunga, salva le risposte nel tuo database.

Punti chiave

  • store: true persiste la risposta per 30 giorni — store: false non conserva nulla
  • GET /v1/responses/{id} recupera una risposta archiviata
  • DELETE /v1/responses/{id} elimina permanentemente una risposta
  • L’incatenamento tramite previous_response_id richiede che la risposta sia archiviata
  • Le risposte vengono eliminate automaticamente dopo 30 giorni
  • Usa store: false per i dati sensibili