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

Tacair shonraí: Tóg tacair mheastóireachta agus déan athrá

Ceacht 15 as 16 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. An nasc deiridh sa lúb athrá
  2. Struchtúr an taifid
  3. Foinseí sonraí
  4. Athbhreithniú agus easpórtáil
  5. Déan meastóireacht ar thacar sonraí Studio
  6. Dea-chleachtais bhainistíochta
  7. Príomhphointí

An ceacht athscríofa an 2 Samhain, 2026 bunaithe ar an leathanach Datasets ó Mistral agus ar SDK mistralai 3.7.0: tá payload saorchruthach agus properties i ngach taifead; líontar tacair shonraí trí iontráil láimhe, iompórtáil comhaid, nó spáin ón Explorer, agus seoltar iad mar atá siad chuig meastóireachtaí as líne. Níl an modh import_from_explorer ón leagan roimhe seo ann a thuilleadh. Foinse: Datasets · Explore traces.

An nasc deiridh sa lúb athrá

Is éard atá i dtaicar sonraí ná bailiúchán de chásanna tástála a thiomáineann meastóireacht as líne. Tugann sé cuimhne do do phróiseas cáilíochta: is féidir gach teagmhas a breathnaíodh sa táirgeadh a dhéanamh ina chás tástála, agus déantar gach leagan nua den fheidhmchlár a thomhas ina choinne. Gan tacar sonraí cobhsaí, tá tú ag déanamh comparáide idir tuairimí; leis ceann, tá tú ag déanamh comparáide idir uimhreacha.

Struchtúr an taifid

I Studio, tá payload i ngach taifead—réad JSON ina sainíonn tú na heochracha—agus properties, ar meiteashonraí iad nach seoltar chuig an tasc atá á mheastóireacht. Le linn meastóireachta, éiríonn an payload ina thaifead ionchuir díreach mar atá sé (ctx.input_record).

{"payload": {"ticket": "My October invoice lists the same subscription twice.", "category": "billing"}, "properties": {"source": "incident-2026-10-14"}}

Léiríonn an líne seo freisin formáid iompórtála JSONL do thacair shonraí Studio: réad amháin in aghaidh na líne, ag cur payload agus properties san áireamh.

Foinseí sonraí

Is féidir leat tacar sonraí a líonadh ar bhealaí éagsúla:

  • Iontráil láimhe, in Studio nó tríd an API, taifead ar thaifead
  • Iompórtáil comhad JSONL ag baint úsáide as an bhformáid thuas
  • Ón Explorer: déantar spán amháin, nó suas le 500 spán roghnaithe, a thiontú ina dtaifid (Ceacht 12)
  • Ó Chluichepháirc Studio nó ó thacar sonraí eile
from mistralai.client import Mistral

client = Mistral(api_key="your-api-key")
datasets = client.beta.observability.datasets

# Cruthaigh an tacar sonraí
dataset = datasets.create(
    name="Support tickets — reference set",
    description="Manually validated ticket classification cases",
)
print(f"Dataset: {dataset.id} ({dataset.slug})")

# Cuir taifid leis
cases = [
    {"ticket": "I haven't been able to log in since this morning.", "category": "access"},
    {"ticket": "The PDF export crashes whenever the report exceeds 50 pages.", "category": "bug"},
]
for payload in cases:
    datasets.create_record(
        dataset_id=dataset.id,
        payload=payload,
        properties={"origin": "manual entry"},
    )

I gcás toirteanna móra, iompórtálann import_from_file comhad JSONL atá uaslódaithe cheana (trína file_id), agus ionghabhann import_from_spans spáin rianaithe: ritheann na hiompórtálacha seo mar thascanna cúlra, agus is féidir leat a bprogres a rianú le fetch_task.

Athbhreithniú agus easpórtáil

Déanann list_records atriall ar thaifid leathanach ar leathanach (page_size, page), agus gineann export_to_jsonl easpórtáil a sholáthraíonn an URL íoslódála (file_url) sa fhreagra:

page = datasets.list_records(dataset_id=dataset.id, page_size=50, page=1)
export = datasets.export_to_jsonl(dataset_id=dataset.id)
print(export.file_url)

Déan meastóireacht ar thacar sonraí Studio

Léann meastóireacht as líne tacar sonraí Studio trína slug nó a ID:

from mistralai.evaluations import Dataset, Evaluation, Evaluator, Project

run = await client.evaluation.run(
    project=Project(name="Ticket sorting"),
    evaluation=Evaluation(name="Reference set"),
    dataset=Dataset(slug="support-tickets-reference-set"),
    task=tache,
    evaluators=[Evaluator(name="exactitude", scorer=exactitude)],
)

Anseo, is é client cliant SDK na meastóireachta, agus tá tache agus exactitude sainithe i gCeacht 14. Cuir ceann amháin de slug nó id ar fáil go beacht; ní chruthaíonn roghnú tacair sonraí trína slug ceann nua riamh. Coinnigh dhá riail i gcuimhne: léann rith na taifid atá i láthair ag am tosaithe, suas le 10,000—ní scáthphictiúr é tacar sonraí, mar sin ní dhéanann a mhodhnú difear ach do rithí ina dhiaidh sin—agus má chuirtear taifid leis nó má bhaintear iad le linn na léitheoireachta, teipeann ar an rith sula dtosaíonn sé seachas rith ar thacar neamhchomhsheasmhach.

Dea-chleachtais bhainistíochta

Coinnigh tacar tagartha cobhsaí. Déanann tacar sonraí a athraíonn le gach rith comparáid dodhéanta. Cruthaigh tacar tagartha nach ndéanann tú a mhodhnú ach d’aon ghnó, agus coinnigh tacair shonraí oibre ar leith taobh leis.

Líon é ón táirgeadh. Is iad na cásanna is úsáidí ná iad siúd a d’fhág fadhbanna i ndáiríre: tá spán a aimsíodh san Explorer, áit a gceartaíonn tú an t-aschur ionchais, níos luachmhaire ná deich gcás cumtha.

Doiciméadaigh an bunús. Ní fheiceann an tasc na properties (bunús, dáta, teagmhas gaolmhar), ach inseoidh siad duit sé mhí as seo cén fáth a bhfuil cás ann.

Cothromaigh do chuid sonraí. Déanann tacar sonraí nach bhfuil ann ach cásanna éasca do chóras a mholadh; déanann ceann nach bhfuil ann ach gaistí é a dhíspreagadh. Dírich ar dháileadh iarbhír do thráchta, móide roinnt cásanna imeallacha a aithnítear cheana.

Príomhphointí

  • Taifead tacair sonraí = payload (ionchur tasc) agus properties (meiteashonraí)
  • Iontráil láimhe, iompórtáil JSONL, spáin Explorer, Cluichepháirc: foinseí iolracha do thacar sonraí amháin
  • Nochtann an SDK create, create_record, import_from_file, import_from_spans, list_records, agus export_to_jsonl
  • Léann meastóireachtaí tacar sonraí trí Dataset(slug=...) nó Dataset(id=...), suas le 10,000 taifead
  • Ní scáthphictiúr é tacar sonraí: coinnigh tacar tagartha cobhsaí chun leaganacha a chur i gcomparáid