JSON εγγυημένο από σχήμα
Σε αυτήν τη σελίδα
Γιατί οι δομημένες έξοδοι αλλάζουν τα πάντα
Όταν χρησιμοποιείτε ένα γλωσσικό μοντέλο σε περιβάλλον παραγωγής, χρειάζεστε απαντήσεις που ο κώδικάς σας μπορεί να αξιοποιήσει άμεσα. Όχι ελεύθερο κείμενο, ούτε κατά προσέγγιση 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 και μεταγενέστερες εκδόσεις. Όποιο μοντέλο κι αν χρησιμοποιήσετε, η λειτουργία είναι διαθέσιμη χωρίς επιπλέον κόστος ή πρόσθετη διαμόρφωση.
Χωρίς vs Με Δομημένες Εξόδους
Ιδού τι λαμβάνετε χωρίς και με αυτή τη λειτουργία:
Χωρίς δομημένες εξόδους:
- Το μοντέλο ενδέχεται να επιστρέψει ελεύθερο κείμενο, μερικό JSON ή μια απροσδόκητη μορφή
- Πρέπει να κάνετε ανάλυση (parsing) χειροκίνητα και να διαχειριστείτε τα σφάλματα
- Τα ονόματα των πεδίων ενδέχεται να διαφέρουν από το ένα αίτημα στο άλλο
- Η ροή εργασίας σας διακόπτεται μόλις το μοντέλο αλλάξει μορφή
Με δομημένες εξόδους:
- Το JSON είναι πάντα συντακτικά έγκυρο
- Η δομή ταιριάζει ακριβώς με το παρεχόμενο σχήμα
- Οι τύποι δεδομένων τηρούνται (συμβολοσειρά, αριθμός, boolean, κ.λπ.)
- Ο κώδικάς σας μπορεί να καταναλώσει την απάντηση απευθείας
Δύο διαθέσιμες προσεγγίσεις
Το Grok API προσφέρει δύο μεθόδους για τη χρήση δομημένων εξόδων:
parse(): Αυτόματη μέθοδος που επιστρέφει απευθείας ένα αντικείμενο με τύπο. Ιδανική για τις περισσότερες περιπτώσεις.response_format: Χειροκίνητη μέθοδος που επιστρέφει μια συμβολοσειρά JSON. Προσφέρει περισσότερο έλεγχο, αλλά η ανάλυση (parsing) επαφίεται σε εσάς.
Θα ανακαλύψετε αυτές τις δύο μεθόδους λεπτομερώς στα επόμενα μαθήματα.
Βασικά σημεία
- Οι δομημένες έξοδοι εγγυώνται JSON συμβατό με το σχήμα σας σε κάθε κλήση
- Ο περιορισμός εφαρμόζεται κατά τη διάρκεια της δημιουργίας, όχι εκ των υστέρων
- Όλα τα γλωσσικά μοντέλα της xAI υποστηρίζουν αυτή τη λειτουργία
- Διατίθενται δύο μέθοδοι:
parse()(αυτόματη) καιresponse_format(χειροκίνητη) - Αυτό αποτελεί τη βάση κάθε αξιόπιστης ροής εργασίας παραγωγής με το Grok API