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

Sainigh Scéimí le Pydantic

Ceacht 7 as 12 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Pydantic: Bunús Aschuir Struchtúrtha Saincheaptha i bPython
  2. Samhail Shimplí a Shainiú
  3. Cineálacha a Úsáidfidh Tú
  4. Samhlacha Neadaithe
  5. Treoraigh an tSamhail le Cur Síos
  6. Tagann Bailíochtú Saor in Aisce
  7. Príomhphointí

Pydantic: Bunús Aschuir Struchtúrtha Saincheaptha i bPython

Is é Pydantic an leabharlann bailíochtaithe sonraí is coitianta i bPython. Ligeann sé duit samhlacha sonraí a shainiú le cineálacha docht, rud atá díreach mar a úsáideann API Mistral iad d’Aschuir Struchtúrtha Saincheaptha. Má oibríonn tú i bPython, is é Pydantic do phríomhuirlis chun scéimí aschuir a chur síos: is é an rud a scríobhann tú i rang ná an rud a bheidh an tsamhail srianta chun a tháirgeadh.

Seo an dea-scéal maidir le suiteáil: tá Pydantic san áireamh mar spleáchas den SDK Mistral. Má tá mistralai suiteáilte cheana féin agat, ní gá duit aon rud eile a dhéanamh.

pip install mistralai
# Pydantic v2 is included automatically

Seiceáil ghairid ar an leagan chun iontais a sheachaint, ós rud é gur athraigh an chomhréir bailíochta idir príomhleaganacha:

import pydantic
print(pydantic.__version__)  # 2.x required

Samhail Shimplí a Shainiú

Is rang é samhail Pydantic a thagann in oidhreacht ar BaseModel, áit a bhfuil gach tréith ina réimse le cineál sainráite.

from pydantic import BaseModel

class Contact(BaseModel):
    name: str
    email: str
    phone: str
    company: str

Insíonn an tsamhail seo do Mistral: “Caithfidh do aschur a bheith ina oibiacht JSON leis na 4 réimse seo go díreach, agus iad uile de chineál teaghráin.” Ní gá aon treoracha breise sa leid chun an struchtúr seo a fháil.

Cineálacha a Úsáidfidh Tú

Tacaíonn Pydantic le gach cineál caighdeánach Python, agus tuigeann Mistral iad go léir. Tugann an tsamhail seo a leanas iad le chéile i gcás réadúil—anailís a dhéanamh ar thicéad tacaíochta—agus léiríonn sé conas a chumascann siad: bunchineálacha do réimsí simplí, Optional do shannadh nach bhfuil ainmnithe fós, Enum do thosaíocht nach féidir ach ceithre luach a ghlacadh, agus liostaí do chlibeanna agus do IDanna gaolmhara.

from pydantic import BaseModel
from typing import Optional
from enum import Enum

class Priority(str, Enum):
    low = "low"
    medium = "medium"
    high = "high"
    critical = "critical"

class TicketAnalysis(BaseModel):
    # Basic types
    title: str
    description: str
    ticket_id: int
    confidence: float
    is_urgent: bool

    # Optional types
    assignee: Optional[str] = None

    # Enums (constrained values)
    priority: Priority

    # Lists
    tags: list[str]
    related_ids: list[int]

Seo an bileog ghairid chomhfhreagrach:

CineálBrí
strteaghrán
intslánuimhir
floatuimhir dheachúlach
boolboole (fíor/bréagach)
list[T]liosta d’eilimintí de chineál T
Optional[T]réimse ar féidir leis a bheith null
Enumluach ó shocrú críochta

Tuilleann Enums lua ar leith: is iad an t-aon bhealach chun a ráthú nach mbeidh tosaíocht riamh "very urgent" nó "P1" ag brath ar mheon na samhla.

Samhlacha Neadaithe

Is annamh a bhíonn sonraí sa saol mór cothrom. Baineann teagmháil le cuideachta, agus tá seoladh ag an gcuideachta sin. Ligeann Pydantic duit samhlacha a neadú chomh domhain agus is gá, agus leanann Mistral an tordlach.

from pydantic import BaseModel
from typing import Optional

class Address(BaseModel):
    street: str
    city: str
    postal_code: str
    country: str

class Company(BaseModel):
    name: str
    industry: str
    address: Address  # Nested model

class Person(BaseModel):
    first_name: str
    last_name: str
    email: str
    role: str
    company: Company  # Two-level nesting

Atáirgeann an JSON ginte an struchtúr crainn seo go díreach:

{
  "first_name": "Marie",
  "last_name": "Dupont",
  "email": "[email protected]",
  "role": "Sales Director",
  "company": {
    "name": "TechVision SAS",
    "industry": "Technology",
    "address": {
      "street": "42 rue de la Paix",
      "city": "Paris",
      "postal_code": "75002",
      "country": "France"
    }
  }
}

Baineann an mheicníocht chéanna míreanna iolracha amach ag an am céanna: cuimsíonn samhail liosta de shamhail eile, agus faigheann tú catalóg iomlán i nglao amháin.

from pydantic import BaseModel

class Product(BaseModel):
    name: str
    price: float
    category: str
    in_stock: bool

class Catalog(BaseModel):
    products: list[Product]
    total_count: int

Treoraigh an tSamhail le Cur Síos

Ní insíonn ainm réimse an scéal iomlán. D’fhéadfadh score grád as 10 a chiallú, céatadán, nó luach idir 0 agus 1—caithfidh an tsamhail tuairim a dhéanamh. Baineann cur síos an doiléireacht seo: cuimsítear iad sa scéim JSON a sheoltar chuig Mistral agus feidhmíonn siad mar threoracha in aghaidh an réimse.

from pydantic import BaseModel, Field

class SentimentAnalysis(BaseModel):
    sentiment: str = Field(
        description="Overall sentiment: 'positive', 'negative', or 'neutral'"
    )
    score: float = Field(
        description="Confidence score between 0.0 and 1.0"
    )
    keywords: list[str] = Field(
        description="The 3-5 main keywords from the text"
    )
    summary: str = Field(
        description="Summary in one sentence maximum"
    )

Dá mhéad cruinnis atá sna cur síos seo, is amhlaidh is fearr cáilíocht an aschuir. Is é seo an chuid den socrú iomlán a thugann an toradh is airde: minic a chuireann cúpla focal dea-roghnaithe in ionad mír iomlán leide.

Socraíonn Field luachanna réamhshocraithe freisin. Sa sampla seo a leanas, déantar an teanga a réamhshocrú go "fr" mura aimsíonn an tsamhail an fhaisnéis, fanann líon na bhfocal None mura féidir é a chinneadh, agus tosaíonn clibeanna mar liosta folamh buíochas le default_factory.

from pydantic import BaseModel, Field
from typing import Optional

class ArticleMetadata(BaseModel):
    title: str
    author: str
    language: str = Field(default="fr", description="ISO 639-1 language code")
    word_count: Optional[int] = None
    tags: list[str] = Field(default_factory=list)

Líonfaidh an tsamhail réimsí le luachanna réamhshocraithe má aimsíonn sí an fhaisnéis, nó coimeádfaidh sí an luach réamhshocraithe murach sin.

Tagann Bailíochtú Saor in Aisce

Ar deireadh ach ní ar an tábhacht is lú: tá bailíochtú uathoibríoch. Mura meaitseálann luach an cineál dearbhaithe, ardaíonn Pydantic ValidationError láithreach a léiríonn go beacht cé acu réimse atá i gceist, gan duit líne amháin cód seiceála a scríobh.

from pydantic import ValidationError

try:
    analysis = SentimentAnalysis(
        sentiment="positive",
        score="not a number",  # Type error
        keywords=["test"],
        summary="Summary"
    )
except ValidationError as e:
    print(e)
    # 1 validation error for SentimentAnalysis
    # score
    #   Input should be a valid number [type=float_parsing, ...]

Imíonn an cód seiceála láimhe go léir a scríobhadh sa cheacht roimhe seo anseo, agus cuirtear dearbhú na samhla ina ionad.

Príomhphointí

  • Is é Pydantic BaseModel bunús gach scéime Saincheaptha i bPython
  • Úsáid cineálacha sainráite: str, int, float, bool, list[T], Optional[T]
  • Cumasaíonn samhlacha neadaithe struchtúir JSON casta
  • Feabhsaíonn Field(description=...) cáilíocht an aschuir trí threoir a thabhairt don tsamhail
  • Tá bailíochtú uathoibríoch—braitear earráidí cineáil láithreach