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

JSON εγγυημένο από σχήμα

Μάθημα 1 / 12 Ενημερώθηκε 28 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Γιατί οι δομημένες έξοδοι αλλάζουν τα πάντα
  2. Πώς λειτουργεί
  3. Διαθεσιμότητα
  4. Χωρίς vs Με Δομημένες Εξόδους
  5. Δύο διαθέσιμες προσεγγίσεις
  6. Βασικά σημεία

Γιατί οι δομημένες έξοδοι αλλάζουν τα πάντα

Όταν χρησιμοποιείτε ένα γλωσσικό μοντέλο σε περιβάλλον παραγωγής, χρειάζεστε απαντήσεις που ο κώδικάς σας μπορεί να αξιοποιήσει άμεσα. Όχι ελεύθερο κείμενο, ούτε κατά προσέγγιση JSON—αλλά JSON εγγυημένα συμβατό με ένα σχήμα που εσείς ορίζετε. Αυτό ακριβώς σας προσφέρουν οι δομημένες έξοδοι του Grok API.

Η αρχή είναι απλή: παρέχετε ένα σχήμα JSON στο μοντέλο και το API εγγυάται ότι η απάντηση θα ακολουθεί αυτή τη δομή ακριβώς. Χωρίς τυχαία ανάλυση (parsing), χωρίς εύθραυστες κανονικές εκφράσεις, χωρίς μπλοκ try/catch για να διαχειριστείτε περιπτώσεις όπου το μοντέλο επινοεί μια δική του μορφή.

Πώς λειτουργεί

Οι δομημένες έξοδοι βασίζονται σε έναν μηχανισμό περιορισμού που εφαρμόζεται κατά τη διάρκεια της δημιουργίας του κειμένου. Σε κάθε token που παράγεται, το μοντέλο περιορίζεται ώστε να δημιουργεί μόνο tokens συμβατά με το παρεχόμενο σχήμα. Το αποτέλεσμα: JSON που είναι πάντα έγκυρο, πάντα συμβατό.

Ας δούμε ένα συγκεκριμένο παράδειγμα. Θέλετε να εξάγετε πληροφορίες επικοινωνίας από ένα email:

from pydantic import BaseModel

class Contact(BaseModel):
    nom: str
    email: str
    entreprise: str
    telephone: str | None

# Η απάντηση θα είναι ΠΑΝΤΑ ένα έγκυρο αντικείμενο Contact

Χωρίς δομημένες εξόδους, το μοντέλο θα μπορούσε να επιστρέψει το τηλέφωνο ως "tel", "phone" ή "numéro". Με ένα σχήμα, το πεδίο θα ονομάζεται πάντα telephone και η τιμή του θα είναι πάντα συμβολοσειρά ή null.

Διαθεσιμότητα

Οι δομημένες έξοδοι υποστηρίζονται σε όλα τα γλωσσικά μοντέλα της xAI: Grok 4.5, Grok 4.3, τις παραλλαγές grok-4.20 και μεταγενέστερες εκδόσεις. Όποιο μοντέλο κι αν χρησιμοποιήσετε, η λειτουργία είναι διαθέσιμη χωρίς επιπλέον κόστος ή πρόσθετη διαμόρφωση.

100%
Εγγυημένα έγκυρο JSON
7
Υποστηριζόμενοι τύποι
Όλα
Τα μοντέλα της xAI
2
Μέθοδοι κλήσης

Χωρίς vs Με Δομημένες Εξόδους

Ιδού τι λαμβάνετε χωρίς και με αυτή τη λειτουργία:

Χωρίς δομημένες εξόδους:

  • Το μοντέλο ενδέχεται να επιστρέψει ελεύθερο κείμενο, μερικό JSON ή μια απροσδόκητη μορφή
  • Πρέπει να κάνετε ανάλυση (parsing) χειροκίνητα και να διαχειριστείτε τα σφάλματα
  • Τα ονόματα των πεδίων ενδέχεται να διαφέρουν από το ένα αίτημα στο άλλο
  • Η ροή εργασίας σας διακόπτεται μόλις το μοντέλο αλλάξει μορφή

Με δομημένες εξόδους:

  • Το JSON είναι πάντα συντακτικά έγκυρο
  • Η δομή ταιριάζει ακριβώς με το παρεχόμενο σχήμα
  • Οι τύποι δεδομένων τηρούνται (συμβολοσειρά, αριθμός, boolean, κ.λπ.)
  • Ο κώδικάς σας μπορεί να καταναλώσει την απάντηση απευθείας

Δύο διαθέσιμες προσεγγίσεις

Το Grok API προσφέρει δύο μεθόδους για τη χρήση δομημένων εξόδων:

  • parse(): Αυτόματη μέθοδος που επιστρέφει απευθείας ένα αντικείμενο με τύπο. Ιδανική για τις περισσότερες περιπτώσεις.
  • response_format: Χειροκίνητη μέθοδος που επιστρέφει μια συμβολοσειρά JSON. Προσφέρει περισσότερο έλεγχο, αλλά η ανάλυση (parsing) επαφίεται σε εσάς.

Θα ανακαλύψετε αυτές τις δύο μεθόδους λεπτομερώς στα επόμενα μαθήματα.

Βασικά σημεία

  • Οι δομημένες έξοδοι εγγυώνται JSON συμβατό με το σχήμα σας σε κάθε κλήση
  • Ο περιορισμός εφαρμόζεται κατά τη διάρκεια της δημιουργίας, όχι εκ των υστέρων
  • Όλα τα γλωσσικά μοντέλα της xAI υποστηρίζουν αυτή τη λειτουργία
  • Διατίθενται δύο μέθοδοι: parse() (αυτόματη) και response_format (χειροκίνητη)
  • Αυτό αποτελεί τη βάση κάθε αξιόπιστης ροής εργασίας παραγωγής με το Grok API