Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Samodejna metoda parse()

Lekcija 4 od 12 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Hitra pot: parse()
  2. Celoten primer
  3. Kaj vrača parse()?
  4. Gnezdeni modeli
  5. Kdaj uporabiti parse()?
  6. Ključne ugotovitve

Posodobljeno 3. novembra 2026. Na podlagi dokumentacije Structured Outputs podjetja xAI in SDK openai različice 3.42.1: ko je SDK OpenAI usmerjen na xAI, je metoda client.chat.completions.parse, ki vrne zaključek, kjer se tipizirani objekt prebere iz choices[0].message.parsed; client.chat.parse ne obstaja (SDK xAI sicer ponuja chat.parse(Schema) na pogovoru, ki vrne par odgovor-objekt). Vir: Structured Outputs.

Hitra pot: parse()

Metoda parse() je najpreprostejši način za uporabo strukturiranih izhodov z API-jem Grok. Kot vhod sprejme model Pydantic in neposredno vrne tipiziran objekt – brez potrebe po razčlenjevanju JSON-a ali ročnem preverjanju veljavnosti.

1

Definiraj model Pydantic

Ustvariš razred Python, ki opisuje pričakovano strukturo.

2

Pokliči client.chat.completions.parse()

Model Pydantic posreduješ kot response_format.

3

Prejmi nabor (Response, ParsedModel)

Tipizirani objekt je pripravljen za uporabo v tvoji kodi.

Celoten primer

Tako izvlečeš strukturirano filmsko recenzijo:

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 je tipiziran objekt MovieReview
print(parsed.title)      # "Inception"
print(parsed.rating)     # 9.2
print(parsed.recommend)  # True
print(type(parsed))      # <class 'MovieReview'>

Kaj vrača parse()?

Metoda parse() vrača nabor z dvema elementoma:

  1. response: Celoten objekt odgovora API-ja (z metapodatki, porabljenimi žetoni itd.)
  2. parsed: Tvoj model Pydantic, inicializiran z izvlečenimi podatki

Dostopaš lahko do obeh, kadar koli potrebuješ:

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

# Dostop do metapodatkov
print(completion.usage.total_tokens)
print(completion.model)

# Dostop do strukturiranih podatkov
print(parsed.title)
print(parsed.rating)

Gnezdeni modeli

parse() brez težav obvlada kompleksne strukture. Modelle Pydantic lahko gnezdiš:

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}")

Kdaj uporabiti parse()?

parse() je najkrajša pot med odgovorom modela in uporabnim objektom Python: če delaš s Pydantic, je to privzeta izbira. Metoda zajema vse – pošiljanje sheme, preverjanje veljavnosti odgovora, inicializacijo objekta – in ti neposredno izroči tipiziran primerek, brez json.loads ali ročnih preverjanj. To je najbolj jedrnata možna koda in za veliko večino primerov ta preprostost nima nobene cene: odpoveš se le nadzoru nad razčlenjevanjem na nizki ravni, če bi ga dejansko potreboval, kar je redko. Naslednja lekcija pokriva prav tiste primere, kjer je ročni nadzor upravičen.

Ključne ugotovitve

  • parse() vrača nabor (Response, ParsedModel) – samodejno razčlenjevanje
  • Vrnjeni objekt je tipiziran in preverjen primerek Pydantic
  • Gnezdeni modeli in seznami objektov delujejo naravno
  • To je priporočena metoda za večino primerov uporabe v Pythonu
  • Ni potrebe po json.loads() ali ročnem preverjanju veljavnosti