Kombinera server- och klientverktyg
På denna sida
Hybrida arbetsflöden
Den verkliga styrkan med Responses API kommer fram när du kombinerar serververktyg (som körs automatiskt av xAI) och klientverktyg (dina egna funktioner) i en enda begäran. Modellen orkestrerar dessa verktyg autonomt och skapar komplexa arbetsflöden på bara några rader kod.
Kombinera serververktyg och funktioner
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"]
}
}
]
)
I detta scenario gör modellen följande:
- Utlöser
web_searchautomatiskt (serversida) för att hitta resultaten - Integrerar datan i en sammanfattning
- Anropar
send_team_message(klientsida) så att din kod skickar Slack-meddelandet
Det hybrida exekveringsflödet
Flödet skiljer sig beroende på vilken typ av verktyg som används:
Endast serververktyg
Request → [model → web_search → result → model] → Final response
Allt sker på xAI:s sida. Du får det slutgiltiga svaret direkt med resultaten integrerade.
Endast klientverktyg
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Modellen pausar, din kod exekveras och sedan skickar du tillbaka resultatet.
Hybrida flödet
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Modellen använder först serververktyg (automatiskt) och anropar sedan din funktion när den behöver din infrastruktur.
Vanliga kombinationsmönster
Sökning + åtgärd
Kombinera web_search eller x_search med en åtgärdsfunktion:
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"]
}
}
]
Beräkning + avisering
Kombinera code_interpreter med en aviseringsfunktion:
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 och hybrida verktyg
Beteendet hos max_turns är viktigt i en hybridkontext:
max_turnsbegränsar antalet serversida-varv inom en enda begäran- När modellen anropar en klientfunktion och din kod returnerar resultatet, börjar en ny tilldelning av
max_turns
I praktiken innebär detta att klientanrop inte förbrukar din budget för servervarv. Modellen kan utföra tre webbsökningar, anropa din funktion och sedan utföra tre ytterligare sökningar efter att ha fått resultatet.
Flerstegskontext med lagring
För komplexa arbetsflöden som sträcker sig över flera interaktioner kombinerar du lagring och kedjebildning:
# 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
)
Viktiga punkter
- Kombinera serververktyg och klientfunktioner i en enda begäran för hybrida arbetsflöden
- Serververktyg exekveras automatiskt; klientfunktioner pausar genereringen
max_turnsåterställs efter varje klienttur-och-retur- Vanliga mönster: sökning + åtgärd, beräkning + avisering, aggregering från flera källor
- Använd
store: trueochprevious_response_idför arbetsflöden över flera steg