Server- en clienttools combineren
Op deze pagina
Hybride workflows
De ware kracht van de Responses API komt naar voren wanneer u servertools (automatisch uitgevoerd door xAI) en clienttools (uw eigen functies) combineert in één verzoek. Het model orkestreert deze tools autonoom, waardoor complexe workflows met slechts een paar regels code mogelijk zijn.
Servertools en functies combineren
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Search for the latest Ligue 1 soccer results and send a summary to my team.",
tools=[
{"type": "web_search"},
{
"type": "function",
"name": "send_team_message",
"description": "Sends a message to the team via Slack",
"parameters": {
"type": "object",
"properties": {
"channel": {"type": "string"},
"message": {"type": "string"}
},
"required": ["channel", "message"]
}
}
]
)
In dit scenario:
- Activeert het model automatisch
web_search(serverzijde) om de resultaten te vinden. - Verwerkt het de gegevens in een samenvatting.
- Roept het
send_team_messageaan (clientzijde), zodat uw code het Slack-bericht verzendt.
De hybride uitvoeringsstroom
De stroom verschilt afhankelijk van het type tool:
Alleen servertools
Request → [model → web_search → result → model] → Final response
Alles gebeurt aan de kant van xAI. U ontvangt direct het eindantwoord met de geïntegreerde resultaten.
Alleen clienttools
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Het model pauzeert, uw code wordt uitgevoerd en vervolgens stuurt u het resultaat terug.
Hybride stroom
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Het model gebruikt eerst servertools (automatisch) en roept vervolgens uw functie aan wanneer het uw infrastructuur nodig heeft.
Veelvoorkomende combinatiepatronen
Zoeken + Actie
Combineer web_search of x_search met een actiefunctie:
tools = [
{"type": "web_search"},
{"type": "x_search"},
{
"type": "function",
"name": "create_report",
"description": "Creates a report in the CRM",
"parameters": {
"type": "object",
"properties": {
"title": {"type": "string"},
"content": {"type": "string"},
"tags": {"type": "array", "items": {"type": "string"}}
},
"required": ["title", "content"]
}
}
]
Berekening + Melding
Combineer code_interpreter met een meldingsfunctie:
tools = [
{"type": "code_interpreter"},
{
"type": "function",
"name": "send_alert",
"description": "Sends an alert if a threshold is exceeded",
"parameters": {
"type": "object",
"properties": {
"metric": {"type": "string"},
"value": {"type": "number"},
"threshold": {"type": "number"}
},
"required": ["metric", "value"]
}
}
]
max_turns en hybride tools
Het gedrag van max_turns is belangrijk in een hybride context:
max_turnsbeperkt het aantal serverzijde-beurten binnen één verzoek.- Wanneer het model een clientfunctie aanroept en uw code het resultaat retourneert, start een nieuwe toewijzing van
max_turns.
In de praktijk betekent dit dat clientaanroepen uw budget voor serverbeurten niet uitputten. Het model kan 3 webzoekopdrachten uitvoeren, uw functie aanroepen en na ontvangst van het resultaat nog eens 3 zoekopdrachten uitvoeren.
Context met meerdere beurten en opslag
Voor complexe workflows die zich over meerdere interacties uitstrekken, combineert u opslag en ketening:
# Turn 1: initial search
r1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze AI market trends.",
tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
store=True,
max_turns=5
)
# Turn 2: deepen with your internal data
r2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Compare with our internal data.",
tools=[{
"type": "function",
"name": "query_internal_db",
"description": "Queries the internal database",
"parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
}],
previous_response_id=r1.id,
store=True
)
Belangrijkste punten
- Combineer servertools en clientfuncties in één verzoek voor hybride workflows.
- Servertools worden automatisch uitgevoerd; clientfuncties pauzeren de generatie.
max_turnswordt gereset na elke client round-trip.- Veelvoorkomende patronen: zoeken + actie, berekening + melding, aggregatie van meerdere bronnen.
- Gebruik
store: trueenprevious_response_idvoor workflows met meerdere beurten.