Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Responses API: Το αντικείμενο reasoning αναλυτικά

Μάθημα 7 / 12 Ενημερώθηκε 28 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το αντικείμενο reasoning στο Responses API
  2. Πλήρης δομή του αντικειμένου reasoning
  3. Διαφορά μεταξύ Περίληψης και Κρυπτογραφημένης Συλλογιστικής
  4. Συνηθισμένοι Συνδυασμοί
  5. Πότε να παραλείψετε το αντικείμενο reasoning
  6. Βασικά σημεία

Το αντικείμενο 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: trueinclude: ["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 είναι έγκυρη: το μοντέλο συλλογίζεται με τις προεπιλεγμένες ρυθμίσεις