Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Automatická metoda parse()

Lekce 4 z 12 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Rychlá cesta: parse()
  2. Kompletní příklad
  3. Co vrací parse()
  4. Vnořené modely
  5. Kdy použít parse()
  6. Klíčové poznatky

Aktualizováno 3. listopadu 2026. Na základě dokumentace Structured Outputs od xAI a SDK openai verze 3.42.1: Při použití OpenAI SDK směřujícího na xAI je metodou client.chat.completions.parse, která vrací dokončení, kde je typovaný objekt čten z choices[0].message.parsed; client.chat.parse neexistuje (SDK xAI sice nabízí chat.parse(Schema) na konverzaci, které vrací pár odpověď-objekt). Zdroj: Structured Outputs.

Rychlá cesta: parse()

Metoda parse() je nejjednodušší způsob, jak využít strukturované výstupy s API Grok. Jako vstup přijímá model Pydantic a přímo vrací typovaný objekt – žádné parsování JSONu, žádná ruční validace.

1

Definuj model Pydantic

Vytvoříš třídu v Pythonu, která popisuje očekávanou strukturu.

2

Zavolej client.chat.completions.parse()

Model Pydantic předáš jako parametr response_format.

3

Obdrž tuple (Odpověď, ParsedModel)

Typovaný objekt je připraven k použití ve tvém kódu.

Kompletní příklad

Zde je ukázka, jak extrahovat strukturovanou recenzi 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'>

Co vrací parse()

Metoda parse() vrací tuple o dvou prvcích:

  1. response: Plný objekt odpovědi API (s metadaty, počtem použitých tokenů atd.)
  2. parsed: Tvůj model Pydantic instantciovaný s extrahovanými daty

Oba prvky můžeš podle potřeby využít:

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

# Přístup k metadatům
print(completion.usage.total_tokens)
print(completion.model)

# Přístup ke strukturovaným datům
print(parsed.title)
print(parsed.rating)

Vnořené modely

parse() bez problémů zvládá složité struktury. Modely Pydantic můžeš vnořovat:

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

Kdy použít parse()

parse() je nejkratší cestou mezi odpovědí modelu a použitelným objektem v Pythonu: pokud pracuješ s Pydantic, je to výchozí volba. Tato metoda zapouzdřuje vše – odeslání schématu, validaci odpovědi, instantciaci objektu – a předá ti přímo typovanou instanci, bez nutnosti používat json.loads nebo provádět ruční kontroly. Je to nejúspornější možný kód a pro drtivou většinu případů přichází tato jednoduchost bez jakékoli újmy: vzdáváš se jemné kontroly nad parsováním pouze tehdy, pokud bys ji skutečně potřeboval, což je vzácné. Následující lekce se věnuje právě těm případům, kdy je ruční kontrola oprávněná.

Klíčové poznatky

  • parse() vrací tuple (Response, ParsedModel) – automatické parsování
  • Vrácený objekt je typovaná a validovaná instance Pydantic
  • Vnořené modely a seznamy objektů fungují nativně
  • Toto je doporučená metoda pro většinu případů použití v Pythonu
  • Není potřeba používat json.loads() ani provádět ruční validaci