Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

max_turns och server-/klientverktyg

Lektion 8 av 12 Uppdaterad 30 juli 2026 Avancerad
På denna sida
  1. Serververktyg och klientverktyg
  2. Parametern max_turns
  3. Återställning via klientverktyg
  4. Hybridarbetsflöden
  5. Inställning av max_turns
  6. Viktiga punkter

Serververktyg och klientverktyg

xAI-plattformen skiljer på två typer av verktyg som Grok kan använda i en konversation:

  • Serversidiga verktyg: webbsökning, kodexekvering, X-sökning. Dessa verktyg körs automatiskt på xAI:s servrar. Grok anropar dem, får resultatet och fortsätter utan att du behöver göra något.
  • Klientsidiga verktyg: dina egna funktioner (function calling). När Grok vill anropa en av dina funktioner returnerar API:t ett funktionsanrop till dig. Din kod exekverar det och skickar sedan tillbaka resultatet till API:t.

Denna åtskillnad är avgörande för att förstå hur max_turns beter sig.

Parametern max_turns

max_turns styr antalet assistent-/verktygsvarv Grok får utföra i en enda API-förfrågan. Varje användning av ett serversidigt verktyg förbrukar ett varv.

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
)

Om Grok behöver göra en webbsökning, sedan exekvera kod för att analysera resultaten och slutligen göra en andra sökning för att avsluta, förbrukar det 3 varv. Med max_turns=5 återstår 2 varv.

Återställning via klientverktyg

Viktigt att komma ihåg: anrop av klientsidiga verktyg återställer räknaren för max_turns. När din kod hanterar ett funktionsanrop och returnerar resultatet i en ny API-förfrågan får Grok tillbaka hela sin tilldelning av varv.

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

Denna återställning är logisk: varje API-förfrågan är oberoende. Räknaren max_turns gäller endast för varv som utförs inom samma förfrågan.

Hybridarbetsflöden

Genom att kombinera server- och klientverktyg kan du skapa komplexa arbetsflöden. Grok kan till exempel:

  1. Göra en webbsökning (serververktyg, 1 varv)
  2. Exekvera kod för att analysera resultaten (serververktyg, 1 varv)
  3. Be din anpassade funktion spara resultaten (klientverktyg, återställning)
  4. Göra en ny sökning baserad på de sparade resultaten (serververktyg, 1 varv med ny räknare)
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
            })

Detta loopmönster hanterar automatiskt turtagningen mellan Grok och dina lokala funktioner. Loopen fortsätter så länge Grok behöver anropa dina verktyg. Den stoppas när Grok levererar ett slutgiltigt textsvar.

Inställning av max_turns

  • max_turns=1: Grok kan bara använda ett serververktyg. Tillräckligt för en enkel webbsökning.
  • max_turns=3–5: bra balans för de flesta fall. Grok kan kedja sökning + analys + verifiering.
  • max_turns=10+: för komplexa uppgifter som kräver många iterationer. Håll koll på tokenkostnaderna.

Ett max_turns-värde som är för högt kostar inget om det inte används, men ett värde som är för lågt kan klippa av Groks resonemang mitt i uppgiften.

Viktiga punkter

  • Serververktyg (webbsökning, kodexekvering) förbrukar max_turns-varv
  • Klientverktyg (dina funktioner) återställer räknaren vid varje ny förfrågan
  • Loopmönstret while True hanterar turtagningen tills det slutgiltiga svaret levereras
  • Börja med max_turns=5 och justera baserat på din uppgifts komplexitet
  • Varje servervarv förbrukar ytterligare tokens (kumulativ kontext)