Automātiskā parse() metode
Šajā lapā
Atjaunināts 2026. gada 3. novembrī. Pamatojoties uz Structured Outputs dokumentāciju no xAI un
openaiSDK 3.42.1: ja OpenAI SDK ir norādīts uz xAI, metode irclient.chat.completions.parse, kas atgriež pabeigšanu, kur tipētais objekts tiek nolasīts nochoices[0].message.parsed;client.chat.parsenepastā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.
Definē Pydantic modeli
Tu izveido Python klasi, kas apraksta sagaidāmo struktūru.
Izsauc client.chat.completions.parse()
Tu nodod Pydantic modeli kā response_format.
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:
response: Pilns API atbildes objekts (ar metadatiem, izmantotajiem tokeniem u.c.)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