max_turns u l-Għodod tas-Server/Klijent
F'din il-paġna
L-Għodod tas-Server u l-Għodod tal-Klijent
Il-pjattaforma xAI tiddistingwi żewġ tipi ta’ għodod li Grok jista’ juża f’konversazzjoni:
- Għodod fuq in-naħa tas-server: tfittxija fuq il-web, eżekuzzjoni tal-kodiċi, tfittxija fuq X. Dawn l-għodod jiġu eżegwiti awtomatikament fuq is-servers ta’ xAI. Grok jistiedinhom, jikseb ir-riżultat, u jkompli mingħajr l-ebda intervent min-naħa tiegħek.
- Għodod fuq in-naħa tal-klijent: il-funzjonijiet personalizzati tiegħek (sejħa tal-funzjoni). Meta Grok irid isejjaħ waħda mill-funzjonijiet tiegħek, l-API tirritorna sejħa tal-funzjoni lilek. Il-kodiċi tiegħek jeżegwixxiha, imbagħad jibgħat ir-riżultat lura lill-API.
Din id-distinzjoni hija ċavetta biex tifhem l-imġiba ta’ max_turns.
Il-Parametru max_turns
max_turns jikkontrolla n-numru ta’ dawriet (turns) tal-assistent/għodda li Grok jista’ jwettaq f’talba waħda tal-API. Kull użu ta’ għodda tas-server jikkonsma dawra waħda.
response = await client.chat.completions.create(
model="grok-4.5",
messages=[{"role": "user", "content": "Search for the latest news on Python 3.13"}],
tools=[...],
max_turns=5 # Grok can use up to 5 server tools
)
Jekk Grok ikollu bżonn iwettaq tfittxija fuq il-web, imbagħad jeżegwixxi kodiċi biex janalizza r-riżultati, u mbagħad iwettaq it-tieni tfittxija biex jikkonkludi, dan jikkonsma 3 dawriet. B’max_turns=5, jibqgħulu 2 dawriet.
Ir-Reset permezz tal-Għodod tal-Klijent
Imġiba ewlenija li għandek tiftakar: is-sejħiet tal-għodod fuq in-naħa tal-klijent jirrisettjaw il-kontatur max_turns. Meta l-kodiċi tiegħek jimmaniġġja sejħa ta’ funzjoni u jirritorna r-riżultat f’talba ġdida tal-API, Grok jerġa’ jikseb l-allokazzjoni sħiħa tad-dawriet tiegħu.
# First request: max_turns=3
response = await client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=my_tools,
max_turns=3
)
# Grok requests a client function call
if response.choices[0].message.tool_calls:
# You execute the function locally
tool_result = execute_tool(response.choices[0].message.tool_calls[0])
# Second request: max_turns resets to 3
messages.append(response.choices[0].message)
messages.append({"role": "tool", "content": tool_result, ...})
response = await client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=my_tools,
max_turns=3 # new counter
)
Dan ir-reset jagħmel sens: kull talba tal-API hija indipendenti. Il-kontatur max_turns japplika biss għad-dawriet imwettqa fl-istess talba.
Flussi ta’ Ħidma Ibridi
Il-kombinazzjoni ta’ għodod tas-server u tal-klijent tippermetti flussi ta’ ħidma kumplessi. Pereżempju, Grok jista’:
- Iwettaq tfittxija fuq il-web (għodda tas-server, dawra 1)
- Jeżegwixxi kodiċi biex janalizza r-riżultati (għodda tas-server, dawra 1)
- Jitolbok il-funzjoni personalizzata tiegħek biex issalva r-riżultati (għodda tal-klijent, reset)
- Iwettaq tfittxija ġdida bbażata fuq ir-riżultati salvati (għodda tas-server, dawra 1 b’kontatur ġdid)
async def hybrid_workflow(question: str) -> str:
messages = [{"role": "user", "content": question}]
while True:
response = await client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=server_and_client_tools,
max_turns=5
)
message = response.choices[0].message
# If no client tool call, we have the final answer
if not message.tool_calls:
return message.content
# Process client tool calls
messages.append(message)
for tool_call in message.tool_calls:
result = await execute_local_tool(tool_call)
messages.append({
"role": "tool",
"tool_call_id": tool_call.id,
"content": result
})
Dan il-mudell ta’ ċiklu (loop) jimmaniġġja awtomatikament il-mixi u l-miġja bejn Grok u l-funzjonijiet lokali tiegħek. Iċ-ċiklu jkompli sakemm Grok ikollu bżonn isejjaħ l-għodod tiegħek. Tieqaf meta jipprovdi tweġiba finali f’forma ta’ test.
Kif Tistabbilixxi max_turns
- max_turns=1: Grok jista’ juża għodda waħda biss tas-server. Biżżejjed għal tfittxija sempliċi fuq il-web.
- max_turns=3-5: bilanċ tajjeb għall-biċċa l-kbira tal-każijiet. Grok jista’ jgħaqqad tfittxija + analiżi + verifika.
- max_turns=10+: għal kompiti kumplessi li jeħtieġu ħafna iterazzjonijiet. Oqgħod attent għall-ispejjeż tat-tokens.
Valur ta’ max_turns għoli wisq ma jiswa xejn jekk ma jintużax, iżda valur ta’ max_turns baxx wisq jista’ jaqta’ qasir ir-raġunament ta’ Grok f’nofs il-kompitu.
Punti Ewlenin
- L-għodod tas-server (tfittxija fuq il-web, eżekuzzjoni tal-kodiċi) jikkonsmaw dawriet
max_turns - L-għodod tal-klijent (il-funzjonijiet tiegħek) jirrisettjaw il-kontatur ma’ kull talba ġdida
- Il-mudell ta’ ċiklu
while Truejimmaniġġja l-mixi u l-miġja sakemm tintlaħaq it-tweġiba finali - Ibda b’
max_turns=5u aġġusta skont il-kumplessità tal-kompitu tiegħek - Kull dawra tas-server tikkonsma tokens addizzjonali (kuntest kumulattiv)