Cruthaigh Postais Bhaisc, Rianaigh Stádas, agus Íoslódáil Torthaí
Ar an leathanach seo
Nuashonraithe 3 Samhain, 2026: Forlíonadh do 3 Samhain: filleann
files.downloadfreagra HTTP (httpx2.Response); léigh a chuid ábhair le.read()sula nglaoitear ar.decode(). Braitheann uaslódáil arfile={"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 anbodyi 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ádas | Cur síos |
|---|---|
QUEUED | Sa scuaine, gan tosú fós |
RUNNING | Próiseáil ar siúl |
SUCCESS | Críochnaithe go rathúil |
FAILED | Theip ar an bpróiseáil |
TIMEOUT_EXCEEDED | Sáraíodh an t-am feidhmithe |
CANCELLATION_REQUESTED | Iarradh cealú |
CANCELLED | Cealaithe |
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