Responses API: Το αντικείμενο reasoning αναλυτικά
Σε αυτήν τη σελίδα
Το αντικείμενο reasoning στο Responses API
Το Responses API της xAI προσφέρει λεπτομερή έλεγχο πάνω στη συλλογιστική διαδικασία μέσω του αντικειμένου reasoning. Αυτή η παράμετρος διατίθεται αποκλειστικά στο Responses API (όχι στο Chat Completions) και σας επιτρέπει να διαμορφώσετε τρεις πτυχές της συλλογιστικής: την προσπάθεια, τη δημιουργία περίληψης και τη μορφή της περίληψης.
Πλήρης δομή του αντικειμένου reasoning
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Ελέγχει το βάθος της σκέψης του μοντέλου. Υπάρχουν τρεις πιθανές τιμές:
low: ελάχιστη σκέψη, κατάλληλη για απλές εργασίεςmedium: ισορροπία μεταξύ βάθους και ταχύτηταςhigh: μέγιστη σκέψη για πολύπλοκα προβλήματα
Αυτή η παράμετρος αποτελεί το ισοδύναμο του reasoning_effort του Chat Completions στο Responses API, αλλά με την προσθήκη της τιμής medium.
generate_summary
Μιαboolean τιμή (boolean) που υποδεικνύει αν το μοντέλο πρέπει να παράγει μια περίληψη της συλλογιστικής του, επιπλέον της τελικής απάντησης.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Όταν το generate_summary ορίζεται σε true, η απόκριση περιλαμβάνει ένα επιπλέον στοιχείο με μια συνοπτική περίληψη της διαδικασίας συλλογισμού. Αυτή η περίληψη είναι σε απλό κείμενο (plaintext, όχι κρυπτογραφημένο), γεγονός που τη διαφοροποιεί από το reasoning.encrypted_content.
summary
Ελέγχει τη μορφή της παραγόμενης περίληψης. Προς το παρόν, η μόνη τεκμηριωμένη τιμή είναι το "auto", το οποίο επιτρέπει στο μοντέλο να επιλέξει την καταλληλότερη μορφή.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Διαφορά μεταξύ Περίληψης και Κρυπτογραφημένης Συλλογιστικής
Αυτοί οι δύο μηχανισμοί είναι συμπληρωματικοί αλλά διακριτοί:
| Πτυχή | Περίληψη (generate_summary) | Κρυπτογραφημένο (include) |
|---|---|---|
| Αναγνωσιμότητα | Απλό κείμενο, κατανοητό | Κρυπτογραφημένο, αδιαφανές |
| Κύρια χρήση | Εμφάνιση στον χρήστη, έλεγχος (audit) | Επαναχρησιμοποίηση σε επόμενα αιτήματα |
| Ενεργοποίηση | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Λεπτομέρεια | Συνοπτική περίληψη | Πλήρης συλλογιστική |
| Διαθεσιμότητα | Μόνο στο Responses API | Μόνο στο Responses API |
Μπορείτε να ενεργοποιήσετε και τα δύο ταυτόχρονα για να λάβετε τόσο μια αναγνώσιμη περίληψη όσο και την πλήρη κρυπτογραφημένη συλλογιστική:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Demonstrate the infinitude of prime numbers.",
reasoning={
"effort": "high",
"generate_summary": True,
"summary": "auto"
},
include=["reasoning.encrypted_content"]
)
Συνηθισμένοι Συνδυασμοί
Ελάχιστη χρήση: Μόνο Effort
{
"reasoning": {
"effort": "low"
}
}
Το μοντέλο συλλογίζεται με ελάχιστη προσπάθεια. Δεν επιστρέφεται περίληψη ούτε κρυπτογραφημένη συλλογιστική.
Ενδιάμεση χρήση: Effort + Περίληψη
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Το μοντέλο συλλογίζεται και παρέχει μια αναγνώσιμη περίληψη. Ιδανικό για εφαρμογές που επιθυμούν να εμφανίσουν τη διαδικασία σκέψης στον χρήστη.
Πλήρης χρήση: Effort + Περίληψη + Κρυπτογραφημένο
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Μέγιστη διαμόρφωση: βαθιά συλλογιστική, αναγνώσιμη περίληψη και κρυπτογραφημένο περιεχόμενο για επαναχρησιμοποίηση. Κρατήστε το για περιπτώσεις όπου χρειάζεστε τα πάντα.
Πότε να παραλείψετε το αντικείμενο reasoning
Εάν δεν χρειάζεται να ελέγξετε τη συλλογιστική, μπορείτε απλά να παραλείψετε την παράμετρο reasoning. Το μοντέλο θα χρησιμοποιήσει τις προεπιλεγμένες ρυθμίσεις του. Αυτό παραμένει έγκυρο και το μοντέλο θα συνεχίσει να συλλογίζεται (καθώς το grok-4.20-0309-reasoning είναι εξ ορισμού ένα μοντέλο συλλογισμού).
Βασικά σημεία
- Το αντικείμενο
reasoningδιατίθεται μόνο στο Responses API - Το
effortελέγχει το βάθος (low,medium,high) - Το
generate_summaryπαράγει μια αναγνώσιμη περίληψη της συλλογιστικής (απλό κείμενο) - Το
summary: "auto"επιτρέπει στο μοντέλο να επιλέξει τη μορφή της περίληψης - Μπορείτε να συνδυάσετε την περίληψη και την κρυπτογραφημένη συλλογιστική στο ίδιο αίτημα
- Η παράλειψη του
reasoningείναι έγκυρη: το μοντέλο συλλογίζεται με τις προεπιλεγμένες ρυθμίσεις