Kombinování serverových a klientských nástrojů
Na této stránce
Hybridní pracovní postupy
Skutečná síla Responses API se projeví, když v jediném požadavku zkombinuješ serverové nástroje (spouštěné automaticky systémem xAI) a klientské nástroje (tvé vlastní funkce). Model tyto nástroje autonomně orchestruje a vytváří složité pracovní postupy pomocí jen několika řádků kódu.
Kombinování serverových nástrojů a funkcí
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"]
}
}
]
)
V tomto scénáři model:
- Automaticky spustí
web_search(na straně serveru) pro vyhledání výsledků - Zahrne data do shrnutí
- Zavolá
send_team_message(na straně klienta), aby tvůj kód odeslal zprávu na Slack
Hybridní průběh provádění
Průběh se liší v závislosti na typu nástroje:
Pouze serverové nástroje
Request → [model → web_search → result → model] → Final response
Vše se děje na straně xAI. Přímo obdržíš konečnou odpověď s integrovanými výsledky.
Pouze klientské nástroje
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Model se pozastaví, tvůj kód se provede a poté odešleš výsledek zpět.
Hybridní průběh
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Model nejprve využije serverové nástroje (automaticky) a následně zavolá tvou funkci, když potřebuje tvou infrastrukturu.
Běžné kombinační vzory
Vyhledávání + Akce
Zkombinuj web_search nebo x_search s akční funkcí:
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"]
}
}
]
Výpočet + Oznámení
Zkombinuj code_interpreter s oznamovací funkcí:
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 a hybridní nástroje
Chování max_turns je v hybridním kontextu klíčové:
max_turnsomezuje počet serverových kol v rámci jediného požadavku- Když model zavolá klientskou funkci a tvůj kód vrátí výsledek, začne nová alokace
max_turns
V praxi to znamená, že klientská volání nevyčerpávají tvůj rozpočet serverových kol. Model může provést 3 webová vyhledávání, zavolat tvou funkci a po obdržení výsledku provést další 3 vyhledávání.
Kontext více kol s ukládáním
Pro složité pracovní postupy přesahující více interakcí kombinuj ukládání a řetězení:
# 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
)
Klíčové poznatky
- Kombinuj serverové nástroje a klientské funkce v jediném požadavku pro hybridní pracovní postupy
- Serverové nástroje se provádějí automaticky; klientské funkce pozastaví generování
max_turnsse resetuje po každé往返 komunikaci s klientem- Běžné vzory: vyhledávání + akce, výpočet + oznámení, agregace z více zdrojů
- Pro pracovní postupy s více koly použij
store: trueaprevious_response_id