Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Automatická metóda parse()

Lekcia 4 z 12 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Rýchla cesta: parse()
  2. Kompletný príklad
  3. Čo vracia parse()
  4. Vnorené modely
  5. Kedy použiť parse()
  6. Kľúčové poznatky

Aktualizované 3. novembra 2026. Na základe dokumentácie Structured Outputs od xAI a SDK openai verzie 3.42.1: pri použití OpenAI SDK smerujúceho na xAI je metóda client.chat.completions.parse, ktorá vracia doplnenie, kde sa typovaný objekt číta z choices[0].message.parsed; client.chat.parse neexistuje (SDK xAI síce ponúka chat.parse(Schema) na konverzácii, ktoré vracia pár objektov odpoveď-objekt). Zdroj: Structured Outputs.

Rýchla cesta: parse()

Metóda parse() je najjednoduchší spôsob, ako využiť štruktúrované výstupy s API Grok. Ako vstup prijíma model Pydantic a priamo vracia typovaný objekt – žiadne parsovanie JSON, žiadna manuálna validácia.

1

Definuj model Pydantic

Vytvoríš triedu v Pythone, ktorá opisuje očakávanú štruktúru.

2

Volaj client.chat.completions.parse()

Model Pydantic odovzdáš ako parameter response_format.

3

Prijmi n-ticu (Odpoveď, ParsedModel)

Typovaný objekt je pripravený na použitie v tvojom kóde.

Kompletný príklad

Tu je ukážka, ako extrahovať štruktúrovanú recenziu filmu:

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

Čo vracia parse()

Metóda parse() vracia n-ticu s dvoma prvkami:

  1. response: Úplný objekt odpovede API (s metadátami, použitými tokenmi atď.)
  2. parsed: Tvoj model Pydantic inštalovaný s extrahovanými dátami

Oba môžeš podľa potreby využiť:

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

# Prístup k metadátam
print(completion.usage.total_tokens)
print(completion.model)

# Prístup k štruktúrovaným dátam
print(parsed.title)
print(parsed.rating)

Vnorené modely

parse() bez problémov zvláda komplexné štruktúry. Modely Pydantic môžeš vnárať:

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

Kedy použiť parse()

parse() je najkratšia cesta medzi odpoveďou modelu a použiteľným objektom v Pythone: ak pracuješ s Pydantic, toto je voľba predvolená. Metóda zapuzdruje všetko – odoslanie schémy, validáciu odpovede, inštaláciu objektu – a odovzdá ti priamo typovanú inštanciu, bez potreby json.loads alebo manuálnych kontrol. Je to najúspornejší možný kód a pre veľkú väčšinu prípadov táto jednoduchosť nič nestojí: vzdávaš sa jemnej kontroly nad parsovaním len vtedy, ak ju skutočne potrebuješ, čo je zriedkavé. Nasledujúca lekcia pokrýva presne tie prípady, kde je manuálna kontrola opodstatnená.

Kľúčové poznatky

  • parse() vracia n-ticu (Response, ParsedModel) – automatické parsovanie
  • Vrátaný objekt je typovaná a validovaná inštancia Pydantic
  • Vnorené modely a zoznamy objektov fungujú natívne
  • Toto je odporúčaná metóda pre väčšinu prípadov použitia v Pythone
  • Nie je potrebné volať json.loads() ani vykonávať manuálnu validáciu