max_turns og server-/klientværktøjer
På denne side
Serverværktøjer og klientværktøjer
xAI-platformen skelner mellem to typer værktøjer, som Grok kan bruge i en samtale:
- Server-side værktøjer: websøgning, kodeeksekvering, X-søgning. Disse værktøjer kører automatisk på xAI’s servere. Grok kalder dem, modtager resultatet og fortsætter uden nogen indgriben fra din side.
- Client-side værktøjer: dine egne funktioner (function calling). Når Grok ønsker at kalde en af dine funktioner, returnerer API’et et funktionskald til dig. Din kode eksekverer det og sender derefter resultatet tilbage til API’et.
Denne sondring er afgørende for at forstå adfærden for max_turns.
Parameteren max_turns
max_turns styrer antallet af assistant/værktøj-runder, som Grok kan udføre i en enkelt API-anmodning. Hver brug af et serverværktøj bruger én runde.
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
)
Hvis Grok skal køre en websøgning, derefter eksekvere kode for at analysere resultaterne og til sidst køre en anden søgning for at afrunde, bruger det 3 runder. Med max_turns=5 har det 2 runder tilbage.
Nulstilling via klientværktøjer
Vigtig adfærd at huske: kald til client-side værktøjer nulstiller tælleren for max_turns. Når din kode håndterer et funktionskald og returnerer resultatet i en ny API-anmodning, får Grok sin fulde tildeling af runder tilbage.
# 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
)
Denne nulstilling giver mening: hver API-anmodning er uafhængig. Tælleren max_turns gælder kun for runder, der udføres inden for samme anmodning.
Hybride arbejdsgange
Kombinationen af server- og klientværktøjer muliggør komplekse arbejdsgange. Grok kan f.eks.:
- Køre en websøgning (serverværktøj, 1 runde)
- Eksekvere kode for at analysere resultaterne (serverværktøj, 1 runde)
- Bede din brugerdefinerede funktion om at gemme resultaterne (klientværktøj, nulstilling)
- Køre en ny søgning baseret på de gemte resultater (serverværktøj, 1 runde med ny tæller)
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
})
Dette løkke-mønster håndterer automatisk tur-tagningen mellem Grok og dine lokale funktioner. Løkken fortsætter, så længe Grok har brug for at kalde dine værktøjer. Den stopper, når den leverer et endeligt tekstsvar.
Indstilling af max_turns
- max_turns=1: Grok kan kun bruge ét serverværktøj. Tilstrækkeligt til en simpel websøgning.
- max_turns=3-5: god balance til de fleste tilfælde. Grok kan kæde søgning + analyse + verifikation sammen.
- max_turns=10+: til komplekse opgaver, der kræver mange iterationer. Pas på token-omkostningerne.
En værdi for max_turns, der er for høj, koster ingenting, hvis den ikke bruges, men en værdi, der er for lav, kan afbryde Groks ræsonnement midt i opgaven.
Vigtige pointer
- Serverværktøjer (websøgning, kodeeksekvering) bruger runder fra
max_turns - Klientværktøjer (dine funktioner) nulstiller tælleren ved hver ny anmodning
- Løkke-mønsteret
while Truehåndterer tur-tagningen indtil det endelige svar - Start med
max_turns=5og juster baseret på din opgaves kompleksitet - Hver server-runde bruger yderligere tokens (akkumuleret kontekst)