Kombiniranje poslužiteljskih i klijentskih alata
Na ovoj stranici
Hibridni radni tijekovi
Prava snaga API-ja za odgovore (Responses API) dolazi do izražaja kada u jednom zahtjevu kombiniraš poslužiteljske alate (koje automatski izvršava xAI) i klijentske alate (tvoje prilagođene funkcije). Model samostalno upravlja tim alatima, stvarajući složene radne tijekove uz samo nekoliko redaka koda.
Kombiniranje poslužiteljskih alata i funkcija
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"]
}
}
]
)
U ovom scenariju model:
- Automatski pokreće
web_search(na strani poslužitelja) kako bi pronašao rezultate - Uključuje podatke u sažetak
- Poziva
send_team_message(na strani klijenta) kako bi tvoj kod poslao poruku na Slack
Hibridni tijek izvršavanja
Tijek se razlikuje ovisno o vrsti alata:
Samo poslužiteljski alati
Request → [model → web_search → result → model] → Final response
Sve se događa na strani xAI-a. Izravno primaš konačni odgovor s integriranim rezultatima.
Samo klijentski alati
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Model se pauzira, tvoj kod izvršava funkciju, a zatim šalješ rezultat natrag.
Hibridni tijek
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Model prvo koristi poslužiteljske alate (automatski), a zatim poziva tvoju funkciju kada mu je potrebna tvoja infrastruktura.
Uobičajeni obrasci kombiniranja
Pretraživanje + Radnja
Kombiniraj web_search ili x_search s funkcijom za radnju:
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"]
}
}
]
Izračun + Obavijest
Kombiniraj code_interpreter s funkcijom za obavijest:
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 i hibridni alati
Ponašanje parametra max_turns ključno je u hibridnom kontekstu:
max_turnsograničava poslužiteljske okrete unutar jednog zahtjeva- Kada model pozove klijentsku funkciju, a tvoj kod vrati rezultat, započinje nova raspodjela vrijednosti
max_turns
U praksi to znači da klijentski pozivi ne troše tvoj budžet poslužiteljskih okreta. Model može izvršiti 3 web pretraživanja, pozvati tvoju funkciju, a zatim izvršiti još 3 pretraživanja nakon primitka rezultata.
Kontekst s više okreta uz pohranu
Za složene radne tijekove koji se protežu kroz više interakcija, kombiniraj pohranu i lančanje:
# 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
)
Ključne točke
- Kombiniraj poslužiteljske alate i klijentske funkcije u jednom zahtjevu za hibridne radne tijekove
- Poslužiteljski alati izvršavaju se automatski; klijentske funkcije pauziraju generiranje
max_turnsse resetira nakon svakog povratnog poziva klijentu- Uobičajeni obrasci: pretraživanje + radnja, izračun + obavijest, agregacija iz više izvora
- Koristi
store: trueiprevious_response_idza radne tijekove s više okreta