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

Dea-chleachtais agus Achoimre

Ceacht 12 as 12 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Achoimre ar an gCúrsa
  2. Do Chur Chuige a Roghnú
  3. Na Deich Riail Órga
  4. Trí Bhota Chostacha
  5. Cad le Monatóireacht a Dhéanamh
  6. Ag Dul Níos Faide
  7. Píblíne Iomlán
  8. Príomhphointí
  9. Do Chuid Eolais a Thástáil

Achoimre ar an gCúrsa

Tá raon iomlán na meicníochtaí aschurtha struchtúrtha atá ar fáil trí API Mistral scrúdaithe agat. Tugann an ceacht deiridh seo le chéile na rudaí a dhéanann difríocht sa obair laethúil: conas roghnú idir an dá chur chuige, na socruithe nach féidir a shárú, na botúin is coitianta, agus cad ba chóir duit a mhonatóireacht a dhéanamh nuair a bheidh tú i dtáirgeadh.

Do Chur Chuige a Roghnú

Tá ceithre cheist go leor chun cinneadh a dhéanamh, san ord seo. An bhfuil scéima aschurtha sainithe agat? Mura bhfuil, fan le Mód JSON: tá tú i mód taiscéalaíochta nó prótatípaithe, agus bheadh sé róluath samhail sonraí a dhaingniú. Má tá, téigh ar aghaidh go dtí an chéad cheist eile.

An bhfuil tú ag obair i Python nó TypeScript? Má tá, tá Aschurtha Struchtúrtha Saincheaptha réidh duit le Pydantic nó Zod. Mura bhfuil, is é Mód JSON le bailíochtú láimhe do bhealach fós.

An bhfuil tú i dtáirgeadh? Má tá, tá Aschurtha Struchtúrtha Saincheaptha éigeantach, i gcónaí. Seachas sin, tá Mód JSON níos leordhóthanach do phrótatípú.

An athraíonn an scéima go minic? Déanann scéima atá fós ag forbairt Mód JSON níos praiticiúla ar dtús, go dtí go mbíonn na ceanglais cobhsaithe; argóidíonn scéima seasta ar son Aschurtha Struchtúrtha Saincheaptha agus na hiontaofachta a thugann siad.

Na Deich Riail Órga

Baineann an chéad chúigear leis an gcaoi a scríobhann tú do ghlaotha. Socraigh temperature=0 i gcónaí i dtáirgeadh: is namhaid don iontaofacht é athraitheacht teochta, agus níl aon ghá le cruthaitheacht ag baint le heastóscadh.

# Production: deterministic
response = client.chat.parse(
    model="mistral-large-latest",
    messages=messages,
    response_format=MonSchema,
    temperature=0  # Reproducibility
)

Seiceáil finish_reason i gcónaí. Is é seo an t-aon táscaire a thugann rabhadh duit faoi fhreagra gearrtha sula ndéanann tú iarracht é a úsáid.

if response.choices[0].finish_reason != "stop":
    # Response is truncated — increase max_tokens
    raise ValueError(f"Incomplete response: {response.choices[0].finish_reason}")

I Mód JSON, treoraigh an tsamhail sa leid i gcónaí. Ráthaíonn an paraiméadar an chomhréir, ní an struchtúr: is ortsa atá sé na heochracha agus a gcineálacha a lua.

# JSON Mode — the prompt MUST describe the structure
messages = [
    {
        "role": "system",
        "content": "Return JSON with keys: name (string), age (number), city (string)."
    },
    {"role": "user", "content": text}
]

I mód Saincheaptha, déan do réimsí a dhoiciméadú. Is fiú tuairisc chruinn níos mó ná leid fada, agus taistealaíonn sé leis an scéima sa dá theanga.

class Product(BaseModel):
    name: str = Field(description="Commercial product name")
    price: float = Field(description="Price in EUR excluding tax, rounded to 2 decimals")
const ProductSchema = z.object({
  name: z.string().describe("Commercial product name"),
  price: z.number().describe("Price in EUR excluding tax, rounded to 2 decimals"),
});

Scar comhthéacs ó ábhar. Fanann treoracha sa teachtaireacht chórais, agus na sonraí le próiseáil sa teachtaireacht úsáideora—ná déan an contrárthacht riamh, nó déanfaidh an tsamhail mearbhall idir an treoir agus an téacs foinse.

messages = [
    {"role": "system", "content": "You are a data extractor. [Format instructions]"},
    {"role": "user", "content": "[Text to process — NO format instructions here]"}
]

Baineann an dá riail eile le do líon sábháilteachta. Cuir meicníocht athiarrtha i bhfeidhm: ná déan glao amháin riamh gan cúltaca; is é an patrún íosta i dtáirgeadh ná athiarracht le haiseolas. Agus déan bailíochtú thar an scéima, ós rud é go ráthaíonn an scéima an struchtúr ach go bhfanann bailíochtú shéimeantach—teorainneacha, comhsheasmhacht, loighic ghnó—faoi do chúram.

Baineann an trí cinn dheireanacha le hordú. Roghnaigh an tsamhail cheart don chás úsáide ceart: mistral-large-latest do thascanna casta agus eastóscadh il-réimse, mistral-small-latest d’aicmiú simplí agus eastóscadh bunúsach, ministral-8b-latest d’ardmhinicíocht agus íoslatency. Déan logáil ar gach glao i dtáirgeadh, ag taifeadadh na samhla a úsáideadh, an fhad, finish_reason, agus an toradh: gan logaí, tá tú dall. Ar deireadh, ná déan iarracht an leid a fheabhsú ró-luath—tosaigh go simplí, déan tomhas, déan athrá; is gaiste coitianta é feabhsú prémhatureach ar an leid, ach is iad an scéima agus an bailíochtú na luamháin iarbhír.

Trí Bhota Chostacha

Is é an chéad cheart luach max_tokens atá ró-íseal. Gearrfar JSON ar fhreagraí fada, agus ní léireoidh an earráid ach ar dhoiciméid mhóra, go minic tar éis dul beo.

# Dangerous — JSON will be truncated for long responses
response = client.chat.parse(
    model="mistral-large-latest",
    messages=messages,
    response_format=MonSchema,
    max_tokens=128  # Too low for a complex schema
)

Socraigh max_tokens bunaithe ar mhéid ionchais do aschur: éilíonn sonrasc le 20 líne níos mó tócan ná aicmiú simplí.

Is é an dara ceart teocht neamh-nialasach, a dhéanann do thorthaí neamh-in-atáirgthe ar son gan aon bhuachan ar thasc eastóscadh.

# Dangerous in production — non-reproducible results
response = client.chat.parse(
    ...,
    temperature=0.7  # Unnecessary variation for extraction
)

Is é an tríú ceart an frithghníomh samhail amháin a úsáid. Ná húsáid mistral-large do gach rud: ní éilíonn aicmiú dénártha an tsamhail is cumhachtaí, agus déanfaidh ministral-8b an obair 5 huaire níos tapúla ar chostas níos lú.

Cad le Monatóireacht a Dhéanamh

Inis ceithre mhéadrach sláinte do phíblíne. Tomhaiseann an ráta ratha an céatadán glaotha a thugann oibiacht bhailí ar an gcéad iarracht; an ráta athiarrtha, an céatadán glaotha a d’éiligh dara seans. Tugann latency P50/P95 an t-am freagartha meánach agus an 95ú céatadán, rud atá níos nochtana ná an meán. Coinníonn costas in aghaidh an eastóscadh, arna shloinneadh i dtócan a itheadh in aghaidh an ghlao, an bille faoi smacht.

Ar na méadracha seo, seasann roinnt tairseacha foláirimh go maith: údar le foláireamh buí é ráta ratha faoi bhun 95%, foláireamh dearg faoi bhun 85%; éilíonn latency P95 níos mó ná 10 s imscrúdú; agus éilíonn briseadh ciorcaid oscailte foláireamh láithreach.

Ag Dul Níos Faide

Síneann ceithre threo an cúrsa seo go nádúrtha. Úsáideann glaonna feidhme aschurtha struchtúrtha chun glaonna feidhme a bheathú i ngníomhaire. Ligeann sruthú duit an t-aschur struchtúrtha a fháil de réir a chéile, rud atá tábhachtach d’fhreagraí fada. Feabhsaíonn mionchoigeartú samhail Mistral chun cáilíocht an eastóscadh a fheabhsú ar do shonraí sonracha. Ar deireadh, is éard atá i luacháil ná creatlach uathoibríoch a chur ar bun bunaithe ar thacar óir sonraí agus méadracha—is é seo a inseoidh duit an bhfeabhsaíonn athrú leid rudaí i ndáiríre.

Píblíne Iomlán

Tugann an cód seo a leanas cleachtais an chúrsa le chéile i sruth amháin: scéima curtha síos réimse ar réimse, bailíochtóir a dhiúltaíonn scóir lasmuigh de theorainneacha, samhail méadaithe don tasc, temperature=0, max_tokens sainráite, seiceáil ar finish_reason, agus logáil don dá thoradh féideartha.

from mistralai.client import Mistral
from pydantic import BaseModel, Field, field_validator
import logging
import time

logger = logging.getLogger("pipeline")

class CustomerFeedback(BaseModel):
    sentiment: str = Field(description="positive, negative, or neutral")
    score: float = Field(description="Score between -1.0 and 1.0")
    category: str = Field(description="product, service, delivery, price, or other")
    action_required: bool = Field(description="True if action is required")
    summary: str = Field(description="One-sentence summary")

    @field_validator("score")
    @classmethod
    def score_in_range(cls, v):
        if not -1.0 <= v <= 1.0:
            raise ValueError(f"Score out of bounds: {v}")
        return v

def analyze_feedback(client: Mistral, text: str) -> CustomerFeedback:
    start = time.time()
    try:
        response = client.chat.parse(
            model="mistral-small-latest",
            messages=[
                {"role": "system", "content": "Analyze customer feedback."},
                {"role": "user", "content": text}
            ],
            response_format=CustomerFeedback,
            temperature=0,
            max_tokens=256
        )
        assert response.choices[0].finish_reason == "stop"
        result = response.choices[0].message.parsed
        logger.info(f"OK in {time.time()-start:.2f}s — {result.sentiment} ({result.score:+.1f})")
        return result
    except Exception as e:
        logger.error(f"ERROR in {time.time()-start:.2f}s — {e}")
        raise

Tríocha líne nó mar sin, agus tá comhpháirt agat is féidir a phlugáil go sábháilte i lár córais: is é seo go díreach a dhéanann aschurtha struchtúrtha indéanta.

Príomhphointí

  • Úsáid Aschurtha Struchtúrtha Saincheaptha i dtáirgeadh, Mód JSON do phrótatípú
  • Níl temperature=0, seiceáil finish_reason, agus athiarracht inbhéartaithe
  • Roghnaigh an tsamhail bunaithe ar chastacht an tasc agus ar an mbuiséad
  • Déan monatóireacht ar an ráta ratha, ar an latency, agus ar an gcostas
  • Tosaigh go simplí, déan tomhas, ansin déan feabhsú

Do Chuid Eolais a Thástáil

Mód JSON, scéimí, athiarracht: an bhfuil aschur struchtúrtha faoi smacht agat?

1. Mód JSON vs Aschurtha Struchtúrtha Saincheaptha: cad é an difríocht?

Freagra: Ráthaíonn Mód JSON JSON atá bailí ó thaobh na comhréire de; forfheidhmíonn Aschurtha Struchtúrtha Saincheaptha do scéima cruinn chomh maith—réimsí, cineálacha, struchtúr: an conradh iomlán.

2. Cad a sholáthraíonn client.chat.parse() le Pydantic?

Freagra: An lúb iomlán: dearann an scéima Pydantic an struchtúr, srianaíonn an API an ghiniúint, agus tagann an freagra bailíochtaithe agus clóscríofa cheana féin mar oibiacht Python—gan aon pharsáil láimhe.

3. Agus ar thaobh TypeScript?

Freagra: An chompord céanna le Zod: sainíonn agus bailíochtaíonn an scéima Zod an struchtúr—aon fhoinse amháin fírinne don ghiniúint agus don chlóscríobh.

4. Cad le déanamh nuair nach urramaíonn an t-aschur an scéima?

Freagra: Déan bailíochtú go córasach, agus pleanáil straitéis athiarrtha: iarr arís leis an earráid sa chomhthéacs, nó déan íoslaghdú go grásúil—ná bíodh muinín dall agat riamh san aschur.

5. Cathain a bhíonn aschur struchtúrtha riachtanach?

Freagra: Chomh luath agus a itheann clár an freagra gan athbhreithniú daonna: eastóscadh, comhtháthuithe, píblíní—ní cúirtéis é an formáid a thuilleadh, is comhéadan é.

Scéima deartha, giniúint shrianta, bailíochtú aschurtha: an triarach a dhéanann AI inphlugáilte i mbogearraí fíor.