Risposta manwali b'response_format
F'din il-paġna
Aktar kontroll b’response_format
Il-metodu manwali permezz ta’ response_format jagħtik kontroll sħiħ fuq l-analiżi (parsing). Kuntrarjament għal parse(), li jirritorna oġġett ittipjat, dan l-approċċ jirritorna stringa JSON li trid tanalizza int stess—il-mudell Pydantic jipprovdi biss l-iskema (model_json_schema()) u jivvalida wara. Agħżel dan il-metodu meta jkollok bżonn flessibbiltà jew meta taħdem f’ambjent mingħajr Pydantic.
Fluss tax-xogħol
Ma’ response_format, il-proċess iseħħ f’żewġ passi:
- L-API tirritorna l-JSON bħala stringa f’
response.choices[0].message.content - Int tanalizza din l-istringa bl-metodu li tagħżel int
Eżempju sħiħ
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()
}
}
)
# Il-kontenut huwa stringa JSON
json_string = response.choices[0].message.content
print(type(json_string)) # <class 'str'>
print(json_string)
# {"title": "Inception", "rating": 9.2, "summary": "...", "recommend": true}
# Analiżi manwali b'Pydantic
parsed = MovieReview.model_validate_json(json_string)
print(parsed.title) # "Inception"
Differenzi minn parse()
| Aspett | parse() | response_format |
|---|---|---|
| Ritorn | (Response, ParsedModel) | Response biss |
| Analiżi | Awtomatika | Manwali |
| Aċċess għad-data | parsed.field | json.loads() jew model_validate_json() |
| Flessibbiltà | Standard | Massima |
| Ġestjoni tal-iżbalji | Mibnija | Ir-responsabbiltà tiegħek |
Analiżi mingħajr Pydantic
M’għandekx għalfejn tuża Pydantic biex tanalizza r-riżultat. Il-modulu standard json jaħdem ukoll:
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"]
Meta tagħżel response_format
response_format jispikka kull meta jkollok bżonn tara jew tiċċekkja l-JSON qabel ma jsir oġġett. L-aktar każ komuni huwa r-reġistrazzjoni (logging): fil-produzzjoni, iż-żamma tal-JSON raw qabel it-trasformazzjoni spiss tkun rekwiżit għall-awditjar jew id-debugging, u parse() ma jagħtikx dak il-punt ta’ interċettazzjoni. Imbagħad hemm il-kwistjoni tal-iskema: jekk il-kuntratt tal-interfaċċa tiegħek huwa skema JSON raw—maqsuma ma’ timijiet oħra, iġġenerata minn għodda, jew imverżjonata indipendentement mill-kodiċi Python—infurzar dirett tagħha huwa aktar feddej milli terġa’ tibniha bħala mudell Pydantic. Fl-aħħar nett, mhux kull proġett jopera fl-ekosistema Pydantic: jekk il-validazzjoni tiegħek tgħaddi minn qafas ieħor, jew minn pass ta’ pproċessar intermedjarju speċifiku għall-pipeline tiegħek, response_format jagħtik il-JSON kif inhu u jħallik kontroll sħiħ fuq x’jiġri wara.
Ġestjoni tal-iżbalji
Bil-metodu manwali, trid timmaniġġja l-iżbalji tal-analiżi int stess:
import json
try:
data = json.loads(response.choices[0].message.content)
except json.JSONDecodeError as e:
print(f"Parsing error: {e}")
Fil-prattika, dan l-iżball qatt m’għandu jseħħ peress li l-API tiggarantixxi JSON validu. Madankollu, l-immaniġġjar difensiv jibqa’ prattika tajba fil-produzzjoni.
Punti Ewlenin
response_formatjirritorna stringa JSON f’response.choices[0].message.content- L-analiżi hija r-responsabbiltà tiegħek:
json.loads(),model_validate_json(), jew metodu ieħor - Tista’ tuża skema JSON raw minflok mudell Pydantic
- Aktar flessibbiltà minn
parse(), iżda aktar kodiċi biex tikteb - Il-JSON irritornat huwa ggarantit li jkun validu—l-iżbalji tal-analiżi m’għandhomx iseħħu