Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Risposta manwali b'response_format

Lezzjoni 5 / 12 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Aktar kontroll b’response_format
  2. Fluss tax-xogħol
  3. Eżempju sħiħ
  4. Differenzi minn parse()
  5. Analiżi mingħajr Pydantic
  6. Meta tagħżel response_format
  7. Ġestjoni tal-iżbalji
  8. Punti Ewlenin

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:

  1. L-API tirritorna l-JSON bħala stringa f’response.choices[0].message.content
  2. 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()

Aspettparse()response_format
Ritorn(Response, ParsedModel)Response biss
AnaliżiAwtomatikaManwali
Aċċess għad-dataparsed.fieldjson.loads() jew model_validate_json()
FlessibbiltàStandardMassima
Ġestjoni tal-iżbaljiMibnijaIr-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_format jirritorna 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