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

Ionchuir agus teorainneacha ama

Ceacht 9 as 14 Nuashonraithe 29 Iúil 2026 Ardleibhéal
Ar an leathanach seo
  1. Cad a théann isteach i sruth oibre
  2. Struchtúr agus bailíochtú le Pydantic
  3. Saolré feidhmithe
  4. Dhá leibhéal teorainn ama nach ceart a mheascadh
  5. Príomhphointí

Cad a théann isteach i sruth oibre

Faigheann gach sruth oibre paraiméadair ionchuir a shainíonn a chomhthéacs feidhmithe. Toisc go dtaistealaíonn na paraiméadair seo thar an líonra agus go stóráiltear iad sa loga feidhmithe, ní mór dóibh riail amháin dhian a leanúint: caithfidh siad a bheith in-sraitheáilte mar JSON. Téann cineálacha bunúsacha Python seachad gan fadhb, mar a dhéanann liostaí, foclóirí, agus luachanna nialasacha.

# Primitive types
nom: str = "Marie"
age: int = 32
score: float = 0.95
actif: bool = True

# Collections
tags: list = ["urgent", "client-vip"]
metadata: dict = {"source": "api", "version": 2}

# Nullable
commentaire: str | None = None

Mar sin féin, níl datetime, bytes, set, tuple, agus aicmí saincheaptha nach bhfuil bunaithe ar Pydantic tacaíocht go díreach. Má theastaíonn dáta bille ó do shruth oibre, tiontaigh é go teaghrán ISO 8601 sula gcuireann tú isteach é, agus athchruthaigh an oibiacht laistigh den ghníomhaíocht. Baineann an prionsabal seo le gach cineál den sórt sin: is ortsa atá an freagracht as an tiontú, ní ar an ardán.

Struchtúr agus bailíochtú le Pydantic

Oibríonn sé dicteanar saorchruth a rith, ach cailleann tú gach ráthaíocht faoina bhfuil ann. Maidir le paraiméadair struchtúrtha bailíochtaithe, bíodh muinín agat as samhlacha Pydantic, a dhoiciméadaíonn comhéadan an tsrutha oibre chomh maith le cosaint a thabhairt dó.

from pydantic import BaseModel, Field

class ParametresAnalyse(BaseModel):
    url_document: str
    langue: str = "fr"
    max_tokens: int = Field(default=1000, ge=100, le=10000)
    inclure_metadata: bool = False

@workflows.workflow.define(name="analyse_documentaire")
class AnalyseDocumentaire:
    @workflows.workflow.entrypoint
    async def run(self, params: ParametresAnalyse) -> dict:
        extraction = await extraire_texte(params.url_document, params.langue)
        analyse = await analyser_contenu(extraction["texte"], params.max_tokens)
        
        if params.inclure_metadata:
            metadata = await extraire_metadata(params.url_document)
            return {**analyse, "metadata": metadata}
        
        return analyse

Ar thaobh an ghlaoóra, níl aon rud speisialta le déanamh: éiríonn réimsí an BaseModel ina n-eochracha barrleibhéil sa dicteanar ionchuir go simplí.

execution = await client.workflows.execute_workflow_async(
    workflow_identifier="analyse_documentaire",
    input={
        "url_document": "https://example.com/rapport.pdf",
        "langue": "fr",
        "max_tokens": 2000,
        "inclure_metadata": True
    }
)

Déanann Pydantic bailíochtú uathoibríoch ar na sonraí a fhaightear. Má tá réimse neamhbhailí, teipeann ar an sruth oibre láithreach le teachtaireacht earráide shoiléir, seachas tosú ar fheidhmiú agus titim trí ghníomhaíocht ina dhiaidh sin. Déanann an bhailíochtú seo docht de réir mar is gá: srianta formáide ar sheoladh ríomhphoist, teorainneacha uimhriúla ar thosaíocht, agus os cionn gach rud eile extra = "forbid", a dhiúltaíonn réimsí anaithnide.

class ParametresStricts(BaseModel):
    email: str = Field(pattern=r"^[\w.+-]+@[\w-]+\.[\w.]+$")
    priorite: int = Field(ge=1, le=5)

    class Config:
        extra = "forbid"  # Rejects unknown fields

Tuillfidh an pointe deireanach seo aird. Gan extra="forbid", rachaidh botún clóscríofa i n-ainm réimse gan bhrath: glacfaidh an réimse ionchais lena luach réamhshocraithe agus rithfidh an sruth oibre le paraiméadair nach iad na cinn a bhí beartaithe agat. Is ciúin an teip, agus mar sin is costach í.

Nuair a chaithfidh sruth oibre amháin glacadh le foirmeacha éagsúla ionchuir, ligeann cineálacha aontaithe duit na leaganacha seo a chur síos gan líon na sruthanna oibre a iolrú.

from typing import Union

class TraitementTexte(BaseModel):
    texte: str
    type_traitement: str = "resume"

class TraitementURL(BaseModel):
    url: str
    type_traitement: str = "resume"

class ParametresFlexibles(BaseModel):
    source: Union[TraitementTexte, TraitementURL]

    class Config:
        extra = "forbid"

Saolré feidhmithe

Tá fad uasta feidhmithe ag gach sruth oibre, socraithe ag an bparaiméadar execution_timeout. Go réamhshocraithe, tá sé uair an chloig: tar éis an spriocdháta seo, cealaítear an sruth oibre go huathoibríoch, beag beann ar a dhul chun cinn. Do phróiseas atá ceaptha seasca soicind a mhaireachtáil, tá an luach seo compordach; do phíblíne thar oíche, is gaiste é.

Coigeartaigh an teorainn ama seo de réir nádúr an phróiseála, anuas agus aníos araon. Baineann sruth oibre a phróiseálann go tapa tairbhe as teorainn dhaingean, toisc go gcuireann sárú ansin fadhb fhíor in iúl seachas moilliú sealadach.

from datetime import timedelta

@workflows.workflow.define(
    name="traitement_rapide",
    execution_timeout=timedelta(minutes=10)
)
class TraitementRapide:
    @workflows.workflow.entrypoint
    async def run(self, donnees: dict) -> dict:
        return await traiter(donnees)

Ag an gceann eile, is é 7 lá an uasteorainn cheadaithe. Ní bhíonn ciall ag an bhfad seo ach do phróisis atá ag fanacht le teagmhas seachtrach, de ghnáth bailíochtú daonna: tuarascáil a bailíodh go huathoibríoch ach a shínigh bainisteoir nach mbeidh ar ais ó shaorláí go dtí an tseachtain seo chugainn.

from datetime import timedelta

@workflows.workflow.define(
    name="workflow_longue_duree",
    execution_timeout=timedelta(days=7)
)
class WorkflowLongueDuree:
    @workflows.workflow.entrypoint
    async def run(self, params: dict) -> dict:
        # This workflow can last up to 7 days
        # Useful for processes with human waiting periods
        donnees = await collecter_donnees_multi_sources(params)
        validation = await attendre_validation_humaine(donnees)
        return await finaliser_rapport(validation)

Chun calabrú a dhéanamh, úsáid an t-ord méide seo de réir teaghlaigh úsáide.

Cás úsáideTeorainn ama molta
Próiseáil fíor-ama1-5 nóiméad
Píblíne sonraí15-60 nóiméad
Giniúint tuarascála casta1-4 uair an chloig
Sruth oibre le bailíochtú daonna1-7 lá

Dhá leibhéal teorainn ama nach ceart a mheascadh

Cuireann execution_timeout teorainn leis an sruth oibre ar fad; cuireann start_to_close_timeout teorainn le gníomhaíocht amháin. Maireann an dá cheann le chéile agus comhlánaíonn siad a chéile: cosnaíonn an chéad cheann thú ó shruth oibre nach gcríochnaíonn riamh, agus cosnaíonn an dara ceann thú ó ghníomhaíocht atá ar crochadh ar sheirbhís chiúin. Tabhair faoi deara san sampla thíos go bhfuil teorainn ama an chliaint HTTP (240 soicind) níos ísle d’aon ghnó ná an start_to_close_timeout (5 nóiméad), ionas go dtagann an earráid chun solais go glan sula ngearrann an t-ardán an nasc.

from datetime import timedelta

@workflows.activity(
    start_to_close_timeout=timedelta(minutes=5)
)
async def appel_api_externe(params: dict) -> dict:
    # This activity has 5 minutes to complete
    async with httpx.AsyncClient(timeout=240) as client:
        response = await client.post(params["url"], json=params["data"])
    return response.json()

@workflows.workflow.define(
    name="pipeline_multi_etapes",
    execution_timeout=timedelta(hours=2)
)
class PipelineMultiEtapes:
    @workflows.workflow.entrypoint
    async def run(self, sources: list) -> dict:
        # The entire workflow has 2 hours
        # But each individual activity has its own timeout
        resultats = []
        for source in sources:
            resultat = await appel_api_externe(source)
            resultats.append(resultat)
        return {"résultats": resultats}

Fleasc deireanach amháin do d’ionchuir: coinnigh éadrom iad. Is é 2 MB an teorainn, agus níl aon rud a chuireann iallach ort teacht gar dó. Seol URL doiciméid seachas a chuid ábhair, ID ordaithe seachas an t-ordú iomlán, agus lig do na gníomhaíochtaí na sonraí a fháil. Sainigh luachanna réamhshocraithe do gach rud roghnach, doiciméadaigh gach réimse le Field(description="..."), agus cuir bailíochtú ar iontaoibh Pydantic seachas ráitis if atá scaipthe ar fud an tsrutha oibre.

Príomhphointí

  • Ní mór ionchuir srutha oibre a bheith in-sraitheáilte mar JSON (str, int, float, bool, list, dict)
  • Úsáid Pydantic BaseModel le haghaidh ionchuir struchtúrtha le bailíochtú uathoibríoch
  • Is é 1 uair an chloig an teorainn ama réamhshocraithe, inchoigeartaithe suas le 7 lá ar a mhéad
  • Déan idirdhealú idir teorainn ama an tsrutha oibre (execution_timeout) agus teorainn ama na gníomhaíochta (start_to_close_timeout)
  • Coinnigh ionchuir éadrom: IDanna agus URLanna seachas sonraí amh mhóra