Modh parse() Uathoibríoch
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026. Bunaithe ar an doiciméadúchán Structured Outputs ó xAI agus ar an SDK
openai3.42.1: nuair a dhírítear an SDK OpenAI ar xAI, is éclient.chat.completions.parsean modh, a thugann críochnú ar ais áit a léitear an réad clóscríofa óchoices[0].message.parsed; nílclient.chat.parseann (tugann SDK xAIchat.parse(Schema)ar fáil ar chomhrá, a thugann péire freagra-réada ar ais). Foinse: Structured Outputs.
An Bealach Tapaidh: parse()
Is é an modh parse() an bealach is simplí chun aschuir struchtúrtha a úsáid leis an API Grok. Glacann sé le samhl Pydantic mar ionchur agus filleann sé réad clóscríofa go díreach—gan JSON a pharsáil, gan bailíochtú de láimh.
Sainigh an Samhail Pydantic
Cruthaíonn tú rang Python a dhéanann cur síos ar an struchtúr atá ag teastáil.
Glaoigh ar client.chat.completions.parse()
Cuirtear an tsamhail Pydantic ar fáil mar `response_format`.
Faigh an Túpail (Freagra, SamhailPharsáilte)
Tá an réad clóscríofa réidh le húsáid i do chód.
Sampla Iomlán
Seo conas athbhreithniú scannáin struchtúrtha a eastósct:
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
# is réad MovieReview clóscríofa é parsed
print(parsed.title) # "Inception"
print(parsed.rating) # 9.2
print(parsed.recommend) # True
print(type(parsed)) # <class 'MovieReview'>
Cad a Fhilltear le parse()
Filleann an modh parse() túpail dhá eilimint:
response: An réad Freagra API iomlán (le meiteashonraí, tokenanna úsáidte, srl.)parsed: Do shamhail Pydantic curtha ar bun leis na sonraí eastósctha
Is féidir leat teacht ar an dá cheann de réir mar is gá:
completion = client.chat.completions.parse(...)
parsed = completion.choices[0].message.parsed
# Rochtain ar mheiteashonraí
print(completion.usage.total_tokens)
print(completion.model)
# Rochtain ar shonraí struchtúrtha
print(parsed.title)
print(parsed.rating)
Samhlacha Neadaigh
Láimhseálann parse() struchtúir chasta gan stró. Is féidir leat samhlacha Pydantic a neadú:
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}")
Cathain a Úsáidfear parse()
Is é parse() an cosán is giorra idir freagra samhlacha agus réad Python inúsáidte: má oibríonn tú le Pydantic, seo an rogha réamhshocraithe. Cuimsíonn an modh gach rud—seoladh an scéimre, bailíochtú na freagra, cur ar bun an réada—agus tugann sé sampl clóscríofa duit go díreach, gan json.loads ná seiceálacha de láimh. Is é an cód is giorra is féidir, agus don chuid is mó de na cásanna, ní bhíonn aon chostas ag baint leis an tsimplíocht seo: ní chailltear smacht mionpharsála ach amháin má bhí gá leis i ndáiríre, rud atá annamh. Pléifidh an chéad cheacht eile go díreach na cásanna sin ina bhfuil údar le smacht de láimh.
Príomhphointí
- Filleann
parse()túpail(Response, ParsedModel)—parsáil uathoibríoch - Is sampl Pydantic clóscríofa agus bailíochtaithe é an réad a fhilltear
- Oibríonn samhlacha neadaigh agus liostaí réad go dúchasach
- Seo an modh molta don chuid is mó de chásanna úsáide i bPython
- Níl aon ghá le
json.loads()ná le bailíochtú de láimh