Apvienojot servera un klienta rīkus
Šajā lapā
Hibrīda darbplūsmas
Responses API patiesā jauda atklājas, kad vienā pieprasījumā apvieno servera rīkus (kurus automātiski izpilda xAI) un klienta rīkus (tavas pielāgotās funkcijas). Modelis autonomi orķestrē šos rīkus, radot sarežģītas darbplūsmas tikai dažās koda rindās.
Servera rīku un funkciju apvienošana
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"]
}
}
]
)
Šajā scenārijā modelis:
- Automātiski iedarbina
web_search(servera pusē), lai atrastu rezultātus - Iekļauj datus kopsavilkumā
- Izsauc
send_team_message(klienta pusē), lai tavs kods nosūtītu ziņojumu vietnē Slack
Hibrīda izpildes plūsma
Plūsma atšķiras atkarībā no rīka veida:
Tikai servera rīki
Request → [model → web_search → result → model] → Final response
Viss notiek xAI pusē. Tu saņem galīgo atbildi tieši ar integrētiem rezultātiem.
Tikai klienta rīki
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Modelis apstājas, tavs kods izpilda funkciju, pēc tam tu nosūti rezultātu atpakaļ.
Hibrīda plūsma
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Modelis vispirms izmanto servera rīkus (automātiski), pēc tam izsauc tavu funkciju, kad tam nepieciešama tava infrastruktūra.
Bieži sastopami kombinēšanas paraugi
Meklēšana + darbība
Apvieno web_search vai x_search ar darbības funkciju:
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"]
}
}
]
Aprēķins + paziņojums
Apvieno code_interpreter ar paziņojuma funkciju:
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 un hibrīda rīki
max_turns uzvedība ir svarīga hibrīda kontekstā:
max_turnsierobežo servera puses gājienus viena pieprasījuma ietvaros- Kad modelis izsauc klienta funkciju un tavs kods atgriež rezultātu, sākas jauns
max_turnssadalījums
Praksē tas nozīmē, ka klienta izsaukumi neiztērē tavu servera gājienu budžetu. Modelis var veikt 3 meklēšanas tīmeklī, izsaukt tavu funkciju un pēc rezultāta saņemšanas veikt vēl 3 papildu meklēšanas.
Daudzgājienu konteksts ar krātuvi
Sarežģītām darbplūsmām, kas aptver vairākas mijiedarbības, apvieno krātuvi un ķēdēšanu:
# 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
)
Galvenās atziņas
- Apvieno servera rīkus un klienta funkcijas vienā pieprasījumā hibrīda darbplūsmām
- Servera rīki izpildās automātiski; klienta funkcijas aptur ģenerēšanu
max_turnstiek atiestatīts pēc katra klienta aprites cikla- Bieži paraugi: meklēšana + darbība, aprēķins + paziņojums, vairāku avotu apkopošana
- Izmanto
store: trueunprevious_response_iddaudzgājienu darbplūsmām