Il-Metodu parse() Awtomatiku
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026. Ibbażat fuq id-dokumentazzjoni tal-Structured Outputs minn xAI u l-SDK
openai3.42.1: bl-SDK ta’ OpenAI ppuntat lejn xAI, il-metodu huwaclient.chat.completions.parse, li jirritorna t-tlestija fejn l-oġġett ittajpjat jinqara minnchoices[0].message.parsed;client.chat.parsema jeżistix (l-SDK ta’ xAI joffrichat.parse(Schema)fuq konversazzjoni, li jirritorna par oġġett-risposta). Sors: Structured Outputs.
It-Triq Veloci: parse()
Il-metodu parse() huwa l-aktar mod sempliċi biex tuża outputs strutturati mal-API ta’ Grok. Huwa jieħu mudell Pydantic bħala input u jirritorna oġġett ittajpjat direttament—l-ebda JSON x’tipparseja, l-ebda validazzjoni manwali.
Iddefinixxi l-Mudell Pydantic
Toħloq klassi Python li tiddeskrivi l-istruttura mistennija.
Sejjaħ client.chat.completions.parse()
Tgħaddi l-mudell Pydantic bħala response_format.
Irċievi t-Tuple (Risposta, MudellIpparsjat)
L-oġġett ittajpjat ikun lest biex tużah fil-kodiċi tiegħek.
Eżempju Sħiħ
Hekk kif testratti reviżjoni strutturata ta’ film:
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 huwa oġġett MovieReview ittajpjat
print(parsed.title) # "Inception"
print(parsed.rating) # 9.2
print(parsed.recommend) # True
print(type(parsed)) # <class 'MovieReview'>
X’Jirritorna parse()
Il-metodu parse() jirritorna tuple ta’ żewġ elementi:
response: L-oġġett sħiħ tar-Risposta tal-API (b’metadata, tokens użati, eċċ.)parsed: Il-mudell Pydantic tiegħek istanzjat bid-data estratta
Tista’ taċċessa t-tnejn skont il-ħtieġa:
completion = client.chat.completions.parse(...)
parsed = completion.choices[0].message.parsed
# Aċċessa l-metadata
print(completion.usage.total_tokens)
print(completion.model)
# Aċċessa d-data strutturata
print(parsed.title)
print(parsed.rating)
Mudelli Mbejjna (Nested)
parse() jimmaniġġja strutturi kumplessi bla sforz. Tista’ tbajjen mudelli 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}")
Meta Tuża parse()
parse() huwa l-iqsar triq bejn rispons ta’ mudell u oġġett Python użabbli: jekk taħdem ma’ Pydantic, din hija l-għażla default. Il-metodu jinkapsula kollox—jibgħat l-iskema, jivvalida r-rispons, jistanzja l-oġġett—u jagħtik istanza ittajpjata direttament, mingħajr json.loads jew kontrolli manwali. Huwa l-aktar kodiċi konċiż possibbli, u għall-biċċa l-kbira tal-każijiet, din is-sempliċità ma tiġix bi prezz: titlef biss il-kontroll fin tal-parsing jekk verament kellek bżonnu, li huwa rari. Il-lezzjoni li jmiss tkopri preċiżament dawk il-każijiet fejn il-kontroll manwali huwa ġustifikat.
Punti Ewlenin
parse()jirritorna tuple(Response, ParsedModel)—parsing awtomatiku- L-oġġett irritornat huwa istanza Pydantic ittajpjata u vvalidata
- Mudelli mbejjna u listi ta’ oġġetti jaħdmu nativament
- Dan huwa l-metodu rrakkomandat għall-biċċa l-kbira tal-użi f’Python
- L-ebda ħtieġa għal
json.loads()jew validazzjoni manwali