Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

max_turns ja palvelin-/asiakastyökalut

Oppitunti 8 / 12 Päivitetty 30. heinäkuuta 2026 Edistynyt
Tällä sivulla
  1. Palvelintyökalut ja asiakastyökalut
  2. max_turns-parametri
  3. Nollaus asiakastyökalujen kautta
  4. Hybridityönkulut
  5. max_turns-asetuksen määrittäminen
  6. Keskeiset asiat

Palvelintyökalut ja asiakastyökalut

xAI-alusta erottaa kaksi työkalutyyppiä, joita Grok voi käyttää keskustelun aikana:

  • Palvelinpuolen työkalut: verkkohaku, koodin suoritus, X-haku. Nämä työkalut suoritetaan automaattisesti xAI:n palvelimilla. Grok kutsuu niitä, saa tuloksen ja jatkaa ilman sinun väliintuloasi.
  • Asiakaspuolen työkalut: omat funktiosi (funktiokutsut). Kun Grok haluaa kutsua yhtä funktioistasi, API palauttaa sinulle funktiokutsun. Koodisi suorittaa sen ja lähettää tuloksen takaisin API:lle.

Tämä ero on avainasemassa ymmärtäessäsi max_turns-parametrin toimintaa.

max_turns-parametri

max_turns ohjaa niiden avustaja-/työkaluvuorojen määrää, jotka Grok voi suorittaa yhden API-pyynnön aikana. Jokainen palvelintyökalun käyttö kuluttaa yhden vuoron.

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
)

Jos Grokin tarvitsee tehdä verkkohaku, suorittaa koodia tulosten analysoimiseksi ja tehdä sen jälkeen toinen haku viimeistelyä varten, se kuluttaa 3 vuoroa. Asetuksella max_turns=5 sille jää 2 vuoroa jäljelle.

Nollaus asiakastyökalujen kautta

Muista tämä keskeinen toimintatapa: asiakaspuolen työkalukutsut nollaavat max_turns-laskurin. Kun koodisi käsittelee funktiokutsun ja palauttaa tuloksen uudessa API-pyynnössä, Grok saa koko vuorokiintiönsä takaisin.

# 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
    )

Tämä nollaus on loogista: jokainen API-pyyntö on itsenäinen. max_turns-laskuri koskee vain saman pyynnön sisällä suoritettuja vuoroja.

Hybridityönkulut

Palvelin- ja asiakastyökalujen yhdistäminen mahdollistaa monimutkaiset työnkulut. Esimerkiksi Grok voi:

  1. Tehdä verkkohaun (palvelintyökalu, 1 vuoro)
  2. Suorittaa koodia tulosten analysoimiseksi (palvelintyökalu, 1 vuoro)
  3. Pyytää omaa funktiotasi tallentamaan tulokset (asiakastyökalu, nollaus)
  4. Tehdä uuden haun tallennettujen tulosten perusteella (palvelintyökalu, 1 vuoro uudella laskurilla)
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
            })

Tämä silmukkarakenne hoitaa automaattisesti vuorovaikutuksen Grokin ja paikallisten funktioidesi välillä. Silmukka jatkuu niin kauan kuin Grokin tarvitsee kutsua työkalujasi. Se pysähtyy, kun Grok tarjoaa lopullisen tekstivastauksen.

max_turns-asetuksen määrittäminen

  • max_turns=1: Grok voi käyttää vain yhtä palvelintyökalua. Riittää yksinkertaiseen verkkohakuun.
  • max_turns=3–5: hyvä tasapaino useimpiin tapauksiin. Grok voi ketjuttaa haun, analyysin ja varmistuksen.
  • max_turns=10+: monimutkaisiin tehtäviin, jotka vaativat monta iteraatiota. Varo token-kustannuksia.

Liian korkea max_turns-arvo ei maksa mitään, jos sitä ei käytetä, mutta liian matala arvo voi katkaista Grokin päättelyn kesken tehtävän.

Keskeiset asiat

  • Palvelintyökalut (verkkohaku, koodin suoritus) kuluttavat max_turns-vuoroja
  • Asiakastyökalut (omat funktiosi) nollaavat laskurin jokaisella uudella pyynnöllä
  • while True -silmukkarakenne hoitaa edestakaisen vuorovaikutuksen loppuvastaukseen saakka
  • Aloita arvolla max_turns=5 ja säädä sitä tehtävän vaativuuden mukaan
  • Jokainen palvelinvuoro kuluttaa lisää tokeneita (kumulatiivinen konteksti)