Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Il-Metodu parse() Awtomatiku

Lezzjoni 4 / 12 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. It-Triq Veloci: parse()
  2. Eżempju Sħiħ
  3. X’Jirritorna parse()
  4. Mudelli Mbejjna (Nested)
  5. Meta Tuża parse()
  6. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026. Ibbażat fuq id-dokumentazzjoni tal-Structured Outputs minn xAI u l-SDK openai 3.42.1: bl-SDK ta’ OpenAI ppuntat lejn xAI, il-metodu huwa client.chat.completions.parse, li jirritorna t-tlestija fejn l-oġġett ittajpjat jinqara minn choices[0].message.parsed; client.chat.parse ma jeżistix (l-SDK ta’ xAI joffri chat.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.

1

Iddefinixxi l-Mudell Pydantic

Toħloq klassi Python li tiddeskrivi l-istruttura mistennija.

2

Sejjaħ client.chat.completions.parse()

Tgħaddi l-mudell Pydantic bħala response_format.

3

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:

  1. response: L-oġġett sħiħ tar-Risposta tal-API (b’metadata, tokens użati, eċċ.)
  2. 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