Sainigh Scéimí le Pydantic
Ar an leathanach seo
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ál | Brí |
|---|---|
str | teaghrán |
int | slánuimhir |
float | uimhir dheachúlach |
bool | boole (fíor/bréagach) |
list[T] | liosta d’eilimintí de chineál T |
Optional[T] | réimse ar féidir leis a bheith null |
Enum | luach ó 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
BaseModelbunú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