Archiviazione e persistenza delle risposte
In questa pagina
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_idper 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: truepersiste la risposta per 30 giorni —store: falsenon conserva nullaGET /v1/responses/{id}recupera una risposta archiviataDELETE /v1/responses/{id}elimina permanentemente una risposta- L’incatenamento tramite
previous_response_idrichiede che la risposta sia archiviata - Le risposte vengono eliminate automaticamente dopo 30 giorni
- Usa
store: falseper i dati sensibili