Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Modh parse() Uathoibríoch

Ceacht 4 as 12 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. An Bealach Tapaidh: parse()
  2. Sampla Iomlán
  3. Cad a Fhilltear le parse()
  4. Samhlacha Neadaigh
  5. Cathain a Úsáidfear parse()
  6. Príomhphointí

Nuashonraithe an 3 Samhain, 2026. Bunaithe ar an doiciméadúchán Structured Outputs ó xAI agus ar an SDK openai 3.42.1: nuair a dhírítear an SDK OpenAI ar xAI, is é client.chat.completions.parse an modh, a thugann críochnú ar ais áit a léitear an réad clóscríofa ó choices[0].message.parsed; níl client.chat.parse ann (tugann SDK xAI chat.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.

1

Sainigh an Samhail Pydantic

Cruthaíonn tú rang Python a dhéanann cur síos ar an struchtúr atá ag teastáil.

2

Glaoigh ar client.chat.completions.parse()

Cuirtear an tsamhail Pydantic ar fáil mar `response_format`.

3

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:

  1. response: An réad Freagra API iomlán (le meiteashonraí, tokenanna úsáidte, srl.)
  2. 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