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

Patrúin chasta: liostaí neadaithe, áireamháin, aontais

Ceacht 12 as 16 Nuashonraithe 28 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Patrúin chasta: liostaí neadaithe, áireamháin, aontais
  2. Liostaí neadaithe
  3. Áireamháin chun luachanna a shriantú
  4. Aontais chineáil a shamhlú
  5. Oibiachtaí athfhillteacha
  6. Patrún: eastóscadh il-eintiteas
  7. Dea-chleachtais do scéimrí casta
  8. An cás a chuireann gach rud faoi thástáil: an chairt eagraíochta
  9. Príomhphointí

Patrúin chasta: liostaí neadaithe, áireamháin, aontais

Tá cásanna eastósctha simplí (réad cothrom le réimsí téacs) furasta a láimhseáil. Tagann na fíordhúshláin chun cinn le struchtúir chasta: liostaí d’obairchtaí neadaithe, cineálacha coinníollacha, agus réimsí polaimorfacha. Taispeánann an ceacht seo duit conas scéimre láidre a dhearadh do na cásanna casta seo.

Liostaí neadaithe

Is é an patrún is coitianta i dtáirgeadh ná liosta d’obairchtaí a eastóscadh ina bhfuil fo-liostaí féin ag gach oibiacht. Déanann an scéimre thíos cur síos ar chlár oiliúna le trí leibhéal: an oibiacht chláir lena teideal agus a fhad, eagar de mhodúil a bhfuil teideal agus cuspóirí téacsúla ag gach ceann acu, agus ar deireadh na ceachtanna do gach modúl, arna gcur síos ag teideal, fad i nóiméid, agus cineál atá srianta ag enum.

Ní leor léamh amháin don mhúnla anseo: ní mór dó gach ceacht a cheangal leis an modúl ceart, rud a chiallaíonn go gcaithfidh sé tuiscint a bheith aige ar ordlathas a chuirtear in iúl uaireanta le leibhéil cheanntáisc amháin. Sin é an fáth go bhfuil na réimsí an-chruinn ag an tríú leibhéal—fad i nóiméid seachas “fad” ginearálta a chuirtear in iúl uaireanta in uaireanta, uaireanta i seisiúin. Dá chruinne na nóid duilleoige den chrann, is lú an leisce a bheidh ar an múnla.

import json
from openai import OpenAI

client = OpenAI()

# Schema: extract a training program with modules and lessons
formation_schema = {
    "type": "object",
    "properties": {
        "titre": {"type": "string"},
        "duree_totale_heures": {"type": "number"},
        "modules": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "titre_module": {"type": "string"},
                    "objectifs": {
                        "type": "array",
                        "items": {"type": "string"}
                    },
                    "lecons": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "titre_lecon": {"type": "string"},
                                "duree_minutes": {"type": "integer"},
                                "type": {
                                    "type": "string",
                                    "enum": ["theorie", "pratique",
                                             "évaluation"]
                                }
                            },
                            "required": ["titre_lecon",
                                         "duree_minutes", "type"],
                            "additionalProperties": False
                        }
                    }
                },
                "required": ["titre_module", "objectifs", "lecons"],
                "additionalProperties": False
            }
        }
    },
    "required": ["titre", "duree_totale_heures", "modules"],
    "additionalProperties": False
}

Áireamháin chun luachanna a shriantú

Is iad na háireamháin (enums) an bealach is iontaofa chun luachanna féideartha réimse a theorannú. Cuireann Aschur Struchtúrtha i bhfeidhm iad ag leibhéal na giniúna: murab ionann agus treoir scríofa sa leid, ní féidir iad a neamhaird ar lá tuirse staitistiúil. Déanann sé seo luachmhar iad nuair a chothaíonn an luach eastósctha ráiteas switch, colún innéacsaithe, nó riail ródaire—trí áit nach mbíonn earráid chrua mar thoradh ar luach gan choinne, ach tost ina ionad.

Déanann an scéimre aicmithe a leanas sórtáil ar iarratais isteach ar feadh ceithre ais: aimsíonn categorie_principale an roinn ábhartha, déanann sous_categorie é a bheachtú laistigh den roinn sin, úsáidtear priorite chun an scuaine a shórtáil, agus cinneann action_requise cad atá le déanamh leis an ticéad. Tá pointe dearaidh amháin a thuilleann aird: tá an dá luach dhéag de sous_categorie comhréidh seachas ceangailte lena gcatagóir tuismitheora, toisc nach dtugann an módh dian spleáchas coinníollach idir dhá enum. Dá bhrí sin, ní choscann aon rud an comhcheangal “juridique” agus “recrutement”, agus ní mór an chomhsheasmhacht seo a fhíorú tar éis glactha.

# Multi-level classification system
classification_schema = {
    "type": "object",
    "properties": {
        "categorie_principale": {
            "type": "string",
            "enum": ["technique", "commercial", "juridique",
                     "rh", "finance"]
        },
        "sous_categorie": {
            "type": "string",
            "enum": [
                "bug", "feature", "performance",
                "devis", "facturation", "contrat",
                "recrutement", "conge", "formation",
                "budget", "audit", "conformite"
            ]
        },
        "priorite": {
            "type": "string",
            "enum": ["critique", "haute", "moyenne", "basse"]
        },
        "action_requise": {
            "type": "string",
            "enum": ["repondre", "escalader", "archiver",
                     "planifier", "deleguer"]
        }
    },
    "required": ["categorie_principale", "sous_categorie",
                  "priorite", "action_requise"],
    "additionalProperties": False
}

Aontais chineáil a shamhlú

Tacaíonn Scéimre JSON le anyOf do chineálacha coinníollacha, ach tá teorainneacha le hAschur Struchtúrtha dian OpenAI. Is é an patrún molta ná réimse idirdhealaitheora a úsáid: sainíonn tú oibiacht amháin, atá leathan go leor chun gach cás a chlúdach, agus léiríonn réimse type cé acu ceann atá á chur síos agat.

# Pattern: an event can be a meeting, a task, or a reminder
event_schema = {
    "type": "object",
    "properties": {
        "type": {
            "type": "string",
            "enum": ["reunion", "tache", "rappel"]
        },
        "titre": {"type": "string"},
        "date": {"type": "string"},
        "heure_debut": {"type": ["string", "null"]},
        "heure_fin": {"type": ["string", "null"]},
        "participants": {
            "type": "array",
            "items": {"type": "string"}
        },
        "lieu": {"type": ["string", "null"]},
        "priorite": {
            "type": ["string", "null"],
            "enum": ["haute", "moyenne", "basse", None]
        },
        "description": {"type": "string"}
    },
    "required": ["type", "titre", "date", "heure_debut",
                  "heure_fin", "participants", "lieu",
                  "priorite", "description"],
    "additionalProperties": False
}

Is é an cleas gach réimse atá sonrach do chineál amháin a dhéanamh in-null, ag baint úsáide as an nodaireacht "type": ["string", "null"]. I gcás cruinnithe, líontar participants agus lieu; i gcás meabhrúcháin, is ionann iad agus null. Ansin léann do chód an t-idirdhealaitheoir ar dtús agus tá a fhios agat láithreach cé na heochracha a bhfuil ciall leo—díreach an léamh a dhéanfá d’aontas clibeáilte i dteanga chlóscríofa. Is fearr an praghas le híoc, scéimre níos faide agus nullanna le láimhseáil, ná trí ghlao ar leith.

Oibiachtaí athfhillteacha

Do struchtúir chrainn—roghchláir, cairteacha eagraíochta, snáitheanna plé—úsáid $defs do thagairtí athfhillteacha. Is é an prionsabal ná an chruth athfhillteach a ainmniú uair amháin, agus ansin tagairt a dhéanamh dó laistigh de féin. Anseo, tá eagar freagraí ag trácht ina bhfuil gach eilimint ina thrácht arís: níl an doimhneacht seasta ag am na scríbhneoireachta, leanann sí doimhneacht na cáipéise anailísithe. Seo an t-aon bhealach réasúnach chun snáithe plé a phróiseáil gan a bheith ar an eolas roimh ré an bhfuil dhá leibhéal freagartha nó seacht ann.

# Structure of a comment with nested replies
comment_schema = {
    "type": "object",
    "properties": {
        "commentaires": {
            "type": "array",
            "items": {"$ref": "#/$defs/comment"}
        }
    },
    "required": ["commentaires"],
    "additionalProperties": False,
    "$defs": {
        "comment": {
            "type": "object",
            "properties": {
                "auteur": {"type": "string"},
                "contenu": {"type": "string"},
                "sentiment": {
                    "type": "string",
                    "enum": ["positif", "negatif", "neutre"]
                },
                "reponses": {
                    "type": "array",
                    "items": {"$ref": "#/$defs/comment"}
                }
            },
            "required": ["auteur", "contenu", "sentiment",
                          "reponses"],
            "additionalProperties": False
        }
    }
}

Patrún: eastóscadh il-eintiteas

Nuair a bhíonn ilchineálacha eintiteas i dtéacs, is é an tspreagadh ná eastóscadh amháin a rith in aghaidh gach teaghlaigh. Déanann an scéimre il-eintiteas níos fearr: iarrann sé daoine, eagraíochtaí, dátaí, agus méideanna in aon pas amháin. Ní hamháin go sábhálann sé glaonna is ea an sochar; is é go bhfeiceann an múnla an téacs uair amháin agus gur féidir leis an méid a aimsíonn sé ann a nascadh—duine a cheangal lena eagraíocht, méid a bhaint leis an gcomhthéacs a thugann ciall dó.

Is fiú an dúbailt ar dhátaí, date_brute agus date_iso, a choinneáil mar atá i do scéimrí féin: caomhnaíonn sé an frásaíocht bhunaidh chun críche iniúchta agus soláthraíonn sé luach normalaithe. Comhlíonann an réimse contexte, atá i láthair ar dhátaí agus ar mhéideanna, an ról céanna: gan é, ní bheidh a fhios ag aon duine an raibh 12,000 euro ina luachan, ina phionós, nó ina bhuiséad bliantúil.

multi_entity_schema = {
    "type": "object",
    "properties": {
        "personnes": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "nom": {"type": "string"},
                    "role": {"type": "string"},
                    "organisation": {"type": ["string", "null"]}
                },
                "required": ["nom", "role", "organisation"],
                "additionalProperties": False
            }
        },
        "organisations": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "nom": {"type": "string"},
                    "type": {
                        "type": "string",
                        "enum": ["entreprise", "association",
                                 "administration", "autre"]
                    },
                    "secteur": {"type": ["string", "null"]}
                },
                "required": ["nom", "type", "secteur"],
                "additionalProperties": False
            }
        },
        "dates": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "date_brute": {"type": "string"},
                    "date_iso": {"type": "string"},
                    "contexte": {"type": "string"}
                },
                "required": ["date_brute", "date_iso", "contexte"],
                "additionalProperties": False
            }
        },
        "montants": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "valeur": {"type": "number"},
                    "devise": {"type": "string"},
                    "contexte": {"type": "string"}
                },
                "required": ["valeur", "devise", "contexte"],
                "additionalProperties": False
            }
        }
    },
    "required": ["personnes", "organisations", "dates", "montants"],
    "additionalProperties": False
}

Dea-chleachtais do scéimrí casta

Seachnaíonn ceithre nós an chuid is mó de na díomá. Tosaigh go simplí: bailíochtaigh oibiacht chothrom ar do shonraí fíora sula gcuirfidh tú aon neadú leis, murach sin ní bheidh a fhios agat an dtagann teip ón scéimre nó ó dheacracht na tasc. Ina dhiaidh sin, tréig an réimse roghnach, a chuireann an módh dian ar ceal, agus déan in-null de ina ionad. Comhlíon teorainn eimpíreach freisin—thar trí nó ceithre leibhéal neadaithe titann an cháilíocht, agus is fearr an t-eastóscadh a roinnt ina dhá phas: ar dtús liosta na modúl, ansin glao in aghaidh gach modúil chun a chuid ceachtanna a mhionsonrú. Ar deireadh, coinnigh an roinnt oibre i gcuimhne: srianaíonn an scéimre agus a chuid áireamhán an struchtúr, treoraíonn an leid córais an t-ábhar. Má dhéanann an múnla sórtáil i gceart ach má eastóscaíonn sé an t-eolas mícheart, is é an leid is gá duit a choigeartú.

An cás a chuireann gach rud faoi thástáil: an chairt eagraíochta

Tackle an cás athfhillteach, an chuid is oideachasúla den cheacht. Sainigh scéimre chun cairt eagraíochta cuideachta a eastóscadh, áit ar féidir le gach fostaí fo-oibrithe a bheith aige ar fostaithe iad féin iad. Déan tástáil air ar théacs a chuireann síos ar eagraíocht de chúigear déag go fiche duine, scríofa i bprós agus ní mar liosta: seo an áit a gcaithfidh an múnla línte tuairiscithe a thátal ó fhrásaí cosúil le “reports to” nó “within the team of”.

Fíoraigh go bhfuil gaolmharaíocht ordlathasach neadaithe i gceart, ag faire amach do dhaoine a luaitear i bhfad óna mbainisteoir—seo an pointe briste gnáth. Ar deireadh, cuir áireamháin le róil (feidhmiúcháin, bainistíochta, oibríochtúla) agus breathnaigh an bhfeabhsaíonn nó an ndéanann an srian dochar don líne tuairiscithe: is féidir le catagóiriú a fhorchuidiú leis an múnla nó é a bhrú i dtreo roghanna treallacha ar phróifílí hibrideacha.

Príomhphointí

  • Is iad liostaí neadaithe an patrún is coitianta i dtáirgeadh
  • Cuirtear áireamháin i bhfeidhm ag leibhéal na giniúna—bain tairbhe astu
  • Samhlaigh aontais le réimse idirdhealaitheora agus réimsí in-null
  • Cumasaíonn $defs struchtúir athfhillteacha (tráchtanna, crainn)
  • Teorainn doimhneacht neadaithe go 3-4 leibhéal