Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Automātiskā parse() metode

Nodarbība 4 no 12 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Ātrākais ceļš: parse()
  2. Pilns piemērs
  3. Ko atgriež parse()
  4. Ligzdoti modeļi
  5. Kad lietot parse()
  6. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī. Pamatojoties uz Structured Outputs dokumentāciju no xAI un openai SDK 3.42.1: ja OpenAI SDK ir norādīts uz xAI, metode ir client.chat.completions.parse, kas atgriež pabeigšanu, kur tipētais objekts tiek nolasīts no choices[0].message.parsed; client.chat.parse nepastāv (xAI SDK piedāvā chat.parse(Schema) sarunai, kas atgriež atbildes un objekta pāri). Avots: Structured Outputs.

Ātrākais ceļš: parse()

Metode parse() ir vienkāršākais veids, kā izmantot strukturētās izvades ar Grok API. Tā kā ievadi saņem Pydantic modeli un tieši atgriež tipētu objektu — nav jāparsē JSON, nav nepieciešama manuāla validācija.

1

Definē Pydantic modeli

Tu izveido Python klasi, kas apraksta sagaidāmo struktūru.

2

Izsauc client.chat.completions.parse()

Tu nodod Pydantic modeli kā response_format.

3

Saņem kortežu (Response, ParsedModel)

Tipētais objekts ir gatavs lietošanai tavā kodā.

Pilns piemērs

Lūk, kā izgūt strukturētu filmu recenziju:

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 ir tipēts MovieReview objekts
print(parsed.title)      # "Inception"
print(parsed.rating)     # 9.2
print(parsed.recommend)  # True
print(type(parsed))      # <class 'MovieReview'>

Ko atgriež parse()

Metode parse() atgriež divu elementu kortežu:

  1. response: Pilns API atbildes objekts (ar metadatiem, izmantotajiem tokeniem u.c.)
  2. parsed: Tavs Pydantic models, inicializēts ar izgūtajiem datiem

Tu vari piekļūt abiem pēc vajadzības:

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

# Pieeja metadatiem
print(completion.usage.total_tokens)
print(completion.model)

# Pieeja strukturētajiem datiem
print(parsed.title)
print(parsed.rating)

Ligzdoti modeļi

parse() bez piepūles apstrādā sarežģītas struktūras. Tu vari ligzdot Pydantic modeļus:

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

Kad lietot parse()

parse() ir īsākais ceļš no modeļa atbildes uz lietojamu Python objektu: ja strādā ar Pydantic, šī ir noklusējuma izvēle. Metode encapsulē visu — shēmas nosūtīšanu, atbildes validāciju, objekta inicializāciju — un nodod tev tieši tipētu instanci, bez json.loads vai manuālām pārbaudēm. Tas ir viskoncīzākais iespējamais kods, un lielākajā daļā gadījumu šī vienkāršība nerada nekādus zaudējumus: tu zaudē smalku parsēšanas kontroli tikai tad, ja tā tev patiešām bija nepieciešama, kas notiek reti. Nākamajā nodarbībā tiks aplūkoti tieši tie gadījumi, kad manuāla kontrole ir attaisnojama.

Galvenās atziņas

  • parse() atgriež kortežu (Response, ParsedModel) — automātiska parsēšana
  • Atgrieztais objekts ir tipēta un validēta Pydantic instance
  • Ligzdoti modeļi un objektu saraksti darbojas dabiski
  • Šī ir ieteicamā metode lielākajai daļai lietojumu Python valodā
  • Nav nepieciešams json.loads() vai manuāla validācija