Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

max_turns u l-Għodod tas-Server/Klijent

Lezzjoni 8 / 12 Aġġornat 30 ta’ Lulju 2026 Avvanzat
F'din il-paġna
  1. L-Għodod tas-Server u l-Għodod tal-Klijent
  2. Il-Parametru max_turns
  3. Ir-Reset permezz tal-Għodod tal-Klijent
  4. Flussi ta’ Ħidma Ibridi
  5. Kif Tistabbilixxi max_turns
  6. Punti Ewlenin

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’:

  1. Iwettaq tfittxija fuq il-web (għodda tas-server, dawra 1)
  2. Jeżegwixxi kodiċi biex janalizza r-riżultati (għodda tas-server, dawra 1)
  3. Jitolbok il-funzjoni personalizzata tiegħek biex issalva r-riżultati (għodda tal-klijent, reset)
  4. 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 True jimmaniġġja l-mixi u l-miġja sakemm tintlaħaq it-tweġiba finali
  • Ibda b’max_turns=5 u aġġusta skont il-kumplessità tal-kompitu tiegħek
  • Kull dawra tas-server tikkonsma tokens addizzjonali (kuntest kumulattiv)