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

Cruthaigh Postais Bhaisc, Rianaigh Stádas, agus Íoslódáil Torthaí

Ceacht 3 as 16 Nuashonraithe 3 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Ó Chomhad JSONL go Torthaí: An Timthriall Iomlán
  2. Postais Bhaisc a Chruthú
  3. Stádais Postais Bhaisc
  4. Dul chun cinn a Rianú
  5. Torthaí a Íoslódáil
  6. Do Chuid Postais a Liostú agus a Bhainistiú
  7. Sruth Oibre Ó Thús go Deireadh
  8. Príomhphointí

Nuashonraithe 3 Samhain, 2026: Forlíonadh do 3 Samhain: filleann files.download freagra HTTP (httpx2.Response); léigh a chuid ábhair le .read() sula nglaoitear ar .decode(). Braitheann uaslódáil ar file={"file_name": …, "content": …}. Níl an eochair API crua-chódaithe a thuilleadh.

Ó Chomhad JSONL go Torthaí: An Timthriall Iomlán

Tá do chomhad JSONL ullmhaithe agus uaslódaithe agat, agus tá file_id agat. Is é an chéad chéim eile ná an comhad ciúin sin a thiontú ina thorthaí inúsáidte: cruthaigh an postais bhaisc, déan monatóireacht ar a dhul chun cinn thar na nóiméad nó na huaireanta a thógann an próiseáil, agus ansin faigh na freagraí agus déan iad a réiteach. Siúlfaidh an ceacht seo tríd an gcód Python ó thús go deireadh san ord díreach a scríobhfaidh tú é.

Postais Bhaisc a Chruthú

Ní theastaíonn ach glao amháin chun é a chruthú. Sonraíonn tú an comhad foinse, an tsamhail, agus an spriocphointe deiridh:

from mistralai.client import Mistral
import time

client = Mistral(api_key="your-api-key")

# Cruthaigh an postais bhaisc
job = client.batch.jobs.create(
    input_files=[batch_file.id],   # ID an chomhaid uaslódaithe
    model="mistral-small-latest",
    endpoint="/v1/chat/completions",
    metadata={"project": "document-analysis", "version": "1.0"}
)

print(f"Job created: {job.id}")
print(f"Initial status: {job.status}")

Tuilleann gach paraiméadar nóta:

  • input_files — Liosta de IDanna comhad uaslódaithe. Is féidir leat comhaid iolracha a chur ar postais amháin.
  • model — An tsamhail Mistral le húsáid. Níl ach samhail amháin in aghaidh gach postais bhaisc.
  • endpoint — An pointe deiridh API sprioc (caithfidh sé teacht le formáid an body i do JSONL).
  • metadata — Foclóir roghnach de mheiteashonraí saincheaptha chun do phostais a eagrú agus a aimsiú.

Struchtúraíonn an srian “samhail amháin in aghaidh an phostais” an chaoi a roinneann tú do chuid oibre: más mian leat dhá shamhail a chur i gcomparáid ar an gcorpas céanna, cuir dhá phostais ar leith isteach a dhíríonn ar an gcomhad céanna. Maidir le meiteashonraí, d’fhéadfadh sé a bheith cosúil le rud tánaisteach go dtí go mbeidh tríocha postais i do stair; ansin, ligeann an péire tionscadal/leagan atá thuas duit an baisc a tháirg sonraí amhrasacha a aimsiú i dtrí shoicind cothroma.

Stádais Postais Bhaisc

Gluaiseann postais bhaisc trí roinnt stádas le linn a thimthrialla:

StádasCur síos
QUEUEDSa scuaine, gan tosú fós
RUNNINGPróiseáil ar siúl
SUCCESSCríochnaithe go rathúil
FAILEDTheip ar an bpróiseáil
TIMEOUT_EXCEEDEDSáraíodh an t-am feidhmithe
CANCELLATION_REQUESTEDIarradh cealú
CANCELLEDCealaithe

Tá ceithre cinn de na seacht stádas seo críochnaitheach—SUCCESS, FAILED, TIMEOUT_EXCEEDED, agus CANCELLED—agus tiomáineann an t-idirdhealú seo an lúb monatóireachta: fad is nach bhfuil an stádas sa tacar seo, tá an postais beo fós agus caithfidh tú fanacht. Go háirithe, ní stádas stoptha é CANCELLATION_REQUESTED ach ceann idirthréimhseach; d’éireodh cód a chaitheann leis mar cheann críochnaitheach as an lúb ró-luath.

Dul chun cinn a Rianú

Cuimsíonn an patrún pollála thíos an loighic seo go beacht, le cosantóir réimsí uasta chun cosc a chur ar script dearmadta rith go deo:

def wait_for_batch(client, job_id, poll_interval=10, max_wait=3600):
    """Fan go gcríochnóidh postais bhaisc trí pholláil."""
    elapsed = 0
    terminal_states = {"SUCCESS", "FAILED", "TIMEOUT_EXCEEDED", "CANCELLED"}

    while elapsed < max_wait:
        job = client.batch.jobs.get(job_id=job_id)
        print(f"[{elapsed}s] Status: {job.status}")

        if job.status in terminal_states:
            return job

        time.sleep(poll_interval)
        elapsed += poll_interval

    raise TimeoutError(f"Job {job_id} still running after {max_wait}s")

# Úsáid
completed_job = wait_for_batch(client, job.id)
print(f"Final result: {completed_job.status}")

Oibríonn eatramh deich soicind do phostais a mhaireann cúpla nóiméad; le haghaidh rith thar oíche a phróiseálann na céadta mílte líne, méadaigh é go nóiméad nó níos mó. Ní chuireann cruinneas pollála níos mó luach leis sin agus ní dhéanann sé ach glaonna API gan ghá a charnadh.

Torthaí a Íoslódáil

Nuair a shroicheann an stádas SUCCESS, nochtann an postais output_file a íoslódálann tú agus a pharsálann tú líne ar líne:

import json

if completed_job.status == "SUCCESS":
    # Faigh ID an chomhaid aschuir
    output_file_id = completed_job.output_file

    # Íoslódáil an t-ábhar
    result_data = client.files.download(file_id=output_file_id)

    # Parsáil torthaí JSONL
    results = {}
    for line in result_data.read().decode("utf-8").strip().split("\n"):
        entry = json.loads(line)
        custom_id = entry["custom_id"]
        response = entry["response"]
        results[custom_id] = response

    # Taispeáin sampla
    for cid, resp in list(results.items())[:3]:
        content = resp["body"]["choices"][0]["message"]["content"]
        print(f"\n--- {cid} ---")
        print(content[:200])

Tá an comhad torthaí i bhformáid JSONL freisin, agus iompraíonn gach líne an custom_id bunaidh in éineacht le freagra iomlán na samhla. Seo áit a dtugann an iarracht ainmniúcháin ón gceacht roimhe seo torthaí: tá sé sách innéacsú de réir custom_id i bhfoclóir chun freagraí a réiteach le do cháipéisí foinse, beag beann ar an ord ina dtagann siad ar ais. Is seiceáil sláinte úsáideach é na chéad trí iontráil a thaispeáint gearrtha go 200 carachtar sula dtosaíonn tú ag scríobh chuig do bhunachar sonraí.

Do Chuid Postais a Liostú agus a Bhainistiú

Is féidir leat an fardal postais a scagadh de réir stádais, rud a ligeann duit a fheiceáil ag aon tráth cad atá ag rith i ndáiríre ar do chuntas:

# Liostaigh gach postais atá ag rith faoi láthair
running_jobs = client.batch.jobs.list(status="RUNNING")
for j in running_jobs.data:
    print(f"Job {j.id} - Model: {j.model} - Created: {j.created_at}")

Agus nuair a bhíonn postais ag tarraingt ar aghaidh nó nuair a fheiceann tú earráid leid tar éis cur isteach, seachnaíonn cealú íoc as próiseáil gan úsáid:

# Cealaigh postais atá ag tógáil ró-fhada
client.batch.jobs.cancel(job_id="job-abc123")

Tá an cealú neamhshioncrónach: bogann an stádas ar dtús go CANCELLATION_REQUESTED, agus ansin go CANCELLED nuair a bhíonn an stop éifeachtach. Ná meas go bhfuil an acmhainn saor in aisce láithreach bonn nuair a fhilltear ar an nglao.

Sruth Oibre Ó Thús go Deireadh

Nuair a chuirtear le chéile iad, cruthaíonn na ceithre chéim seo script ghearr is féidir leat a chur go díreach i sceidealóir:

from mistralai.client import Mistral
import json
import os
import time

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# 1. Uaslódáil an comhad
with open("batch_requests.jsonl", "rb") as f:
    batch_file = client.files.upload(
        file={"file_name": "batch_requests.jsonl", "content": f},
        purpose="batch"
    )

# 2. Cruthaigh an postais
job = client.batch.jobs.create(
    input_files=[batch_file.id],
    model="mistral-small-latest",
    endpoint="/v1/chat/completions"
)

# 3. Fan go gcríochnóidh sé
completed = wait_for_batch(client, job.id)

# 4. Íoslódáil agus parsáil torthaí
if completed.status == "SUCCESS":
    data = client.files.download(file_id=completed.output_file)
    for line in data.read().decode("utf-8").strip().split("\n"):
        entry = json.loads(line)
        print(f"{entry['custom_id']}: OK")
else:
    print(f"Batch failed: {completed.status}")

Athúsáid an creatlach seo ar do chorpas féin le deich líne amháin: bailíochtaífidh tú an slabhra iomlán i gceann cúpla nóiméad sula ngéilleann tú don toirt iomlán.

Príomhphointí

  • Cruthaigh postais bhaisc le client.batch.jobs.create() trí shonrú an chomhaid, na samhla, agus an phointe deiridh
  • Seacht stádas is féidir a bheith ann, lena n-áirítear trí cinn chríochnaitheacha: SUCCESS, FAILED, CANCELLED
  • Is é an patrún caighdeánach chun dul chun cinn a rianú ná polláil le eatramh
  • Tá torthaí i bhformáid JSONL, nasctha le hiarratais trí custom_id
  • Is féidir leat do chuid postais a liostú, a iniúchadh, agus a chealú ag aon am