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

Uirlisí Asincronacha agus Comhthreomhara

Ceacht 8 as 25 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Uirlisí Asincronacha agus Comhthreomhara
  2. Uirlisí Asincronacha
  3. Comhthreomhaireacht Uathoibríoch
  4. Comhthreomhaireacht a Rialú
  5. Patrún: Torthaí Comhthreomhara a Chomhiomlánú
  6. Teorainneacha Ama agus Athléimneacht
  7. Feidhmíocht: Tionchar na Comhthreomhaireachta
  8. Príomhphointí

Uirlisí Asincronacha agus Comhthreomhara

I dtimpeallacht táirgeachta, déanann do chuid uirlisí glaoch ar APIanna seachtracha, ceisteanna a chur ar bhunachair shonraí, nó oibríochtaí I/A a dhéanamh. Tógann na hoibríochtaí seo am, agus carnann an t-am sin suas: tógann sé cúig shoicind ar ghníomhaire atá ag slabhrú cúig ghlaoch soicind amháin freagra a thabhairt. Is é uirlisí a dhéanamh asincronach agus leas a bhaint as comhthreomhaireacht dhúchasach an SDK an rud a dhéanann idirdhealú idir taispeántas agus seirbhís inúsáidte.

Uirlisí Asincronacha

Tacaíonn an maisc @function_tool go dúchasach le feidhmeanna async. Níl aon chumraíocht ag teastáil: dearbh async def, úsáid cliant HTTP asincronach, agus déileálfaidh an SDK leis an gcuid eile.

import httpx
from agents import function_tool

@function_tool
async def search_company(name: str) -> str:
    """Cuardaíonn sé faisnéis faoi chuideachta trí API Societe.com."""
    async with httpx.AsyncClient() as client:
        response = await client.get(
            "https://api.societe.com/v1/search",
            params={"q": name},
            timeout=10,
        )
        if response.status_code == 200:
            data = response.json()
            return f"Company: {data['name']}, SIREN: {data['siren']}, Revenue: {data['revenue']}"
        return f"No results for '{name}'"

@function_tool
async def verify_solvency(siren: str) -> str:
    """Fíoraíonn sé solvency cuideachta de réir a huimhreach SIREN."""
    async with httpx.AsyncClient() as client:
        response = await client.get(
            f"https://api.credit-scoring.com/v1/{siren}",
            timeout=10,
        )
        data = response.json()
        return f"Solvency score: {data['score']}/100, risk: {data['risk_level']}"

Nuair a fhorghníomhaíonn an Runner uirlis async, ní bhacann sé an lúb imeachta. I bhfreastalaí FastAPI, ciallaíonn sé seo go leanann iarratais eile ar aghaidh ag próiseáil agus do ghníomhaire ag fanacht le freagra ó API Societe.com.

Comhthreomhaireacht Uathoibríoch

Is féidir le dhá uirlis asincronacha neamhspleácha rith ag an am céanna. Is é an tsamhail a chinneann é seo, agus is féidir le do chuid treoracha é a spreagadh go sainráite.

from agents import Agent, Runner

agent = Agent(
    name="B2B Analyst",
    instructions="""Déanann tú anailís ar chuideachtaí le haghaidh cinntí gnó.
    Nuair a iarrtar ort cuideachta a anailísiú, faigh a cuid faisnéise
    AGUS fíoraigh a solvency ag an am céanna.""",
    tools=[search_company, verify_solvency],
    model="gpt-5.6-terra",
)

# Seolfaidh an tsamhail an dá uirlis i gcomhthreomhara
result = await Runner.run(
    agent,
    "Analyze the company Acme Corp (SIREN 123456789)"
)

Ós rud é go soláthraítear an SIREN sa cheist, ní fhanann an seiceáil solvency ar chuardach na cuideachta: forghníomhaíonn an SDK an dá ghlaoch ag an am céanna. Is ionann an t-am iomlán agus fad na huirlise is moille, ní suim an dá cheann.

Comhthreomhaireacht a Rialú

Ní bhíonn comhthreomhaireacht inmhianaithe i gcónaí. Má scríobhann do chuid uirlisí chuig an taifead céanna nó má tá tábhacht leis an ord le haghaidh comhsheasmhachta sonraí, cuir i bhfeidhm forghníomhú seicheamhach.

from agents import Agent

agent = Agent(
    name="Cautious Agent",
    instructions="Forghníomhaigh uirlisí ceann ar cheann chun comhsheasmhacht sonraí a chinntiú.",
    tools=[search_company, verify_solvency],
    model="gpt-5.6-terra",
    parallel_tool_calls=False,  # Cuirtear forghníomhú seicheamhach i bhfeidhm
)

Cuirtear an paraiméadar parallel_tool_calls=False i bhfeidhm chun iallach a chur ar an tsamhail gan ach uirlis amháin a ghlaoch ag an am. Trádálann tú moill ar son intuarthacht.

Patrún: Torthaí Comhthreomhara a Chomhiomlánú

Baineann an cás praiticiúil is coitianta le sonraí a bhailiú ó fhoinsí iolracha don eintiteas céanna. Anseo, níl aon bhaint ag aimsir chathrach lena clár cultúrtha, ach teastaíonn an dá rud don fhreagra.

import json
from agents import Agent, Runner, function_tool

@function_tool
async def get_weather(city: str) -> str:
    """Faigheann sé an aimsir reatha do chathair."""
    # Simléad - i dtáirgeadh: glaoch ar API aimsire
    weather_data = {
        "Paris": {"temp": 22, "conditions": "sunny"},
        "Lyon": {"temp": 19, "conditions": "cloudy"},
        "Marseille": {"temp": 26, "conditions": "sunny"},
    }
    data = weather_data.get(city, {"temp": 0, "conditions": "unknown"})
    return json.dumps({"city": city, **data}, ensure_ascii=False)

@function_tool
async def get_events(city: str) -> str:
    """Faigheann sé imeachtaí atá le teacht i gcathair."""
    events = {
        "Paris": ["Concert at Stade de France", "Exhibition at the Louvre"],
        "Lyon": ["Festival of Lights", "Gastronomy Fair"],
        "Marseille": ["Mediterranean Regatta"],
    }
    return json.dumps({
        "city": city,
        "events": events.get(city, [])
    }, ensure_ascii=False)

agent = Agent(
    name="Travel Agent",
    instructions="""Is gníomhaire taistil tú. Nuair a iarrtar
    ort moltaí a thabhairt do chathair, faigh an aimsir AGUS imeachtaí
    ag an am céanna chun comhairle iomlán a sholáthar.""",
    tools=[get_weather, get_events],
    model="gpt-5.6-terra",
)

# Glaoifidh an tsamhail ar an dá uirlis i gcomhthreomhara do gach cathair
result = await Runner.run(
    agent,
    "I want to visit Paris this weekend. What do you recommend?"
)
print(result.final_output)

Tugann an dá uirlis JSON ar ais, rud a fhágann go bhfuil sé níos fusa don tsamhail na sonraí a athchumasc. Tabhair faoi deara an chaoi a bhfuil na treoracha curtha in iúl: spreagann an frása “AGUS … ag an am céanna” an glaoch comhthreomhar seachas slabhra leisciúil.

Teorainneacha Ama agus Athléimneacht

Bacann API nach bhfreagraíonn riamh do ghníomhaire díreach chomh cinnte le huirlis shioncronach. Cuir teorainn ama le gach glaoch mall agus tiontaigh teipeanna ina dteachtaireachtaí intuigthe.

import asyncio
from agents import function_tool

@function_tool
async def slow_api_call(query: str) -> str:
    """Glaoíonn sé ar API a d'fhéadfadh a bheith mall."""
    try:
        async with asyncio.timeout(5):  # Teorainn ama 5 soicind
            # Do ghlaoch API anseo
            await asyncio.sleep(0.1)  # Simléad
            return f"Result for '{query}'"
    except asyncio.TimeoutError:
        return "The API did not respond in time. Please try again."

Feidhmíocht: Tionchar na Comhthreomhaireachta

Cuirimis an scála i gcomhthéacs. Costas 1500 ms ar thrí uirlis 500 ms a fhorghníomhaítear go seicheamhach; costas thart ar 500 ms ar na trí uirlis chéanna i gcomhthreomhara—fad na cinn is moille. Do ghníomhaire a úsáideann go leor uirlisí, tá an difríocht le sonrú láithreach sa chleachtas.

Príomhphointí

  • Úsáid async d’uirlisí a dhéanann glaochtaí líonra nó I/A
  • Forghníomhaíonn an SDK uirlisí neamhspleácha i gcomhthreomhara go huathoibríoch
  • Cuireann parallel_tool_calls=False forghníomhú seicheamhach i bhfeidhm nuair is gá
  • Cuir teorainneacha ama leis asyncio.timeout() le haghaidh athléimneachta
  • Is féidir le comhthreomhaireacht an mhoill a roinnt ar líon na n-uirlisí