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

Freagairt láimhe le response_format

Ceacht 5 as 12 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Níos mó smachta le response_format
  2. Sreabhadh oibre
  3. Sampla iomlán
  4. Difríochtaí ó parse()
  5. Parsáil gan Pydantic
  6. Cathain a roghnaíonn tú response_format
  7. Láimhseáil earráidí
  8. Príomhphointí

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:

  1. Filleann an API an JSON mar theaghrán i response.choices[0].message.content
  2. 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áilUathoibríochLáimhe
Rochtain ar shonraíparsed.fieldjson.loads() nó model_validate_json()
SolúbthachtCaighdeánachUasmhéid
Láimhseáil earráidíInghnéitheDo 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_format teaghrán JSON i response.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