GET και DELETE: Διαχείριση Απαντήσεων
Σε αυτήν τη σελίδα
Πέρα από τη Δημιουργία
Το API Απαντήσεων (Responses API) δεν περιορίζεται μόνο στη δημιουργία απαντήσεων. Δύο συμπληρωματικά τελικά σημεία (endpoints) σας επιτρέπουν να ανακτάτε και να διαγράφετε αποθηκευμένες απαντήσεις. Αυτές οι λειτουργίες είναι απαραίτητες για τη δημιουργία εύρωστων εφαρμογών με διαχείριση ιστορικού.
GET /v1/responses/{id}
Ανάκτηση Μιας Απάντησης
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Το API επιστρέφει ακριβώς το ίδιο αντικείμενο JSON όπως κατά τη δημιουργία:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Πρακτικές Περιπτώσεις Χρήσης
Επανέναρξη Συνομιλίας: Η εφαρμογή σας αποθηκεύει το τελευταίο response_id στη συνεδρία του χρήστη. Κατά την επανασύνδεση, ανακτάτε την απάντηση για να εμφανίσετε το προηγούμενο πλαίσιο.
# Ο χρήστης επιστρέφει μετά από διάλειμμα
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Εμφάνιση της τελευταίας ανταλλαγής
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Συνέχεια της συνομιλίας
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Έλεγχος Κόστους: Διατρέξτε τις αποθηκευμένες απαντήσεις σας για να αναλύσετε την κατανάλωση ανά χρήστη ή λειτουργία.
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"Cost: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")
Διαχείριση Σφαλμάτων
Εάν η απάντηση δεν υπάρχει (διαγράφηκε ή έληξε), το API επιστρέφει σφάλμα 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Χειριστείτε αυτή την περίπτωση στον κώδικά σας:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Έναρξη νέας συνομιλίας
DELETE /v1/responses/{id}
Διαγραφή Μιας Απάντησης
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Η διαγραφή επιστρέφει κωδικό κατάστασης 200 σε περίπτωση επιτυχίας. Η λειτουργία είναι μη αναστρέψιμη.
Επίπτωση στις Αλυσιδωτές Συνομιλίες
Όταν διαγράφετε μια απάντηση στην οποία αναφέρονται άλλες μέσω του previous_response_id, το πλαίσιο εκείνης της απάντησης εξαφανίζεται από την αλυσίδα. Οι επόμενες απαντήσεις δεν διαγράφονται, αλλά χάνουν την πρόσβαση στο προηγούμενο πλαίσιο.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Εάν διαγράψετε το resp-2, τα resp-3 και resp-4 εξακολουθούν να υπάρχουν, αλλά το πλαίσιο από τα resp-1 και resp-2 δεν είναι πλέον προσβάσιμο για νέα αλυσιδωτά αιτήματα.
Αυματοποιημένος Καθαρισμός
Για εφαρμογές παραγωγής, υλοποιήστε περιοδικό καθαρισμό:
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"Deleted: {rid}")
except Exception:
pass # Ήδη διαγράφηκε ή έληξε
Βέλτιστες Πρακτικές
- Αποθήκευση IDs: κρατήστε τα
response_ids στη βάση δεδομένων σας μαζί με τα μεταδεδομένα της συνομιλίας. - Τακτικός καθαρισμός: μην περιμένετε την αυτόματη λήξη των 30 ημερών για ευαίσθητα δεδομένα.
- Διαχείριση 404s: μια απάντηση μπορεί να εξαφανιστεί μεταξύ των αιτημάτων (λήξη, χειροκίνητη διαγραφή).
- Τεκμηρίωση των αλυσίδων σας: για αποσφαλμάτωση, εντοπίστε τους συνδέσμους
previous_response_idμεταξύ των απαντήσεών σας.
Βασικά σημεία
- Το
GET /v1/responses/{id}ανακτά μια απάντηση με όλο το περιεχόμενο και τα μεταδεδομένα της. - Το
DELETE /v1/responses/{id}διαγράφει οριστικά μια απάντηση—μη αναστρέψιμη λειτουργία. - Η διαγραφή μιας ενδιάμεσης απάντησης διακόπτει το πλαίσιο της αλυσίδας συνομιλίας.
- Χειριστείτε τα σφάλματα 404: οι απαντήσεις λήγουν αυτόματα μετά από 30 ημέρες.
- Κρατήστε τα
response_ids στη δική σας βάση δεδομένων για ιχνηλασιμότητα.