Patronen voor toolcombinaties
Op deze pagina
Tools combineren voor complexe taken
De tools van Grok worden pas echt krachtig wanneer u ze combineert. Zoeken op het web levert alleen ruwe data op. Voeg code-uitvoering toe en u kunt die data analyseren. Voeg uw eigen functies toe en u kunt actie ondernemen op basis van de resultaten. Deze les behandelt de nuttigste combinatiepatronen.
Patroon 1: Zoeken + Analyse
De meest voorkomende use case combineert webzoekopdrachten met code-uitvoering om data te verzamelen en conclusies te trekken:
response = await client.chat.completions.create(
model="grok-4.5",
messages=[{
"role": "user",
"content": "Look up the stock prices for Tesla, Apple, and Microsoft over the last 30 days. "
"Calculate relative performance and identify the trend."
}],
tools=[
{"type": "web_search"},
{"type": "code_interpreter"}
],
max_turns=5
)
Grok begint met een webzoekopdracht om financiële data op te halen en gebruikt vervolgens code-uitvoering om de prestaties te berekenen en een grafiek te plotten. Dankzij een voldoende hoge max_turns verloopt dit alles binnen één enkele request.
Patroon 2: Nieuws uit meerdere bronnen
Door Web Search en X Search te combineren, krijgt u een uitgebreid beeld van een onderwerp:
response = await client.chat.completions.create(
model="grok-4.5",
messages=[{
"role": "user",
"content": "What are the reactions to the announcement of the new AI regulation in Europe? "
"Compare official sources and reactions on X."
}],
tools=[
{"type": "web_search"},
{"type": "x_search"}
],
max_turns=5
)
Web search vangt persartikelen en officiële verklaringen op, terwijl X search realtime reacties en meningen verzamelt.
Patroon 3: Extractie uit meerdere bronnen met functies
Voor complexere workflows combineert u servertools met uw eigen aangepaste functies:
tools = [
{"type": "web_search"},
{"type": "code_interpreter"},
{
"type": "function",
"function": {
"name": "save_to_database",
"description": "Saves structured results to the database",
"parameters": {
"type": "object",
"properties": {
"category": {"type": "string"},
"data": {"type": "object"},
"source_urls": {"type": "array", "items": {"type": "string"}}
},
"required": ["category", "data"]
}
}
}
]
async def research_and_save(topic: str) -> str:
messages = [{"role": "user", "content": f"Research and analyze: {topic}. "
"Save the structured results."}]
while True:
response = await client.chat.completions.create(
model="grok-4.5",
messages=messages,
tools=tools,
max_turns=5
)
message = response.choices[0].message
if not message.tool_calls:
return message.content
messages.append(message)
for tc in message.tool_calls:
if tc.function.name == "save_to_database":
result = await save_to_db(json.loads(tc.function.arguments))
messages.append({
"role": "tool",
"tool_call_id": tc.id,
"content": json.dumps(result)
})
In dit patroon zoekt Grok naar informatie, analyseert deze met code en roept vervolgens uw functie aan om de resultaten op te slaan. De workflow verloopt volledig autonoom.
Patroon 4: Kruisvalidatie
Gebruik meerdere bronnen om de betrouwbaarheid van informatie te verifiëren:
response = await client.chat.completions.create(
model="grok-4.5",
messages=[{
"role": "user",
"content": "Verify this claim by cross-referencing sources: "
"'France produced 70% of its electricity from nuclear power in 2024.' "
"Compare data from multiple official sources."
}],
tools=[
{"type": "web_search"},
{"type": "code_interpreter"}
],
max_turns=8
)
Met een hogere max_turns kan Grok meerdere opeenvolgende zoekopdrachten uitvoeren om informatie te kruisverwijzen en code-uitvoering gebruiken om cijfers te vergelijken.
Best practices
Specificeer tools in de prompt
Declareer tools niet alleen in de tools-parameter. Vermeld expliciet in uw prompt wat u verwacht:
# GOED: de prompt stuurt het toolgebruik
"""Search for the data, then use code to generate a comparison table.
Save the final result via save_to_database."""
# SLECHT: de prompt noemt geen tools
"Give me information on this topic."
Beperk tools tot wat nodig is
Schakel niet elke tool in als u er maar één nodig heeft. Elke tool voegt context toe aan de systeemprompt, wat tokens verbruikt en het model mogelijk afleidt.
Belangrijkste punten
- Zoeken + Code-uitvoering stelt u in staat data te verzamelen en te analyseren in één enkele request
- Web Search + X Search biedt uitgebreide dekking (artikelen + reacties)
- Aangepaste functies breiden de mogelijkheden uit verder dan wat servertools bieden
- Stuur Grok expliciet via uw prompt over welke tools gebruikt moeten worden
- Pas
max_turnsaan op de complexiteit van de workflow (5-8 voor combinaties van meerdere tools) - Schakel alleen noodzakelijke tools in om tokenverbruik te optimaliseren