Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Eżegwixxi u ttestja workflow

Lezzjoni 7 / 14 Aġġornat 3 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Ibbotta workflow
  2. Trigger permezz tal-SDK tal-Python
  3. Trigger permezz ta’ cURL
  4. Eżempju minn tarf għal tarf
  5. Iċċekkja r-riżultati
  6. Immaniġġjar tal-iżbalji
  7. Ittestjar lokali
  8. Punti Ewlenin

Lezzjoni aġġornata fit-3 ta’ Novembru 2026 ibbażata fuq l-SDK mistralai 3.7.0: it-traċċar ta’ eżekuzzjoni issa juża client.workflows.executions.get_workflow_execution_async, u r-riżultat jinqara minn result. Addendum tal-istess jum: l-eżempji preċedenti kienu għadhom jirreferu għal execution.id, execution.output, u execution.error, li huma nieqsa mill-SDK, u qabblu l-istatus ma’ "completed" jew "failed" b’ittri żgħar; issa jużaw execution_id, result, wait_for_result=True, u status b’ittri kbar. Sors: client-python.

Ibbotta workflow

Iktebt l-attivitajiet tiegħek, iddefinixxejt il-workflow tiegħek, u stajt il-worker tiegħek. Issa trid tniedi eżekuzzjoni. Għandek żewġ għażliet: l-SDK tal-Python jew sejħa cURL lejn l-API REST. L-ewwel waħda taqbel mal-iskrpts u s-servizzi tal-Python tiegħek; it-tieni taħdem għal testijiet mgħaġġla fil-linja tal-kmand jew għal triggers minn sistemi mhux tal-Python—webhook, skedatur, jew backend miktub f’lingwa oħra.

Tliet kundizzjonijiet iridu jiġu ssodisfati qabel ma ttriggerja xi ħaġa. Il-worker tiegħek irid ikun qed jaħdem (uv run python worker.py), iċ-ċavetta tal-API tiegħek trid tkun issettjata f’MISTRAL_API_KEY, u l-workflow irid ikun irreġistrat ma’ dak il-worker, jiġifieri jidher fil-lista mgħoddija lil run_worker().

Trigger permezz tal-SDK tal-Python

Ikteb it-trigger f’skritt separat mill-worker, peress li l-proċess tal-worker qatt ma jirritorna l-kontroll:

import asyncio
from mistralai.client import Mistral

async def main():
    client = Mistral()

    execution = await client.workflows.execute_workflow_async(
        workflow_identifier="salutation_workflow",
        input={"nom": "Marie"},
        wait_for_result=True,  # stenna t-tlestija u irċievi r-riżultat
    )

    print(f"Execution ID: {execution.execution_id}")
    print(f"Result: {execution.result}")

if __name__ == "__main__":
    asyncio.run(main())

L-workflow_identifier jaqbel eżattament mal-name iddikjarat f’@workflows.workflow.define(), u l-klavijiet fid-dizzjunarju input jikkorrispondu għall-parametri tal-metodu run tiegħek. Mexxi dan l-iskritt f’terminal separat, u ħalli l-ewwel wieħed okkupat mill-worker:

uv run python trigger.py

B’wait_for_result=True, l-SDK jistenna sakemm l-eżekuzzjoni tintemm u jirritorna r-riżultat direttament, u b’hekk jagħmel l-ittestjar ferm aktar leġibbli għal workflows qosra. Mingħajr dan il-parametru, is-sejħa tirritorna immedjatament bl-identifikatur tal-eżekuzzjoni, li mbagħad tista’ ttraċċa (ara hawn taħt).

Trigger permezz ta’ cURL

Għal testijiet mgħaġġla jew integrazzjoni ma’ sistemi oħra, l-API REST tesponi l-istess trigger:

curl -X POST https://api.mistral.ai/v1/workflows/salutation_workflow/execute \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"nom": "Marie"}, "wait_for_result": true}'

B’wait_for_result, ir-rispons fih l-isem tal-workflow, l-identifikatur tal-eżekuzzjoni, u r-riżultat tiegħu; dawn huma l-oqsma tal-mudell WorkflowExecutionSyncResponse tal-SDK:

{
  "workflow_name": "salutation_workflow",
  "execution_id": "…",
  "result": {
    "message": "Bonjour, Marie !"
  }
}

Żomm dan l-execution_id: hija ċ-ċavetta li se tuża aktar tard biex tistaqsi dwar l-eżekuzzjoni jew tirrikupra t-traċċi tagħha. Mingħajr wait_for_result, ir-rispons jiddeskrivi l-eżekuzzjoni li qed taħdem, inkluż l-status tagħha (RUNNING fil-bidu).

Eżempju minn tarf għal tarf

Ejja nerġgħu lura għall-eżempju tal-pipeline tal-analiżi tad-dokumenti, din id-darba konness kompletament. L-ewwel fajl jgħaqqad id-definizzjonijiet u t-tnedija tal-worker; innota t-tqassir għal 5000 karattru, li jipproteġi kemm il-limitu tad-daqs tal-attività kif ukoll il-baġit tat-tokens tiegħek.

Fajl workflow.py (worker + definizzjonijiet)

import asyncio
import httpx
import mistralai.workflows as workflows
from mistralai.client import Mistral

@workflows.activity()
async def extraire_texte(url: str) -> dict:
    async with httpx.AsyncClient() as client:
        response = await client.get(url)
    return {"texte": response.text[:5000]}  # Limita għal 5000 karattru

@workflows.activity()
async def resumer_texte(texte: str) -> dict:
    client = Mistral()
    response = await client.chat.complete_async(
        model="mistral-large-latest",
        messages=[
            {"role": "system", "content": "Summarize in 3 sentences."},
            {"role": "user", "content": texte}
        ]
    )
    return {"resume": response.choices[0].message.content}

@workflows.workflow.define(name="resume_page_web")
class ResumePageWeb:
    @workflows.workflow.entrypoint
    async def run(self, url: str) -> dict:
        extraction = await extraire_texte(url)
        resume = await resumer_texte(extraction["texte"])
        return {
            "url_source": url,
            "resume": resume["resume"]
        }

async def main() -> None:
    await workflows.run_worker([ResumePageWeb])

if __name__ == "__main__":
    asyncio.run(main())

It-tieni fajl jtriggerja l-workflow u juri r-riżultat, u jimmaniġġja b’mod espliċitu l-każ ta’ falliment—rifless li għandek tadotta mill-ewwel skritt tiegħek:

Fajl trigger.py (trigger)

import asyncio
from mistralai.client import Mistral

async def main():
    client = Mistral()

    print("Launching workflow...")
    execution = await client.workflows.execute_workflow_async(
        workflow_identifier="resume_page_web",
        input={"url": "https://example.com/article"},
    )
    print(f"Execution launched: {execution.execution_id}")

    # Traċċa l-eżekuzzjoni sakemm titlesta
    while True:
        suivi = await client.workflows.executions.get_workflow_execution_async(
            execution_id=execution.execution_id
        )
        if suivi.status not in ("RUNNING", "RETRYING_AFTER_ERROR"):
            break
        await asyncio.sleep(2)

    if suivi.status == "COMPLETED":
        print(f"Summary: {suivi.result['resume']}")
    else:
        print(f"Execution finished with status {suivi.status}")

if __name__ == "__main__":
    asyncio.run(main())

Eżekuzzjoni

Terminal 1 — Ibda l-worker:

uv run python workflow.py

Terminal 2 — Itriggerja l-eżekuzzjoni:

uv run python trigger.py

Iċċekkja r-riżultati

It-terminal tal-worker huwa l-ewwel punt ta’ osservazzjoni tiegħek: juri l-attivitajiet eżegwiti f’ħin reali, flimkien mat-tul ta’ żmien tagħhom, u juri minnufih liema pass jikkonsma l-aktar ħin.

[INFO] Executing activity: extraire_texte
[INFO] Activity completed: extraire_texte (1.2s)
[INFO] Executing activity: resumer_texte
[INFO] Activity completed: resumer_texte (3.4s)
[INFO] Workflow completed: resume_page_web

Għal workflows twal, ovvjament mhux se tibqa’ mwaħħal mat-terminal. Ladarba jkollok l-ID tal-eżekuzzjoni, tista’ tistaqsi dwar l-istatus tagħha fi kwalunkwe ħin minn proċess ieħor:

execution = await client.workflows.executions.get_workflow_execution_async(
    execution_id="exec_abc123"
)
print(f"Status: {execution.status}")
print(f"Result: {execution.result}")

L-istess operazzjoni hija disponibbli permezz ta’ cURL, utli f’skritt ta’ monitoraġġ:

curl https://api.mistral.ai/v1/workflows/executions/exec_abc123 \
  -H "Authorization: Bearer $MISTRAL_API_KEY"

Immaniġġjar tal-iżbalji

Falliment ma jseħħx fl-ewwel eċċezzjoni: il-pjattaforma l-ewwel terġa’ tipprova l-attività skont il-politika ta’ retry tagħha. Biss wara li jintużaw ir-retries kollha, l-eżekuzzjoni tgħaddi għall-istatus FAILED (l-istatus tal-SDK huma b’ittri kbar: RUNNING, COMPLETED, FAILED, CANCELED, TERMINATED, TIMED_OUT, eċċ.), u l-kodiċi li qed isejjaħ irid jimmaniġġja dan il-każ minflok ma jassumi li result dejjem ikun preżenti:

execution = await client.workflows.executions.get_workflow_execution_async(
    execution_id="exec_abc123"
)

if execution.status == "FAILED":
    print(f"Execution {execution.execution_id} failed")

Ir-rispons ma fihx messaġġ ta’ żball: il-kawża tidher fl-istorja tal-eżekuzzjoni u fil-logs (get_workflow_execution_history_async, get_workflow_execution_logs_async). Biex tidentifika l-attività difettuża u s-sekwenza li wasslet għaliha, se tanalizza t-traċċi ta’ OpenTelemetry, koperti fil-Lezzjoni 14.

Ittestjar lokali

Li tmur u tiġi bejn żewġ terminals malajr isir tedjanti waqt l-iżvilupp. Għall-iżvilupp, skritt wieħed jista’ jibda l-worker fl-isfond, jtriggerja l-workflow, imbagħad iwaqqaf kollox:

import asyncio
import mistralai.workflows as workflows

# ... definizzjonijiet tal-attività u tal-workflow ...

async def main():
    # Ibda l-worker fl-isfond
    worker_task = asyncio.create_task(
        workflows.run_worker([MonWorkflow])
    )

    # Stenna sakemm il-worker ikun lest
    await asyncio.sleep(2)

    # Itriggerja l-workflow
    from mistralai.client import Mistral
    client = Mistral()
    execution = await client.workflows.execute_workflow_async(
        workflow_identifier="mon_workflow",
        input={"test": True},
        wait_for_result=True,
    )
    print(f"Result: {execution.result}")

    # Waqqaf il-worker
    worker_task.cancel()

if __name__ == "__main__":
    asyncio.run(main())

L-asyncio.sleep(2) jagħti ħin lill-worker biex jistabbilixxi l-konnessjoni tiegħu qabel it-trigger, u l-worker_task.cancel() finali jipprevjeni li l-iskritt jibqa’ mdendel għal żmien indefinit. Irriżerva din il-konfigurazzjoni għall-iżvilupp: fil-produzzjoni, il-worker u t-triggers jibqgħu proċessi separati b’ċikli ta’ ħajja indipendenti.

Punti Ewlenin

  • Żewġ metodi ta’ trigger: SDK tal-Python (execute_workflow_async) u API REST (cURL)
  • Il-worker irid ikun qed jaħdem biex il-workflow jiġi eżegwit
  • B’wait_for_result=True, l-SDK jistenna t-tlestija u jirritorna r-riżultat (result); inkella jirritorna l-execution_id biex tittraċċa
  • Uża client.workflows.executions.get_workflow_execution_async() biex tiċċekkja l-istatus ta’ eżekuzzjoni
  • L-istatus huma b’ittri kbar (RUNNING, COMPLETED, FAILED, eċċ.); il-kawżi tal-falliment jidhru fl-istorja tal-eżekuzzjoni, fil-logs u fit-traċċi
  • Għall-iżvilupp, għaqqad il-worker u t-trigger f’skritt wieħed billi tuża asyncio