Glaochanna Comhthreomhara
Ar an leathanach seo
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_callsin aon fhreagra amháin - Caithfidh tú gach toradh a thabhairt ar ais, gach ceann nasctha lena
tool_call_idfé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