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

Glaochanna Comhthreomhara

Ceacht 6 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Iluirlisí in Aon Freagra Amháin
  2. An Paraiméadar parallel_tool_calls
  3. Glaochanna Comhthreomhara a Láimhseáil
  4. Feidhmiú Fíor-Chomhthreomhar ar an gCliant
  5. Glaochanna Comhthreomhara a Dhíchumasú
  6. Glaochanna Comhthreomhara le Huirlisí Éagsúla
  7. Láimhseáil Earráidí go Comhthreomhar
  8. Príomhphointí

Iluirlisí in Aon Freagra Amháin

Is é ceann de na gnéithe is cumhachtaí i nglaoch feidhme Grok ná an cumas ilghlaoch uirlise a thabhairt ar ais in aon fhreagra amháin. In ionad turas fillte a dhéanamh do gach feidhm, aithníonn an tsamhail gach eolas atá uirthi agus gineann sí gach glao go comhthreomhar.

An Paraiméadar parallel_tool_calls

Tá glaochanna comhthreomhara cumasaithe de réir réamhshocraithe. Rialaíonn an paraiméadar parallel_tool_calls an iompar seo:

# Cumasaithe de réir réamhshocraithe (ní gá é a shonrú)
response = client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=tools,
    parallel_tool_calls=True  # Seo an réamhshocrú
)

Nuair a iarrann úsáideoir, “Cén aimsir atá i bPáras agus i Lyon?”, filleann an tsamhail dhá tool_calls san fhreagra céanna:

{
  "tool_calls": [
    {
      "id": "call_001",
      "function": {
        "name": "get_weather",
        "arguments": "{\"city\": \"Paris\"}"
      }
    },
    {
      "id": "call_002",
      "function": {
        "name": "get_weather",
        "arguments": "{\"city\": \"Lyon\"}"
      }
    }
  ]
}

Glaochanna Comhthreomhara a Láimhseáil

Caithfidh do chód tacú le sraith de tool_calls, ní hamháin ceann amháin:

import json
import asyncio

message = response.choices[0].message

if message.tool_calls:
    # Feidhmigh gach feidhm
    tool_results = []
    for tool_call in message.tool_calls:
        args = json.loads(tool_call.function.arguments)
        result = execute_function(tool_call.function.name, args)
        tool_results.append({
            "role": "tool",
            "tool_call_id": tool_call.id,
            "content": json.dumps(result)
        })

    # Seol GACH toradh ar ais chuig an tsamhail
    messages = [
        {"role": "user", "content": "Cén aimsir atá i bPáras agus i Lyon?"},
        message,
        *tool_results  # Gach toradh
    ]

    final = client.chat.completions.create(
        model="grok-4.5",
        messages=messages,
        tools=tools
    )

Pointe ríthábhachtach: caithfidh tú gach toradh uirlise a thabhairt ar ais, ní hamháin an chéad cheann. Tá gach toradh nasctha lena tool_call_id féin.

Feidhmiú Fíor-Chomhthreomhar ar an gCliant

Filleann an tsamhail glaochanna go comhthreomhar, ach caithfidh do chód iad a fheidhmiú go comhthreomhar. I bPython, úsáid asyncio nó concurrent.futures:

import concurrent.futures

def execute_parallel(tool_calls):
    results = []
    with concurrent.futures.ThreadPoolExecutor() as executor:
        futures = {}
        for tc in tool_calls:
            args = json.loads(tc.function.arguments)
            future = executor.submit(execute_function, tc.function.name, args)
            futures[future] = tc.id

        for future in concurrent.futures.as_completed(futures):
            call_id = futures[future]
            result = future.result()
            results.append({
                "role": "tool",
                "tool_call_id": call_id,
                "content": json.dumps(result)
            })
    return results

Laghdaíonn feidhmiú comhthreomhar an mhoill iomlán go suntasach. Má thógann gach glao API 200ms, beidh dhá ghlao seicheamhach = 400ms, ach beidh dhá ghlao comhthreomhar = ~200ms.

Glaochanna Comhthreomhara a Dhíchumasú

I roinnt cásanna, teastóidh glaochanna seicheamhacha uait:

response = client.chat.completions.create(
    model="grok-4.5",
    messages=messages,
    tools=tools,
    parallel_tool_calls=False
)

Díchumasaigh an comhthreomhaireacht nuair nach bhfuil neamhspleáchas idir glaochanna ráthaithe. Is é an cás is soiléire ná spleáchas sonraí: má bhraitheann argóintí na chéad uirlise eile ar thoradh uirlise roimhe—mar shampla, ID custaiméara a aimsiú sula bhfaightear a chuid orduithe—cruthóidh rith comhthreomhar earráid ar a laghad, nó toradh mícheart gan fhógra ar a mhéad. Cuirtear an srian céanna i bhfeidhm ag ord loighce gnó: tá sé dodhéanta úsáideoir a chruthú sula dtugtar ról dó, agus ní ráthaíonn ach an mód seicheamhach é seo. Cuireann dhá chúis phraiticiúla eile críoch leis an scéal: ní láimhseálfaidh API seachtrach atá faoi theorainneacha iarratais chomhthreomhara pléasc glaochanna comhthreomhara go maith, agus le linn forbartha, déanann an mód seicheamhach rianú na nglaochanna i bhfad níos inléite—glao amháin, toradh amháin, loga amháin, in ord.

Glaochanna Comhthreomhara le Huirlisí Éagsúla

Is féidir leis an tsamhail uirlisí éagsúla a ghlaow go comhthreomhar freisin:

# Iarratas: "Cuir bord in áirithe agus inis dom cén aimsir a bheidh ann anocht"
# Filleann an tsamhail:
# - tool_call_1 : book_table(restaurant="Le Petit Bistrot", time="20:00")
# - tool_call_2 : get_weather(city="Paris", time="tonight")

Tá sé seo thar a bheith úsáideach do chúntóirí ilghnéitheacha a chaithfidh faisnéis a bhailiú ó fhoinsí éagsúla.

Láimhseáil Earráidí go Comhthreomhar

Nuair a theipeann ar ghlao amháin ach n-éiríonn le cinn eile, tabhair gach toradh ar ais fós. Déileálann an tsamhail le hearráidí aonair:

results = []
for tc in message.tool_calls:
    try:
        result = execute_function(tc.function.name, args)
        results.append({
            "role": "tool",
            "tool_call_id": tc.id,
            "content": json.dumps(result)
        })
    except Exception as e:
        results.append({
            "role": "tool",
            "tool_call_id": tc.id,
            "content": json.dumps({"error": str(e)})
        })

Príomhphointí

  • Tá glaochanna comhthreomhara cumasaithe de réir réamhshocraithe (parallel_tool_calls: true)
  • Filleann an tsamhail il tool_calls in aon fhreagra amháin
  • Caithfidh tú gach toradh a thabhairt ar ais, gach ceann nasctha lena tool_call_id féin
  • Cuir feidhmiú comhthreomhar taobh clianta i bhfeidhm chun moill a laghdú
  • Díchumasaigh an comhthreomhaireacht nuair a bhíonn spleáchais idir glaochanna
  • Láimhseáil earráidí go hindibhidualach—ná bac gach rud mar gheall ar theip amháin