Tacair shonraí: Tóg tacair mheastóireachta agus déan athrá
Ar an leathanach seo
An ceacht athscríofa an 2 Samhain, 2026 bunaithe ar an leathanach Datasets ó Mistral agus ar SDK
mistralai3.7.0: tápayloadsaorchruthach aguspropertiesi 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 modhimport_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) agusproperties(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, agusexport_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