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

Αυτόματη μέθοδος parse()

Μάθημα 4 / 12 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Η γρήγορη διαδρομή: parse()
  2. Πλήρες παράδειγμα
  3. Τι επιστρέφει το parse()
  4. Ένθετα μοντέλα
  5. Πότε να χρησιμοποιήσετε το parse()
  6. Βασικά σημεία

Ενημερώθηκε στις 3 Νοεμβρίου 2026. Με βάση την τεκμηρίωση Structured Outputs της xAI και το openai SDK 3.42.1: όταν το OpenAI SDK δείχνει στην xAI, η μέθοδος είναι client.chat.completions.parse, η οποία επιστρέφει μια ολοκλήρωση όπου το typed object διαβάζεται από το choices[0].message.parsed· το client.chat.parse δεν υπάρχει (το xAI SDK προσφέρει ωστόσο το chat.parse(Schema) σε μια συνομιλία, το οποίο επιστρέφει ένα ζεύγος response-object). Πηγή: Structured Outputs.

Η γρήγορη διαδρομή: parse()

Η μέθοδος parse() είναι ο απλούστερος τρόπος χρήσης δομημένων εξόδων με το Grok API. Δέχεται ως είσοδο ένα μοντέλο Pydantic και επιστρέφει απευθείας ένα typed object—χωρίς ανάλυση JSON, χωρίς χειροκίνητη επικύρωση.

1

Ορίστε το μοντέλο Pydantic

Δημιουργείτε μια κλάση Python που περιγράφει την αναμενόμενη δομή.

2

Καλέστε το client.chat.completions.parse()

Περνάτε το μοντέλο Pydantic ως response_format.

3

Λάβετε το tuple (Response, ParsedModel)

Το typed object είναι έτοιμο για χρήση στον κώδικά σας.

Πλήρες παράδειγμα

Ορίστε πώς εξάγετε μια δομημένη κριτική ταινίας:

from openai import OpenAI
from pydantic import BaseModel

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

class MovieReview(BaseModel):
    title: str
    rating: float
    summary: str
    recommend: bool

completion = client.chat.completions.parse(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": "Write a review of the movie Inception"
    }],
    response_format=MovieReview
)
parsed = completion.choices[0].message.parsed

# parsed is a typed MovieReview object
print(parsed.title)      # "Inception"
print(parsed.rating)     # 9.2
print(parsed.recommend)  # True
print(type(parsed))      # <class 'MovieReview'>

Τι επιστρέφει το parse()

Η μέθοδος parse() επιστρέφει ένα tuple δύο στοιχείων:

  1. response: Το πλήρες αντικείμενο απόκρισης API (με μεταδεδομένα, tokens που χρησιμοποιήθηκαν κ.λπ.)
  2. parsed: Το μοντέλο Pydantic σας, στιγμιότυποποιημένο με τα εξαγόμενα δεδομένα

Μπορείτε να προσπελάσετε και τα δύο κατά περίπτωση:

completion = client.chat.completions.parse(...)
parsed = completion.choices[0].message.parsed

# Access metadata
print(completion.usage.total_tokens)
print(completion.model)

# Access structured data
print(parsed.title)
print(parsed.rating)

Ένθετα μοντέλα

Το parse() διαχειρίζεται πολύπλοκες δομές με ευκολία. Μπορείτε να ενθέσετε μοντέλα Pydantic:

class Actor(BaseModel):
    name: str
    role: str

class Review(BaseModel):
    title: str
    director: str
    year: int
    rating: float
    main_actors: list[Actor]
    genres: list[str]
    strengths: list[str]
    weaknesses: list[str]

completion = client.chat.completions.parse(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": "Complete analysis of the movie Interstellar"
    }],
    response_format=Review
)
parsed = completion.choices[0].message.parsed

for actor in parsed.main_actors:
    print(f"{actor.name} plays {actor.role}")

Πότε να χρησιμοποιήσετε το parse()

Το parse() αποτελεί τη συντομότερη διαδρομή μεταξύ μιας απόκρισης μοντέλου και ενός usable Python object: αν εργάζεστε με Pydantic, αυτή είναι η προεπιλεγμένη επιλογή. Η μέθοδος περικλείει τα πάντα—αποστολή του σχήματος, επικύρωση της απόκρισης, στιγμιότυποποίηση του αντικειμένου—και σας παραδίδει απευθείας ένα typed instance, χωρίς json.loads ή χειροκίνητους ελέγχους. Πρόκειται για τον πιο συνοπτικό κώδικα δυνατόν και, για τη συντριπτική πλειοψηφία των περιπτώσεων, αυτή η απλότητα δεν έχει κόστος: χάνετε τον λεπτομερή έλεγχο ανάλυσης μόνο αν τον χρειάζεστε πραγματικά, κάτι που σπανίζει. Το επόμενο μάθημα καλύπτει ακριβώς εκείνες τις περιπτώσεις όπου ο χειροκίνητος έλεγχος είναι δικαιολογημένος.

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

  • Το parse() επιστρέφει ένα tuple (Response, ParsedModel)—αυτόματη ανάλυση
  • Το επιστρεφόμενο αντικείμενο είναι ένα typed και επικυρωμένο instance Pydantic
  • Τα ένθετα μοντέλα και οι λίστες αντικειμένων λειτουργούν εγγενώς
  • Αυτή είναι η συνιστώμενη μέθοδος για τις περισσότερες περιπτώσεις χρήσης σε Python
  • Δεν χρειάζεται json.loads() ούτε χειροκίνητη επικύρωση