Kombinovanie serverových a klientských nástrojov
Na tejto strane
Hybridné pracovné postupy
Skutočná sila rozhrania Responses API sa prejaví, keď v jednej požiadavke skombinuješ serverové nástroje (ktoré automaticky vykonáva xAI) a klientské nástroje (tvoje vlastné funkcie). Model tieto nástroje autonómne orchestruje a vytvára zložité pracovné postupy len pomocou niekoľkých riadkov kódu.
Kombinovanie serverových nástrojov a funkcií
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 scenári model:
- Automaticky spustí
web_search(na strane servera), aby našiel výsledky - Zakomponuje údaje do zhrnutia
- Zavolá
send_team_message(na strane klienta), aby tvoj kód odoslal správu na Slack
Hybridný tok vykonávania
Tok sa líši v závislosti od typu nástroja:
Iba serverové nástroje
Request → [model → web_search → result → model] → Final response
Všetko sa deje na strane xAI. Priamo dostaneš konečnú odpoveď so začlenenými výsledkami.
Iba klientské nástroje
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Model sa pozastaví, tvoj kód sa vykoná a následne odošleš výsledok späť.
Hybridný tok
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Model najprv využije serverové nástroje (automaticky) a tvoju funkciu zavolá až vtedy, keď potrebuje tvoju infraštruktúru.
Bežné vzorce kombinácií
Vyhľadávanie + Akcia
Skombinuj web_search alebo x_search s funkciou vykonávajúcou akciu:
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 + Upozornenie
Skombinuj code_interpreter s funkciou na odoslanie upozornenia:
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
Správanie parametra max_turns je v hybridnom kontexte dôležité:
max_turnsobmedzuje počet krokov na strane servera v rámci jednej požiadavky- Keď model zavolá klientsku funkciu a tvoj kód vráti výsledok, začína sa nová alokácia
max_turns
V praxi to znamená, že volania klienta nevyčerpávajú tvoj rozpočet serverových krokov. Model môže vykonať 3 vyhľadávania na webe, zavolať tvoju funkciu a po získaní výsledku vykonať ďalšie 3 vyhľadávania.
Kontext viacerých kôl s ukladaním
Pre zložité pracovné postupy, ktoré sa rozkladajú do viacerých interakcií, skombinuj ukladanie a reťazenie:
# 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
)
Kľúčové poznatky
- Kombinuj serverové nástroje a klientské funkcie v jednej požiadavke pre hybridné pracovné postupy
- Serverové nástroje sa vykonávajú automaticky; klientské funkcie pozastavia generovanie
max_turnssa resetuje po každej odozve od klienta- Bežné vzorce: vyhľadávanie + akcia, výpočet + upozornenie, agregácia z viacerých zdrojov
- Pre pracovné postupy s viacerými kolami používaj
store: trueaprevious_response_id