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

Módh JSON agus Forfheidhmiú Scéime

Ceacht 10 as 16 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Módh JSON agus Forfheidhmiú Scéime
  2. Módh JSON vs Aschur Struchtúrtha
  3. Aschur Struchtúrtha le Scéim JSON
  4. Rialacha d’Aschur Struchtúrtha Docht
  5. Cabhair chun Scéimeanna a Thógáil
  6. Sampla: Eastóscadh Sonraí Struchtúrtha
  7. Tomhas ar an Méid a Thugann an Srian
  8. Príomhphointí

An ceacht nuashonraithe an 3 Samhain, 2026 bunaithe ar dhoiciméadú OpenAI: níl temperature agus top_p inghlactha ach le hiarracht réasúnaíochta de none, cé go ndéanann samhlacha GPT-5.6 réasúnú de réir réamhshocraithe (medium). Caithfidh glaonna a shocraíonn na paraiméadair seo reasoning={"effort": "none"} (API Freagraí) nó reasoning_effort="none" (Críochnú Comhrá) a shonrú dá bhrí sin. Foinse: GPT-6 a úsáid · GPT-5.6 Terra.

Módh JSON agus Forfheidhmiú Scéime

Ráthaíonn Aschur Struchtúrtha OpenAI go bhfuil freagra an mhúnla ina JSON bailí a leanann scéim a shainíonn tú. Níl aon pharsáil bhristeach le regex nó earráidí formáide ann a thuilleadh; cuirtear an srian i bhfeidhm ag leibhéal na giniúna féin.

Tá an nuance seo ríthábhachtach, agus athraíonn sé gach rud do fhorbróir. Is achainí é “freagair i JSON” a iarraidh sa leid: oibleáidíonn an múnla formhór den am, ach lá amháin cuireann sé “Seo an JSON a d’iarr tú:” roimhe, cuireann sé ticéid Markdown leis, nó déanann sé dearmad ar chama, agus caithfidh do json.loads eisceacht i dtáirgeadh ag 3 a.m. ar an mbaisc is mó den tseachtain. Le hAschur Struchtúrtha, cuirtear an srian i bhfeidhm le linn an díchódaithe: ní féidir teicneoirí a chruthódh JSON neamhbhailí nó neamh-chomhlíontach a roghnú ar chor ar bith. Stopann tú ag impí agus tosaíonn tú ag forfheidhmiú.

Módh JSON vs Aschur Struchtúrtha

Tairgeann OpenAI dhá leibhéal srianta, agus braitheann an t-idirdhealú ar fhocal amháin. Ráthaíonn Módh JSON go bhfuil JSON bailí ann gan aon srianta struchtúrtha; ráthaíonn Aschur Struchtúrtha go leanann JSON scéim JSON a scríobh tú.

Réitíonn Módh JSON leath na faidhbe. Tá tú cinnte gur féidir leat an freagra a pharsáil, ach níl tú cinnte cad atá ann: d’fhéadfadh an múnla ainm réimse annee a thabhairt ar iarratas amháin agus year ar an gcéad cheann eile, nó d’fhéadfadh sé a liosta a chur i réad resultats nár úsáid sé an lá roimhe. Do phrótaitíopa nó taispeáint amh atá beartaithe do dhuine, leor é sin; chomh luath agus a chothaíonn an t-aschur cód a rochtaineann réimsí de réir ainm, teastaíonn an dara leibhéal uait.

from openai import OpenAI

client = OpenAI()

# Módh JSON simplí (JSON bailí, struchtúr saor)
response = client.responses.create(
    model="gpt-5.6-terra",
    instructions="Always respond in JSON.",
    input="List 3 programming languages with their year of creation.",
    text={"format": {"type": "json_object"}}
)

import json
data = json.loads(response.output_text)
print(data)

Aschur Struchtúrtha le Scéim JSON

Seo an ghné is cumhachtaí. Sainíonn tú scéim JSON, agus ráthaíonn an API go leanann an t-aschur í. Léiríonn an sampla thíos anailís ar mheon athbhreithnithe custaiméara agus taispeánann sé trí úsáid chomhlántach den scéim.

Cuireann an enum ar sentiment cosc ar an múnla catagóir idirmheánach cosúil le “réasúnta dearfach” a chruthú: caithfidh sé roghnú idir na ceithre luach a soláthraíodh, rud a fhágann go bhfuil an t-aschur inúsáidte go díreach i scagaire nó i deais. Feidhmíonn an description ar an réimse score mar mhinileid áitiúil, ag léiriú an scála a bhfuiltear ag súil leis gan gá duit é a mhíniú sna treoracha ginearálta, agus fanann sé ceangailte leis an réimse fiú má fhorbraíonn an leid. Ar deireadh, ligeann an t-eagar aspects duit athbhreithniú contrártha a dhíchumadh—anseo, táirge ar maith leis ach theip ar an seachadadh—in ionad an nuance sin a bhrú isteach i scór amháin nach gcuidíonn le duine ar bith.

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Analyze the sentiment of: 'The product is excellent "
          "but the delivery was catastrophic.'",
    text={
        "format": {
            "type": "json_schema",
            "name": "sentiment_analysis",
            "schema": {
                "type": "object",
                "properties": {
                    "sentiment": {
                        "type": "string",
                        "enum": ["positive", "negative", "mixed", "neutral"]
                    },
                    "score": {
                        "type": "number",
                        "description": "Score from -1.0 (very negative) to 1.0 (very positive)"
                    },
                    "aspects": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "aspect": {"type": "string"},
                                "sentiment": {
                                    "type": "string",
                                    "enum": ["positive", "negative", "neutral"]
                                }
                            },
                            "required": ["aspect", "sentiment"],
                            "additionalProperties": False
                        }
                    },
                    "summary": {"type": "string"}
                },
                "required": ["sentiment", "score", "aspects", "summary"],
                "additionalProperties": False
            },
            "strict": True
        }
    }
)

result = json.loads(response.output_text)
# Ráthaithe: tá na réimsí sainithe go díreach ag result
print(f"Sentiment: {result['sentiment']}")
print(f"Score: {result['score']}")
for aspect in result["aspects"]:
    print(f"  - {aspect['aspect']}: {aspect['sentiment']}")

Rialacha d’Aschur Struchtúrtha Docht

Cuirann an mód strict: true a shrianta féin ar an scéim. Caithfidh gach réimse teacht chun cinn in required, agus caithfidh additionalProperties a bheith false ar gach réad. Is iad na cineálacha ceadaithe ná string, number, integer, boolean, array, object, agus null, móide enum chun luachanna a theorannú. Mar sin féin, ní ghlactar le pattern ná le minLength/maxLength: tarlaíonn bailíochtú mionghrádach ar thaobh an chliaint.

Is féidir leis na rialacha seo a bheith iontach ar an gcéad iarracht toisc go gcuireann siad cosc ar an réimse roghnach mar a scríobhtar de ghnáth i Scéim JSON. Is compordach an malartú: ní gá do chód riamh a thástáil an bhfuil eochair ann; tá sé ann i gcónaí. Maidir le réimse is féidir a bheith folamh go dlisteanach—uimhir theileafóin in easnamh ó dhoiciméad, dáta deiridh do chonradh atá ar siúl—ní hé an freagra é a bhaint as required ach cead a thabhairt dó a bheith null. Maidir le heasnamh pattern agus teorainneacha faid, léiríonn sé an chéad cheacht eile: ráthaíonn an scéim an fhoirm, ach is é do phostsa an bailíochtú gnó a dhéanamh nuair a fhaightear an freagra.

Cabhair chun Scéimeanna a Thógáil

Éiríonn sé tuirsiúil go tapa agus tá sé faoi thionchar botún clóscríofa an bloc text.format a scríobh de láimh do gach glao—eochair name in easnamh, strict míshuite, agus tagann an earráid ar ais ón API gan a léiriú cá háit le lorg. Lárnachíonn cúpla líne cóid fillteora an struchtúr, cuireann sé teocht íseal i bhfeidhm de réir réamhshocraithe (ós rud é nach gcuireann inathraitheacht aon rud le heastóscadh), agus déanann sé suíomh an ghlao inléite.

def structured_query(prompt: str, schema: dict,
                     schema_name: str = "response",
                     model: str = "gpt-5.6-terra",
                     system: str = "") -> dict:
    """Fillteoir d'iarratais Aschur Struchtúrtha."""
    response = client.responses.create(
        model=model,
        reasoning={"effort": "none"},  # éilíonn temperature effort none
        instructions=system or "Respond in JSON according to the provided schema.",
        input=prompt,
        text={
            "format": {
                "type": "json_schema",
                "name": schema_name,
                "schema": schema,
                "strict": True
            }
        },
        temperature=0.1
    )
    return json.loads(response.output_text)

Sampla: Eastóscadh Sonraí Struchtúrtha

Seo an cás úsáide a fhíoraíonn foghlaim na teicníce seo leis féin: athrú sonraisc a fuarthas mar ghnáth-théacs ina réad atá inúsáidte ag do chóras cuntasaíochta. Déanann an scéim cur síos ar thrí leibhéal—ceanntásc an tsonraisc, réad neadaithe vendor, agus eagar lines ina bhfuil an cruth céanna ag gach eilimint. Dá bhrí sin, caithfidh an múnla faisnéis atá scaipthe ar fud an doiciméid a aimsiú agus í a chur sa spót ceart, fiú do líne a shloinntear in uaireanta seachas in aonaid, áit a dtuigtear an praghas in aghaidh an aonaid mar ráta uaire.

Tabhair faoi deara go bhfeictear iomláin sa scéim mar réimsí le heastóscadh, ní le hathríomh. Iarraimid ar an múnla léamh; tarlaíonn rialú uimhríochta ina dhiaidh sin i do chód, áit a mbratachóidh comparáid shimplí idir suim na línte agus an total_ht eastósctha doiciméid le haghaidh athbhreithnithe daonna.

invoice_schema = {
    "type": "object",
    "properties": {
        "invoice_number": {"type": "string"},
        "date": {"type": "string"},
        "vendor": {
            "type": "object",
            "properties": {
                "name": {"type": "string"},
                "siret": {"type": "string"},
                "address": {"type": "string"}
            },
            "required": ["name", "siret", "address"],
            "additionalProperties": False
        },
        "lines": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "description": {"type": "string"},
                    "quantity": {"type": "integer"},
                    "unit_price_excl_tax": {"type": "number"},
                    "vat_percent": {"type": "number"}
                },
                "required": ["description", "quantity",
                             "unit_price_excl_tax", "vat_percent"],
                "additionalProperties": False
            }
        },
        "total_excl_tax": {"type": "number"},
        "total_incl_tax": {"type": "number"}
    },
    "required": ["invoice_number", "date", "vendor",
                  "lines", "total_excl_tax", "total_incl_tax"],
    "additionalProperties": False
}

invoice_text = """
Invoice No. 2026-0042
Date: 15/03/2026
Vendor: TechServ SARL, SIRET 123 456 789 00012
12 rue de la Paix, 75002 Paris

- REST API Development x1: 3500.00 EUR excl. tax (VAT 20%)
- Cloud hosting (3 months) x1: 450.00 EUR excl. tax (VAT 20%)
- Technical support x10h: 150.00 EUR excl. tax/h (VAT 20%)

Total excl. tax: 5450.00 EUR
Total incl. tax: 6540.00 EUR
"""

result = structured_query(
    invoice_text,
    invoice_schema,
    schema_name="invoice",
    system="Extract the data from this invoice."
)

Tomhas ar an Méid a Thugann an Srian

Cuir an prionsabal seo i bhfeidhm ar dhoiciméad atá ar eolas agat: sainigh scéim JSON chun faisnéis lárnach a eastóscadh as CV—ainm, taithí, scileanna, oideachas—agus déan tástáil air ar thrí CV gnáth-théacs a roghnaíodh go dlisteanach as a gcuid leaganacha amacha ilchineálacha. Fíoraigh go n-urramaíonn an t-aschur an scéim fiú nuair a bhíonn alt in easnamh go hiomlán.

Ansin déan an t-eastóscadh céanna arís gan Aschur Struchtúrtha, ag iarraidh JSON sa leid amháin, agus coinnigh an sé aschur taobh le taobh a chéile. Léiríonn comparáid idir an dá shraith cad a thugann an srian: is annamh a bhíonn an difríocht sa chonbar a eastóscthadh, beagnach i gcónaí i gcobhsaíocht ainmneacha réimsí agus i láithreacht eochracha a bhfuiltear ag súil leo.

Príomhphointí

  • Ráthaíonn Aschur Struchtúrtha JSON a leanann an scéim ag leibhéal na giniúna
  • Úsáid strict: true don chomhlíonadh uasta
  • Caithfidh gach réimse a bheith required le additionalProperties: false
  • Ideálach d’eastóscadh sonraí, d’aicmiú, agus do phíblínte próiseála
  • Tarlaíonn bailíochtú mionghrádach (fad, patrún) ar thaobh an chliaint tar éis glactha