Freagairt láimhe le response_format
Ar an leathanach seo
Níos mó smachta le response_format
Tugann an modh láimhe trí response_format smacht iomlán duit ar an bparsáil. Murab ionann agus parse(), a thugann oibiacht chlóscríofa ar ais, filleann an cur chuige seo teaghrán JSON a pharsálann tú féin—ní sholáthraíonn an tsamhail Pydantic ach an scéama (model_json_schema()) agus déanann sí bailíochtú ina dhiaidh sin. Roghnaigh an modh seo nuair a theastaíonn solúbthacht uait nó nuair a oibríonn tú i dtimpeallacht gan Pydantic.
Sreabhadh oibre
Le response_format, tarlaíonn an próiseas i dhá chéim:
- Filleann an API an JSON mar theaghrán i
response.choices[0].message.content - Parsálann tú an teaghrán seo ag baint úsáide as do mhodh rogha
Sampla iomlán
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
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[{
"role": "user",
"content": "Review the movie Inception"
}],
response_format={
"type": "json_schema",
"json_schema": {
"name": "movie_review",
"schema": MovieReview.model_json_schema()
}
}
)
# Is teaghrán JSON é an t-ábhar
json_string = response.choices[0].message.content
print(type(json_string)) # <class 'str'>
print(json_string)
# {"title": "Inception", "rating": 9.2, "summary": "...", "recommend": true}
# Parsáil láimhe le Pydantic
parsed = MovieReview.model_validate_json(json_string)
print(parsed.title) # "Inception"
Difríochtaí ó parse()
| Gné | parse() | response_format |
|---|---|---|
| Filltear | (Response, ParsedModel) | Response amháin |
| Parsáil | Uathoibríoch | Láimhe |
| Rochtain ar shonraí | parsed.field | json.loads() nó model_validate_json() |
| Solúbthacht | Caighdeánach | Uasmhéid |
| Láimhseáil earráidí | Inghnéithe | Do fhreagrachtse |
Parsáil gan Pydantic
Ní gá duit Pydantic a úsáid chun an toradh a pharsáil. Oibríonn an modúl caighdeánach json freisin:
import json
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[{
"role": "user",
"content": "Analyze this text and extract entities"
}],
response_format={
"type": "json_schema",
"json_schema": {
"name": "entities",
"schema": {
"type": "object",
"properties": {
"people": {
"type": "array",
"items": { "type": "string" }
},
"places": {
"type": "array",
"items": { "type": "string" }
}
}
}
}
}
)
data = json.loads(response.choices[0].message.content)
print(data["people"]) # ["Marie Curie", "Pierre Curie"]
print(data["places"]) # ["Paris", "Warsaw"]
Cathain a roghnaíonn tú response_format
Bíonn response_format ar a dhícheal nuair is gá duit an JSON a fheiceáil nó a scrúdú sula ndéantar oibiacht de. Is é an cás is coitianta ná logáil: i dtáirgeadh, is minic a bhíonn an JSON amh a choinneáil sula ndéantar claochlú air ina cheanglas iniúchta nó dífhabhtaithe, agus ní thugann parse() an pointe idirghabhála sin duit. Ansin tagann an cheist scéimíochta: má is scéama JSON amh é do chonradh comhéadain—roinnte le foirne eile, ginte ag uirlis, leaganaithe go neamhspleách ar an gcód Python—is mó a fhreagraíonn é a fhorfheidhmiú go díreach ná é a athchruthú mar shamhail Pydantic. Ar deireadh, ní oibríonn gach tionscadal laistigh d’éiceachóras Pydantic: má théann do bhailíochtú trí chreatlach eile, nó trí chéim phróiseála idirmheánaigh atá sonrach do do phíblíne, tugann response_format an JSON duit mar atá sé agus fágann sé an smacht agatsa ar an gcéad chéim eile.
Láimhseáil earráidí
Leis an modh láimhe, caithfidh tú earráidí parsála a láimhseáil tú féin:
import json
try:
data = json.loads(response.choices[0].message.content)
except json.JSONDecodeError as e:
print(f"Parsing error: {e}")
Go praiticiúil, níor chóir go dtarlódh an earráid seo riamh ó tharla ráthaíonn an API go bhfuil an JSON bailí. Ach is dea-chleachtas fós é láimhseáil chosantach a dhéanamh i dtimpeallachtaí táirgthe.
Príomhphointí
- Filleann
response_formatteaghrán JSON iresponse.choices[0].message.content - Is ortsa atá an pharsáil:
json.loads(),model_validate_json(), nó modh eile - Is féidir leat scéama JSON amh a úsáid in ionad samhail Pydantic
- Níos mó solúbthachta ná
parse(), ach níos mó cód le scríobh - Ráthaítear go bhfuil an JSON a fhilltear bailí—níor chóir go dtarlódh earráidí parsála