Ανάκτηση κρυπτογραφημένου συλλογισμού με το include
Σε αυτήν τη σελίδα
Πρόσβαση στον εσωτερικό συλλογισμό των μοντέλων συλλογισμού της xAI
Τα πρόσφατα μοντέλα συλλογισμού της xAI (οικογένειες grok-4.5, grok-4.20) παράγουν εσωτερικό συλλογισμό τον οποίο δεν μπορείτε να διαβάσετε σε απλό κείμενο. Ωστόσο, η xAI σάς επιτρέπει να ανακτάτε αυτόν τον συλλογισμό σε κρυπτογραφημένη μορφή χρησιμοποιώντας την παράμετρο include. Αυτός ο μηχανισμός καθιστά δυνατές προηγμένες χρήσεις, ιδιαίτερα την επαναχρησιμοποίηση του συλλογισμού σε επόμενα αιτήματα.
Η παράμετρος include
Για να ανακτήσετε το κρυπτογραφημένο περιεχόμενο συλλογισμού, προσθέστε το "reasoning.encrypted_content" στον πίνακα include στο αίτημά σας προς το Responses API:
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort.",
include=["reasoning.encrypted_content"]
)
Δομή απόκρισης
Η απόκριση περιέχει τον κρυπτογραφημένο συλλογισμό σε μια συγκεκριμένη μορφή. Αυτό το περιεχόμενο αποτελεί ένα κωδικοποιημένο blob που μπορείτε να αποθηκεύσετε αλλά όχι να ερμηνεύσετε. Η εσωτερική του δομή είναι εξ ορισμού αδιαφανής.
# Επανάληψη στα στοιχεία της απόκρισης
for item in response.output:
if item.type == "reasoning":
# Κρυπτογραφημένο περιεχόμενο συλλογισμού
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Τελική απόκριση του μοντέλου
print(f"Response: {item.content[0].text}")
Χωρίς include: κανένας συλλογισμός στην απόκριση
Εάν δεν συμπεριλάβετε το "reasoning.encrypted_content" στην παράμετρο include, η απόκριση περιέχει μόνο το τελικό αποτέλεσμα. Ο συλλογισμός λαμβάνει χώρα στην πλευρά του διακομιστή, αλλά δεν επιστρέφεται κανένα ίχνος:
# Χωρίς include - επιστρέφεται μόνο η τελική απόκριση
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# Το response.output περιέχει μόνο το μήνυμα, χωρίς συλλογισμό
Τα tokens συλλογισμού εξακολουθούν να καταμετρώνται και να χρεώνονται, ακόμη και χωρίς το include. Η διαφορά είναι ότι δεν λαμβάνετε το κρυπτογραφημένο περιεχόμενο για μελλοντική επαναχρησιμοποίηση.
Πότε να χρησιμοποιήσετε το include
Η ανάκτηση κρυπτογραφημένου συλλογισμού έχει κόστος —μεγαλύτερες αποκρίσεις, περισσότερο εύρος ζώνης— επομένως χρησιμοποιήστε το include για έναν συγκεκριμένο σκοπό και όχι ως προεπιλογή. Η κύρια περίπτωση χρήσης είναι η συνομιλία πολλαπλών γύρων: εάν σχεδιάζετε να συνεχίσετε την ανταλλαγή, η επανεισαγωγή του συλλογισμού από τον προηγούμενο γύρο διατηρεί τη συνέχεια της σκέψης του μοντέλου. Αυτό διακρίνει μια εξελισσόμενη συνομιλία από μια σειρά ανεξάρτητων ερωτήσεων. Το Thought cache αποτελεί την επέκταση για επιχειρήσεις: η αποθήκευση του συλλογισμού από ένα αίτημα για επαναχρησιμοποίησή του σε παρόμοια αιτήματα αποφεύγει την επανυπολογισμό των πάντων από το μοντέλο. Υπάρχουν δύο ακόμη περιπτώσεις χρήσης διακυβέρνησης: ο έλεγχος (audit), όταν η συμμόρφωση απαιτεί πλήρες ίχνος κάθε παραγόμενης απόκρισης, και η αποσφαλμάτωση με την υποστήριξη της xAI, η οποία θα ζητήσει τον πλήρη συλλογισμό για να αναλύσει απροσδόκητη συμπεριφορά.
Αποθήκευση κρυπτογραφημένου συλλογισμού
Μπορείτε να αποθηκεύσετε το κρυπτογραφημένο περιεχόμενο όπως οποιαδήποτε άλλη συμβολοσειρά. Σε μια βάση δεδομένων, αρκεί ένα πεδίο TEXT ή JSONB:
import json
# Εξαγωγή και αποθήκευση κρυπτογραφημένου συλλογισμού
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Αποθήκευση μαζί με την απόκριση
record = {
"question": "Analyze the complexity of merge sort.",
"response": response.output[-1].content[0].text,
"encrypted_reasoning": reasoning_data,
"model": "grok-4.20-0309-reasoning",
"timestamp": "2026-04-03T10:00:00Z"
}
Βασικά σημεία
- Η παράμετρος
include=["reasoning.encrypted_content"]ανακτά τον κρυπτογραφημένο συλλογισμό από τα μοντέλα συλλογισμού της xAI - Χωρίς το
include, ο συλλογισμός πραγματοποιείται αλλά δεν επιστρέφεται (τα tokens χρεώνονται κανονικά) - Το κρυπτογραφημένο περιεχόμενο είναι ένα αδιαφανές blob που δεν μπορείτε να διαβάσετε σε απλό κείμενο
- Μπορείτε να αποθηκεύσετε και να επαναχρησιμοποιήσετε αυτό το περιεχόμενο σε επόμενα αιτήματα (στο επόμενο μάθημα)
- Χρησιμοποιήστε το
includeμόνο εάν έχετε συγκεκριμένη χρήση για τον κρυπτογραφημένο συλλογισμό